How can we help?

Mobile app channel setup


The Mobile App 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 App channel for your account. The time to onboard will vary based on the complexity of your app, developer resources, and use cases.

Create Mobile App channels

1. To create a Mobile App channel in your account, first provide your CSM with a name for the channel.

2. Once your channel is created, select Account Transports from the dropdown at the top of your Cordial navigation bar.

3.Select the Transport Name of the channel.

4. Select the Edit button to the right of your iOS or Android Sending Credentials and put in the following information:

  • Pieces needed for iOS sending:
    • Key ID
    • Team ID
    • Bundle ID
    • Private Key (.p8 file)
  • Pieces needed for Android sending: 
    • FCM Server Key

5. Find your Channel Key by clicking Account Settings from the dropdown at the top of your Cordial navigation bar.

You need to provide your app development team with your Channel Key in order to complete the next step.

Integrate the Cordial Mobile SDK

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

Test 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. Log in a contact.
  2. Verify that standard events are showing up inside Cordial, such as crdl_app_open.
  3. Verify that custom events are showing up inside Cordial.
  4. Send a push notification and tapping on it.
  5. Update a contact's cart items.
  6. Place an order.

Import existing device tokens (optional)

If you are migrating from another mobile app 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 messages right away instead of waiting for users to update their application. Detailed instructions for importing can be viewed here.

Devices that have been imported will not be have the Cordial Mobile SDK installed. This will prevent these devices from being able to report events, cart items, orders, etc to Cordial. You can expect message performance KPIs to fall until most of your app users have updated their application to a version that contains the Cordial SDK.

Release 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.




Please sign in to leave a comment.