Campaigns migration
Once your app has been released with Batch SDK, you will be able to migrate your push campaigns to Batch. The migration steps vary depending on the migration type you choose:
If you chose the Hot Swap method, you need to migrate your campaigns as soon as possible since the new opt-in users are only reachable via Batch.
For a Staged Migration, all users will still be reachable from both your previous provider and Batch, so you can migrate the campaigns gradually over days/weeks.
Campaigns creation
For both migration types, you need to create in parallel:
A campaign targeting the imported tokens, with the previous provider's payload
A campaign targeting the rest of the userbase, without the previous provider's payload
Targeting imported users
After we’ve completed your tokens import, a new filter will be available:
Imported tokens only, which are the manually imported tokens, not yet detected by our SDKs
Collected tokens only, which are the tokens already collected through the Batch SDK

Refer to the Targeting section to know more about this segmentation feature.
There are a few things you need to keep in mind before targeting your newly imported users:
The Imported tokens only filter is not targeted by default when you create a new campaign. Don't forget to select it the next time you want to send a notification.
The first time you send a notification to your imported users, Batch will clean the inactive or invalid tokens that may come from your previous push provider. Depending on how many invalid tokens we find, the number of imported tokens will decrease a few days after the import.
If you select the Imported tokens only filter, you must include the previous provider's payload in your campaign to contact your users correctly (more details here).
Campaigns statistics
The campaign statistics are provided by the Batch SDK. This is why you may notice that the campaign statistics are not available for campaigns that target users who don’t have Batch SDK.
Imported tokens and APIs
The imported tokens can be targeted via the Campaign API (via "Filter push tokens" or through Audiences if you have imported the Custom User ID with the push tokens).
Your API-scheduled notifications can be migrated in the same way as described above.
You can find more details in our Data lifecycle documentation.
Anytime you target the imported tokens (even when using the API), don't forget to include the previous provider's payload.
Last updated
Was this helpful?