Mobile Push Channel Setup

Overview

The Mobile Push channel not only allows you to send mobile app messages to contacts as batch or automated messages, but also allows you to collect data using Cordial's native mobile app solution.

Please contact your CSM for details about enabling the Mobile Push channel for your account. The time to onboard will vary based on the complexity of your app, developer resources, and use cases.

At a high level, the following steps will happen:

1. Creating your Mobile Push channel
2. Integrating the Cordial Mobile SDK
3. Testing the Cordial Mobile SDK
4. (Optional) Importing of existing device tokens
5. Releasing your app

Creating Your Mobile Push Channel(s)

In order to create a Mobile Push channel in your account, you will need to provide your CSM a name for your channel and your app development team will need to provide a few extra pieces of information to your CSM. Cordial fully supports having multiple Mobile Push channels in a single account if needed.

Pieces needed for iOS sending:

• The Key ID
• The Team ID
• The Bundle ID
• The Private Key (.p8 file)

Pieces needed for Android sending:

• The FCM Server Key

Once the required pieces of information are provided, your CSM will get your Mobile Push channel created and will inform you of the channel key value which will be needed by your app development team in the next step.

Integrating the Cordial Mobile SDK

Now that you have your Mobile Push channel created, your app development team can integrate the Cordial Mobile SDK by following the instructions on the Gitlab page.

Testing the Cordial Mobile SDK

Once your app development team has successfully integrated the Cordial SDK, you will want to test a few use cases to make sure your app is working as expected.

Example Scenarios:

1. Logging in a contact
2. Verifying that standard events are showing up inside Cordial, such as crdl_app_open
3. Verifying that custom events are showing up inside Cordial
4. Sending a push notification and tapping on it
5. Updating a contact's cart items
6. Placing an order

(Optional) Importing of Existing Device Tokens

If you are migrating from another mobile push solution, you likely already have a group of app users. Cordial allows you to import those existing device tokens so that you can send those users notifications right away instead of waiting for users to update their application. Detailed instructions for importing can be viewed here.

Releasing Your App

Once you have confidence that your use cases are working correctly, you can now release your app to the Google Play Store and iOS App Store. Talk with your app development team about options for releasing such as doing a gradual rollout. If you imported any devices, these will get updated automatically as app users update to the new version of your app.