On this page

Batch

Batch is a customer engagement platform that lets publishers personalize push notifications and emails across mobile platforms and web browsers. Batch offers a SaaS solution that integrates with apps and websites through an SDK. This integration syncs cohorts from Amplitude to Batch.

Considerations

  • This integration is available for customers on paid Amplitude plans.
  • Enable this integration in each Amplitude project where you want to use it.
  • This integration requires a paid Batch plan.
  • The integration requires both custom audiences and third-party connections in Batch.
  • Batch expects an identifier that matches the Batch Custom User ID or the Installation ID field. The user_id or user property you select in Amplitude must contain the same identifier as the one tracked in Batch in one of these fields.

Set up the integration

Batch supports two types of cohort destinations:

  • Use the Batch (Profile) destination to sync cohorts with your Batch Omnichannel project.
  • Use the Batch destination to sync cohorts with a specific mobile app or website.

Batch setup

  1. In Batch, navigate to Settings > General.
  2. Copy the API key (Live API Key for mobile or SDK API Key for web) of the application where you want to use Amplitude cohorts, or the Project key of the omnichannel project where you want to use Amplitude cohorts.
  3. Copy your account's REST API key.

Amplitude setup

  1. In Amplitude Data, click Catalog and select the Destinations tab.
  2. In the Cohort section, click Batch or Batch (Profile).
  3. Click Add another destination.
  4. Enter a Name and paste in the API key you copied from Batch.
  5. If you don't use the Batch (Profile) destination, select the type of identifier composing your segment on Batch (Custom User ID or Installation ID).
  6. Map the Amplitude user_id field to the Batch user_id field.
  7. Save when finished.

Send a cohort

To sync your first cohort:

  1. In Amplitude, open the cohort you want to sync, then click Sync.
  2. Select Batch, then click Next.
  3. Choose the account you want to sync to.
  4. Choose the sync cadence.
  5. When finished, save your work.

Locate your cohort in Batch

After Amplitude syncs the cohort to Batch, it appears in the Audiences tab of the dashboard. Select it in the targeting section of the campaign editor to use it in a Push, In-App, Email, or SMS campaign. This helps you include or exclude a segment of users from your campaign.

Was this helpful?