--- schema_version: "1" id: 8ff0228bdef3a389d76e2d401c3ceddfa6a5c86fedd39794a28c6f8e536512d9 title: Set Up Mobile App Messaging in Marketing Cloud Next collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/mktg_admin_setup_mobile_app.md canonical_url: https://help.salesforce.com/s/articleView?id=mktg.mktg_admin_setup_mobile_app.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 3cf6cdb6ae7dbb4cca5e731614ef70c7481c07b46d06192e853cdfeb68b671f8 description: 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. products: - Marketing release: "264" --- # 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. [View supported editions](https://help.salesforce.com/s/articleView?id=mktg.mktg_editions.htm&release=264.0.0&type=5 "Marketing Cloud Next is available in Growth and Advanced editions, and requires Salesforce Enterprise or Unlimited editions. Some features are limited by edition or purchased add-on. All functionality is available in Lightning Experience only."). 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 1. In Setup, go to **Unified Messaging** | **Mobile App** | **Your Applications**. 2. Click **Add Application**. 3. On the Add Application window, click **Next**. 4. For **Application Name**, enter a name. 5. 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). 1. On the Sending Services tab, expand the iOS section. 2. For Environment Type, choose whether to use a **Production** or **Sandbox** environment. 3. For Key Type, choose whether to use an **APNS p8 Auth Key** or an **APNS p12 Auth Key**. 4. Click Upload Files, and then upload your APNs certificate file. 5. For Key ID, enter your key ID. For more information about finding your key ID, see _Apple Developer_: [Get a key identifier](https://developer.apple.com/help/account/keys/get-a-key-identifier). 6. For Team ID, enter your team ID. To find your Team ID, sign in to your Apple Developer account and click **Membership details**. 7. 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. 8. 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). 1. On the Sending Services tab, expand the Android section. 2. Click **Upload Files**, and then upload your Firebase Developer certificate. 3. 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. 1. On the Categories tab, for iOS Carousel Category Name, enter a unique name. 2. 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. 1. On the Your Apps page in Setup, from the list of apps, select an app to test. 2. 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. 3. 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. 4. 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. 1. On the Your Apps page in Setup, from the list of apps, select an app. 2. Enable flash sending. ## Create Custom Attributes Custom attributes are data fields defined for a specific mobile app. Use them to store app-specific data and define audiences for flash sending. Once activated, you can’t edit or delete them. 1. On the Your Apps page in Setup, from the list of apps, select an app. 2. On the **Custom Attributes** tab, click **New Attribute** 3. Enter a field label to show on displays, page layouts, reports, and list views. 4. Specify a field API name that's unique across all mobile apps. 5. Enter a length for the associated data type. All custom attributes use the Text data type. 6. To save the attribute without activating it, click **Save.** To make the attribute available, click **Activate.** Activation can take a few minutes, and you can activate only one attribute at a time. To check the status, click the refresh icon. ## Define Audiences for Flash Sending Send flash messages to specific mobile devices using audiences based on custom attributes. Create your attributes first, then enable flash sending to publish an audience. You can’t edit published audiences, but you can deactivate or delete them. 1. On the Your Apps page in Setup, from the list of apps, select an app. 2. On the Flash Sending tab, in the Audiences section, click **New Audience.** 3. Enter a unique audience name. 4. Select a custom attribute. 5. Specify the value that a device's custom attribute matches to be included in the audience. 6. To save the audience without publishing it, click **Save as Draft.** To publish the audience so that marketers can use it, click **Save & Publish.** Marketers can select a published audience in a flow when they configure a flash message. ## 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. 1. On the Your Apps page in Setup, from the list of apps, select an app. 2. On the In-App Messaging tab, enable the display limit. 3. Enter the maximum number of messages to show in a session. 4. Enter the minimum time between messages and its time unit. 5. Save your changes.