Send emails with Batch


Batch makes it easy to send emails based on user behavior on every platform. Here is an overview of the implementation steps:

  • Create a Project
  • Collect email addresses
  • Collect data
  • Manage profiles privacy

Profile explainer

Create a Project

Reach out to your Customer Success Manager to create a Project.

With Projects, you can group all your different platforms, such as your website, iOS app, and Android app, into a single entity. This makes it easier for you to manage data across all your platforms.

In the past, data was siloed between different platforms. However, Projects remove this limitation by introducing Profiles. Profiles centralize user data and events from multiple sources, such as Apps, Websites, and APIs, in a single place based on a custom user ID.

Each Project is associated with a unified user base made up of Profiles. When a user interacts with any of the platforms within a Project, their actions are fed into the associated Profiles. For example, this allows you to trigger automated emails based on user behavior, regardless of which platform the user used.

Profiles can also store recipients as a user's email address and email subscriptions, making it easy for you to send targeted and relevant communications to your customers.

Overall, using Projects and Profiles helps you to provide a more cohesive experience for your customers by managing data across multiple platforms in a single place.

Collect email addresses

Batch supports importing your known email subscribers in three ways:

Send data on Profiles

You can send attributes and events to enrich Profiles and allow better targeting and orchestration for your communications.

Profiles are compatible with "mobile only" implementations which are based on apps API keys and not Project API keys. You don't need to overhaul your Batch implementation to start sending emails with Batch if you were already sending user data to Batch.

Compatibility flows will be activated for your account by your technical contact.

Server side data

Custom Data API

Use the Custom Data API to send Profiles attributes & tag collection. You can find its documentation in the API section.

If you use the overwrite:true option in the Custom Data API, the API call will not update the Profile data. However, it will still update you user's data at an app level.

Trigger Events API

Use the Trigger Events API to track events for Profiles and trigger automations based on these events.

You can find its documentation in the API section.

Client side data

Setting Profile attributes from the SDK

Setting attributes from SDK methods is not yet supported (coming later this year).

Tracking events from the SDK

You can track events on from our SDKs on all platforms at a Profile level:

All these events have the capability to trigger an email automation. They can't be used as a targeting option yet.

Privacy & Profiles

Review & delete Profiles

Profiles are compatible with the GDPR API, as well as all privacy requests made from the dashboard. To respond to privacy requests (data export and data deletion), Batch finds the Profile that matches the identifier in the privacy request and follows standard identity resolution process.

It means that when a data request is made with an Installation ID, Batch will not be able to find a Profile that holds this Installation as well as a custom user ID. To read or delete a logged in Profile (with a custom user ID), it is necessary to provide its custom user ID in the privacy request.

Inactive profiles - coming later this year

Profiles that have not been active for a certain period of time are classified as inactive and deleted. To be classified as inactive, a profile must meet the following conditions:

  • The profile has not started the mobile app.
  • The profile has not visited the website.
  • The profile has not opened any emails.
  • The profile has not triggered any server-side events (Trigger Events API).
  • Batch has not processed any server-side attributes on this profile (Custom Data API, Email Subscription API).

By default, the period of inactivity is set to 13 months. You can reach out to your Customer Success Manager to shorten this period.