Amplitude

Learn how to set up Amplitude as a destination for audience exports using a user property on the Amplitude Identify API.

Use Amplitude as a GrowthLoop destination to export Audiences as membership on an Amplitude user property. GrowthLoop appends and removes audience names on an array-type user property (default gl_audiences) using Amplitude's Identify API, matched to Amplitude users by user_id.

Prerequisites

Before you connect Amplitude to GrowthLoop, make sure you have:

  • An Amplitude project with an API key and secret key (Settings > Projects in Amplitude).
  • Confirmation that the GrowthLoop match field you plan to use (typically a CRM ID or similar) corresponds to the user_id your Amplitude project uses to identify users. GrowthLoop does not resolve email addresses or device IDs to Amplitude users in this version — only user_id is supported.
📘

Note

Amplitude creates the gl_audiences user property automatically on first write — there is no need to pre-create it in Amplitude.

Set up destination

  1. In GrowthLoop, navigate to Destinations in the left sidebar.
  2. Click New Destination in the upper right corner.
  3. In the Select Destination window, search for Amplitude.
  4. Click Add Amplitude.
  5. Enter the following destination details:
    1. Destination Name: Enter a clear name your team will recognize in GrowthLoop.
    2. Sync Frequency: Choose how often GrowthLoop should export audiences by default. You can adjust the schedule when you configure an export.
    3. API Key: Enter your Amplitude project's API key.
    4. Secret Key: Enter your Amplitude project's secret key. GrowthLoop uses this only for a read-only credential check, never to write data.
    5. Region: Enter us or eu depending on your Amplitude project's data residency. Defaults to us.
    6. Audience Property: Optional. Defaults to gl_audiences. The Amplitude user property GrowthLoop uses to track audience membership.
  6. Click Create. GrowthLoop validates the connection with a read-only call to the Amplitude Export API.

Export to destination

After you create the destination, you can export an Audience to Amplitude.

  1. Navigate to Audiences in the left sidebar.
  2. Open an existing Audience or create a new Audience.
  3. Click Export Audience.
  4. In the Create Export flow, select your Amplitude destination.
  5. Configure the export schedule and settings.
  6. In Match Fields, map your source identifier to User ID — this must match the user_id Amplitude uses to identify the same person.
  7. Click Export.

GrowthLoop sends an Identify API call per contact. Contacts added to the Audience have the audience name appended to the gl_audiences user property. Contacts removed from the Audience have the audience name removed from that property — other audience memberships on the same user are left untouched.

Configuration options

OptionDescription
API KeyAmplitude project API key.
Secret KeyAmplitude project secret key.
RegionAmplitude data residency: us or eu. Defaults to us.
Audience PropertyArray-type Amplitude user property used to store audience membership. Created automatically. Defaults to gl_audiences.
Match fieldsUser ID only. Must match the user_id your Amplitude project uses to identify the same person.

Find exported audience membership in Amplitude

After a successful export, open User Look-Up in the Amplitude dashboard and search for the user_id you exported. Confirm the audience name appears in the gl_audiences user property.

To confirm the export ran successfully in GrowthLoop, open the Audience Exports tab and review the export activity tracker.

Congrats on successfully connecting Amplitude as a destination!

📘

Note

Experiencing any issues connecting to Amplitude? Reach out to us at [email protected] and we'll help resolve the matter.


Did this page help you?