1. Account creation

You can create an account now on https://batch.com/register.

We recommend you to invite your team members from the account manager section, in the bottom left corner of your dashboard, in "My team" → "Add member".

2. SDK Integration

Once your account is created, add your first apps to the dashboard and follow the instructions described in the documentation: iOS / Android / Cordova.

  • SDK integration
  • Push setup
  • In-App messaging setup

There are two extra steps we recommend you to take after a basic integration:

3. Custom Data Collection

In addition to the data the SDK collects natively in your app, you can collect custom data to improve your user segmentation.

Custom User ID

Batch can collect a unique user ID (iOS / Android / Cordova) that will be attached to your user installation. This is a recommended step if your app has a login wall or if users can create an account inside your app.

You can use that Custom user ID with:

  • The Transactional API, to send 1-to-1 push notifications to one or several user IDs (e.g. package delivery notification, etc) ;
  • The Custom Data API, to send custom data (attributes or tags) to Batch on a user ID server-side.

User ID collection also allows your teams to:

  • Target logged in / logged out users (see has custom user ID)
  • Upload static segments exported from your userbase (e.g. top 500 buyers, etc) or created by third-party tools (see custom audiences)

Custom Language/Region

Batch automatically detects the language and the country of your users’ device. If users can select a region or a language from your app settings, we recommend you overwrite the values automatically detected by Batch: iOS / Android / Cordova.

Tracking Transactions

Batch allows you to track In-App transactions (e.g. purchase, etc) without any currency attached. This is useful if you have an mcommerce app and want to see the revenue generated every day in the app. You will also be able to target users who haven't made any transactions in the app (see transaction tracked).

You will find more information on how to track transactions here: iOS / Android / Cordova

Tracking User Location

You can also natively track a user location in order to send geotargeted push notifications or trigger In-App messages in a specific area using the last location attribute. You will find more information on how to track location here: iOS / Android.

Tagging Plan

In addition to the data collected natively by the SDK (e.g. last visit date, city, etc), you can collect additional information on your users:

  • User data: Attributes (e.g.: is_premium = true) or tags (e.g. : favorite_sports = ["football", "rugby", "tennis"]).
  • Actions: Events, triggered when users perform a specific action in your app (e.g.: read article, item added to cart, etc). For every action, you can collect a contextual information called "label" (e.g. : category of the read article, brand of the item added to the cart, etc).

That information can come from:

  • the SDK integrated in your app,
  • or your servers, through the Custom Data API. This is useful if the information you need to track is not available in the app or if it can change when users don't open the app (e.g. when they purchase an item on your website, etc).

The tagging plan is the list of all the attributes, tags and events collected by the SDK or sent to Batch through the Custom Data API. You can use that data to segment your userbase, trigger In-App messages or automatically replace values in your messages (e.g. {{c.firstname}} check out our new offer). We strongly advise you against using a tagging plan coming from an analytics tool or another CRM since it may not work correctly with Batch.

On the Enterprise plan or as an option, our team can help you build your first tagging plan in 3 steps:

  1. Brainstorming: Feel free to send us all the information that will help us build a first tagging plan. This includes: existing tagging plans from other tools, campaign ideas or credentials if the app requires a specific account creation. 
  2. Proposal: Our team will send you a first version of the tagging plan we will discuss together and modify based on your feedback.
  3. Approval and integration: Finally, you will need to send the tagging plan to your developers or your agency for integration.

🚧 Important note: We recommend against reusing an existing tagging plan created for another tool. You should only collect data you will need to segment your userbase, personalise your messages or trigger In-App messages.

4. Test and Release

Once the SDK and tagging plan are integrated, we recommend you test your integration. See our guides on what should check before going live: iOS / Android.

On the Enterprise plan or as an option, we can help you test the integration. Send test builds to our team for iOS and Android and create a test In-App Campaign. We will run a full test of the integration to make sure everything is working as expected.

5. Token Migration

On paid plans, Batch can import existing tokens in case you migrate from another push provider. Once the app is live with Batch’s SDK, you can send us an export in the format described in the documentation. Batch will automatically delete the invalid tokens. 

A new "Imported" segment will be available for targeting and imported users will be progressively analysed and transferred to other Smart Segments after their first session.

6. APIs Setup

With Batch RESTful APIs you can easily send custom data and push notifications to take advantage of Batch’s advanced features from your own systems. There are basically three APIs you can use in your app to cover all your marketing needs:

  • The Custom Data API to send custom data on specific custom user IDs and improve your campaign targetings.
  • The Transactional API allows you to send notifications to a specific token or custom user ID based on events in your back-end (e.g. "You have a new friend request").
  • The Campaigns API allows you to send push notifications in mass to your segments (attributes, events) or to segments generated by Batch (country/language, dormant users, app version, etc).

Depending on the use cases you plan to set up, we can help you through the use of these APIs.

Need Assistance?

Our technical team is reachable via the “live chat” in the bottom right corner of every page of the dashboard (median response time lower than 3 minutes from 9 am to 7 pm on working days).

Did this answer your question?