Prerequisites

Before you integrate the Mobile App Messaging SDK with your app, complete these steps.

Before you configure Marketing Cloud Next to send push notifications, set up the push notification services and download the required authentication files.

If you plan to send push notifications to iOS devices, log in to your Apple Developer account and download your authentication key. See Apple Developer Documentation: Set up push notifications.

Use the resulting .p8 file to configure the iOS settings in Marketing Cloud Next.

If you plan to send push notifications to Android devices, configure Google Firebase for your app. See Firebase Documentation: Add Firebase to your Android project.

As part of this configuration process, you download a Firebase configuration file. You use this file to configure the Android settings in Marketing Cloud Next.

To send messages to users of your app, enable Mobile App Messaging in Marketing Cloud Next.

  1. In Setup, select Unified Messaging > Mobile App > Your Apps.
  2. Next to Setup Mobile App Data with One Click, click Install.
  3. Next to Enable Custom Attributes for Device Registrations, click Enable.

Provide information about your app to Marketing Cloud Next, and then set up the notification services that you plan to use.

  1. In Setup, select Unified Messaging > Mobile App > Your Apps.
  2. Click Add Application.
  3. On the Add Application window, complete these steps:
    1. Click Next.
    2. For Application Name, enter a name.
    3. Click Save.

After you create an app, configure at least one sending service.

If your app 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, specify whether to use a Production or Sandbox environment.

  3. For Key Type, specify whether to use an APNS p8 Auth Key or an APNS p12 Auth Key.

    Apple recommends that you use a .p8 authentication key rather than a .p12 authentication certificate.

  4. Click Upload Files, and then upload your APNs authentication key.

  5. For Key ID, enter your key ID.

    For more information about finding your key ID, see Apple Developer: Get a key identifier.

  6. For Team ID, enter your team ID.

    To find your Team ID, log in to your Apple Developer account and select 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. Click Save.

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 configuration file.
  3. Click Save.

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. If you don’t plan to use carousel messages, skip this step.

  1. On the Categories tab, for iOS Carousel Category Name, enter a unique name.
  2. Click Save.