Moloco

Learn how to connect and send audiences to Moloco

In this article, we'll guide you through connecting Moloco to GrowthLoop and exporting your audiences to the destination.

Moloco is a machine learning company that helps mobile apps grow through performance advertising. This integration allows you to sync your GrowthLoop audiences directly to Moloco via Google Cloud Pub/Sub for targeted advertising campaigns.

Prerequisites

To integrate with Moloco, you must prepare a Google Cloud Service Account and a Pub/Sub topic. Please coordinate with your Moloco representative for the specific setup details.

  • Service Account & Authentication: You need a Service Account with the necessary permissions to publish messages to the Pub/Sub topic. You have two options:
    • Use your own Service Account: Create a Service Account in your GCP project and share it with Moloco to enable the privilege to publish Pub/Sub messages.
    • Request from Moloco: Moloco can create a Service Account and share the JSON key file with you separately.
  • Pub/Sub Topic:
    • The Pub/Sub topic should be dedicated to each Platform.
    • Please discuss with Moloco to prepare the specific Pub/Sub topic for this integration.
  • JSON Key: Ensure you have the JSON key file for the Service Account (either created by you or provided by Moloco). This key will be used to authenticate GrowthLoop.
๐Ÿ“˜

Note

For more details on setting up authentication for Google Cloud APIs, refer to the Google Cloud Authentication Guide.

Set up destination

  1. Log into GrowthLoop and click the Destinations tab on the left sidebar.
  2. Click New Destinations on the upper right side.
  3. Search for Moloco in the destination modal and click Add Moloco.
  4. Enter the required information in the modal, then click Create.
    1. Destination Name: This is how the destination will be named and referred to in the app going forward.
    2. Sync Frequency: The default frequency audiences will be synced to the destination.
    3. Credentials: Paste the entire content of your GCP Service Account JSON key file here.
    4. Topic: Enter the name of the Pub/Sub topic you created. You can enter just the topic name (e.g., moloco-audiences) or the fully qualified path (e.g., projects/my-project/topics/moloco-audiences).

Export to destination

  1. Navigate to your list of audiences by clicking the Audiences tab on the left sidebar.
  2. Choose an existing audience or create a new one.
๐Ÿ“˜

Note

Need help creating an audience? Click here to learn how!

  1. Once created, click the Export button on the upper right side.
  2. Search for Moloco in the export modal and then click Select.
  3. Under Configure Match Field Settings, select the appropriate fields from your primary dataset to match customer identities.
    • User ID: Map your internal user identifier to the user_id field.
    • Persistent ID: Map your persistent device identifier (like IDFA or GAID) to the persistent_id field.
๐Ÿ“˜

Note

You must map at least one of User ID or Persistent ID to export data to Moloco.

  1. Now, set up your export settings:
    1. Export Name: Automatically populated with your audience name.
    2. Campaign Type: Choose between One Time to export the audience once or Ongoing to continuously export new audience members as they qualify.
    3. Export Inclusion Criteria: Choose between All audience members to export the full audience or Newly added audience members to export only those who have been added since the last export.
    4. Export Schedule: Configure the frequency and timing of your exports.
  2. Finally, click Export to send your audience to the destination!

Find your audience

GrowthLoop publishes audience membership changes (adds and removes) as messages to your configured Google Cloud Pub/Sub topic.

To verify the data:

  1. Go to your Moloco dashboard
  2. Or contact your rep in Moloco
๐Ÿ‘

Success

You've successfully created an export to Moloco!

๐Ÿ“˜

Note

Experiencing any issues when connecting to Moloco? Reach out to us at [email protected] and weโ€™ll be in-touch shortly to help resolve the matter!