Documentation Campaign Campaign v8 Documentation

Limited Availability

Revised push notification configuration

Last update: January 12, 2024

Applies to:
Campaign v8 Client Console

Topics:
Push

CREATED FOR:

Intermediate
Developer

Campaign v8.5 is introducing our latest Push notification service, powered by a robust framework built on a modern cutting-edge technology. This service is designed to unlock new levels of scalability, ensuring that your notifications can reach a larger audience with seamless efficiency. With our enhanced infrastructure and optimized processes, you can expect higher scale and reliability, empowering you to engage and connect with your Mobile App users like never before.

AVAILABILITY

This feature is exclusively accessible to new customers starting from Campaign v8.5 and progressively rolled out to a set of selected customers. If your environment was provisioned prior to June 2023, this page does not apply to you, and you must follow the procedures detailed in this page.

In the context of this updated implementation, to send push notifications in Adobe Campaign, follow these steps:

Create an App surface in Adobe Experience Platform Data Collection
Configure your application settings in Adobe Campaign
Create and configure a mobile property in Adobe Experience Platform Data Collection
Add Adobe Adobe Experience Platform Assurance extension(recommended)
Add Campaign Classic to your mobile application
Create a delivery for both iOS and Android

NOTE

Legacy FCM and APNS p12 are not supported with Data Collection.

Create an App surface in Adobe Experience Platform Data Collection

You need to add your mobile application push credentials in Adobe Experience Platform Data Collection.

The mobile app push credential registration is required to authorize Adobe to send push notifications on your behalf. Refer to the steps detailed below:

From Adobe Experience Platform Data Collection, select the App Surfaces tab in the left-hand panel.
Click Create App Surface to create a new configuration.
Enter a Name for the configuration.
From Mobile Application Configuration, select the Operational system:
- For iOS
  1. Enter the mobile app Bundle Id in the App ID (iOS Bundle ID) field.
    
    The app Bundle ID can be found in the General tab of the primary target in XCode of your Apple developer account.
  2. Switch on Push Credentials to add your credentials.
  3. Drag and drop your .p8 Apple Push Notification Authentication Key file.
    
    This key can be acquired from the Certificates, Identifiers and Profiles page of your Apple developer account.
  4. Provide the Key ID. This is a 10 character string assigned during the creation of p8 auth key.
    
    It can be found under Keys tab in Certificates, Identifiers and Profiles pag of your Apple developer account.
  5. Provide the Team ID. This is a string value which can be found under the Membership tab.
- For Android
  1. Provide the App ID (Android package name). Usually the package name is the app id in your build.gradle file.
  2. Switch Push Credentials to add your credentials.
  3. Drag and drop the FCM push credentials. For more details on how to get the push credentials refer to Google Documentation.
Click Save to create your app configuration.

Configure your application settings in Adobe Campaign

Create a service

Before sending push notifications, you must define your iOS and Android apps settings in Adobe Campaign.

Push notifications are sent to your app users through a dedicated service. When users install your app, they subscribe to this service: Adobe Campaign relies on this service to target only the subscribers of your app. In this service, you need to add your iOS and Android apps to send on iOS and Android devices.

To create a service to send push notifications, follow the steps below:

Browse to Profiles and Targets > Services and Subscriptions tab, and click Create.
Enter a Label and an Internal name, and select a Mobile application type.

NOTE
The default Subscriber applications (nms:appSubscriptionRcp) target mapping is linked to the recipients table. If you want to use a different target mapping, you need to create a new target mapping and enter it in the Target mapping field of the service. Learn more about target mappings in this page.
Then use the Add icon on the right to define the mobile applications that use this service.

Create a mobile application

After creating your service, you now need to define the mobile applications that will use this service.

iOS

To create an app for iOS devices, follow these steps:

From you Service, click Add then select Create an iOS application. Click Next.
From the Launch app configurations list window, select the App surface previously created in this section. Click Next.
(optional) You can enrich a push message content with some Application variables. These are fully customizable and a part of the message payload sent to the mobile device.

In the example below, the mediaURl and mediaExt variables are added to create rich push notification and then provides the application with the image to display within the notification.
Browse to the Subscription parameters tab to define the mapping with an extension of the Subscriber applications (nms:appsubscriptionRcp) schema.
Browse to the Sounds tab to define a sound to play. Click Add and fill Internal name field which must contain the name of the file embedded in the application or the name of the system sound.
Click Next to start configuring the development application.
The Integration key is specific to each application. It links the mobile application to Adobe Campaign and will be used when configuring Campaign extension.

Make sure that the same Integration key is defined in Adobe Campaign and in the application code via the SDK.

Learn more in the Developer documentation

NOTE
The Integration key is fully customizable with string value but needs to be exactly the same as the one specified in the SDK.
You cannot use the same certificate for the development version (sandbox) and the production version of the application.
Select the icon from the Application icon field to personalize mobile application in your service.
Click Next to start configuring the production application and follow the same steps as detailed above. Note that you cannot use the same Integration key for the development version (sandbox) and the production version of the application.
Click Finish.

Your iOS application is now ready to be used in Campaign.

Android

To create an app for Android devices, follow these steps:

From you Service, click Add then select Create an Android application. Click Next.
From the Launch app configurations list window, select the App surface created in this section and click Next.
The integration key is specific to each application. It links the mobile application to Adobe Campaign and will be used when configuring Campaign extension.

Make sure that the same Integration key is defined in Adobe Campaign and in the application code via the SDK.

Learn more in the Developer documentation

NOTE
The Integration key is fully customizable with string value but needs to be exactly the same as the one specified in the SDK.
Select the icon from the Application icon field to personalize mobile application in your service.
(optional) You can enrich a push message content with some Application variables if needed. These are fully customizable and a part of the message payload sent to the mobile device.
Browse to the Subscription parameters tab to define the mapping with an extension of the Subscriber applications (nms:appsubscriptionRcp) schema.
Click Finish then Save.

Your Android application is now ready to be used in Campaign.

Below are the FCM payload names to further personalize your push notification:

Message type

Configurable message element (FCM payload name)

Configurable options (FCM payload name)

data message

N/A

validate_only

notification message

title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count

validate_only

Configure a mobile property in Adobe Experience Platform Data Collection

From Data Collection homepage, access the Tags menu.
Click New Property.
Type a name for the property and select Mobile as the platform.
Click Save to create the mobile property.
Access your newly created mobile property.
From your mobile property dashboard, access the Extensions menu then the Catalog tab.
Install the Adobe Campaign Classic extension. Learn more on Campaign extension
Fill in your instance details:
- Registration endpoint or Tracking endpoint URLs can be found in the Tools > Advanced > Deployment wizard menu in Campaign.
- Integration keys can be found in the mobile app configured in this section.
Click Save.
You now need to publish the configuration from the Publishing flow menu. Learn more

Your mobile property will now be automatically sync with the Adobe Experience Platform Data Collection technical workflow. Learn more

Add Campaign Classic to your mobile application

The Adobe Experience Platform Mobile SDK helps power Adobe’s Experience Cloud solutions and services in your mobile apps. SDKs configuration is managed through the Data Collection UI for flexible configuration and extensible, rules-based integrations.

Learn more in Adobe Developer documentation.

Create your push notification

Once you have successfully configured your mobile application in Data Collection, you can now create and send push notifications in Adobe Campaign.

Refer to this page for the detailed elements specific to the delivery of iOS and Android notifications.

recommendation-more-help