You are here:
Set Up Mobile App Messaging in Marketing Cloud Next
In Marketing Cloud Next, you can use segments and Flow Builder to send timely, personalized notifications to users of your apps. To start sending mobile app messages, add and configure your app in Setup.
Required Editions
| Available in: Salesforce Enterprise and Unlimited Editions with Marketing Cloud Next Advanced Edition and the Salesforce Message Credits - Mobile App Regional add-on |
The Your Apps page in Setup shows the apps that are associated with your account. This table describes the information shown for each app.
| Label | Description |
|---|---|
| Application Name | The name associated with the app. |
| Sending Services | The mobile app notification services that are configured for the app. Possible values are iOS and Android. |
| Status | Indicates whether the app is active. An app becomes active when at least one sending service is configured. You can only send messages through an active app. |
| Active Users | The number of active users of the app who have opted in to receive messages. |
| Created | The date when the app was added to your account. |
| Created By | The name of the user who added the app to your account. |
| Last Modified | The date when the app was last modified. |
Add Your App
- In Setup, go to Unified Messaging | Mobile App | Your Applications.
- Click Add Application.
- On the Add Application window, click Next.
- For Application Name, enter a name.
- Click Next.
After you create the app, configure at least one sending service.
Configure iOS Settings
If your application has a version that runs on Apple iOS, configure the settings for Apple Push Notification service (APNs).
- On the Sending Services tab, expand the iOS section.
- For Environment Type, choose whether to use a Production or Sandbox environment.
- For Key Type, choose whether to use an APNS p8 Auth Key or an APNS p12 Auth Key.
- Click Upload Files, and then upload your APNs certificate file.
-
For Key ID, enter your key ID.
For more information about finding your key ID, see Apple Developer: Get a key identifier.
-
For Team ID, enter your team ID.
To find your Team ID, sign in to your Apple Developer account and click Membership details.
- For Bundle ID, enter the bundle ID associated with your app. The bundle ID is an alphanumeric string that uses reverse DNS notation, such as com.northerntrailoutfitters.app.
- Save your changes.
Configure Android Settings
If your application has a version that runs on Android devices, configure the settings for Firebase Cloud Messaging (FCM).
- On the Sending Services tab, expand the Android section.
- Click Upload Files, and then upload your Firebase Developer certificate.
- Save your changes.
(Optional) Configure Category Names for iOS Carousels
If you plan to use create carousel messages for iOS devices, specify a category name. Specifying your category names helps ensure that your messages render correctly. When you create a carousel message template, you provide the category name.
- On the Categories tab, for iOS Carousel Category Name, enter a unique name.
- Save your changes.
Test Your App’s Configuration
After you create an app in Setup and add the Engagement SDK to your app, perform a test to make sure that the app is properly configured.
- On the Your Apps page in Setup, from the list of apps, select an app to test.
-
On the Test tab, for Select Identifier, select the type of
identifier to use to send a test message. Choose from these options:
- System Token: Send a message to a recipient based on their unique, device-generated token.
- Device ID: Send a message to a specific device based on its unique device ID.
- Individual ID: Send a message to a subscriber based on their Unified Individual ID in Marketing Cloud Next.
-
Specify the unique ID for the type of identifier you selected.
- If you selected System Token, select the operating system of the target device, and then enter the token in the System Token field.
- If you selected Device ID, enter the target device ID in the Device ID field.
- If you selected Individual ID, enter the target device ID in the Individual ID field.
- Click Test Configuration.
The Results section on the right side of the page indicates whether the test was successful. If the test fails, verify that you provided the correct credentials for the push notification services.
Turn On Flash Sending
Turn on flash sending to send notifications to your users' screens for their immediate attention. Flash sending functions at scale with minimum delay.
- On the Your Apps page in Setup, from the list of apps, select an app.
- Enable flash sending.
Configure In-App Message Display Limit
Restrict the number of in-app messages to show across campaigns and flows in a session. This restriction ensures a positive user experience and maximizes the effectiveness of each message.
- On the Your Apps page in Setup, from the list of apps, select an app.
- On the In-App Messaging tab, enable the display limit.
- Enter the maximum number of messages to show in a session.
- Enter the minimum time between messages and its time unit.
- Save your changes.
