Create and send push notifications

Mobile app deliveries let you send notifications to iOS and Android devices.

To send push notifications in Adobe Campaign, you need to:

Integrate the SDK with your app. Learn more
Create a Mobile application-type information service for your mobile application, and add the iOS and Android versions of the application to that service. Learn more
Create a delivery for both iOS and Android. Learn more

Integrate the SDK

To send push notifications with Adobe Campaign, you must configure the Adobe Campaign extension in the Data Collection UI of the Adobe Experience Platform Mobile SDK.

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.

Configure your app settings in Campaign

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.

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

Select Create an iOS application and click Next.
Enter the name of your app in the Label field.
(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 bellow, 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.

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.
Select the Authentication mode. Two modes are available:
- (Recommended) Token-based authentication: Fill in the APNs connection settings Key Id, Team Id and Bundle Id then select your p8 certificate by clicking Enter the private key…. For more on Token-based authentication, refer to Apple documentation.
- Certificate-based authentication: Click Enter the certificate… then select your p12 key and enter the password that was provided by the mobile application developer.
You can change your authentication mode later on in the Certificate tab of your mobile application.
Use the Test the connection button to validate your configuration.
Click Next to start configuring the production application and follow the same steps as detailed above.
Click Finish.

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

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

Select Create an Android application and click Next.
Enter the name of your app in the Label field.
The integration key is specific to each application. It links the mobile application to Adobe Campaign.

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.
Select HTTP v1 in API version drop-down list.
Click Load project json file to extract project details… link to load your JSON key file. For more information on how to extract your JSON file, refer to Google Firebase documentation.

You can also enter manually the following details:
- Project Id
- Private Key
- Client Email
Use the Test the connection button to validate your configuration.

CAUTION

The Test connection button does not check if the MID server has access to the FCM server.
(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.
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

Create your first push notification

This section details the elements specific to the delivery of iOS and Android notifications.

CAUTION

In the context of an Enterprise (FFDA) deployment, mobile registration is now asynchronous. Learn more

To create a new delivery, browse to the Campaigns tab, click Deliveries and click the Create button above the list of existing deliveries.

To send notifications on iOS devices, follow these steps:

Select the Deliver on iOS delivery template.
To define the target of the notification, click the To link, then click Add.
Select Subscribers of an iOS mobile application (iPhone, iPad), select the service relevant to your mobile application, then select the iOS version of the application.
Choose your Notification type between General notification (Alert, Sound, Badge) or Silent notification.

NOTE

The Silent Push mode allows a “silent” notification to be sent to a mobile application. The user is not made aware of the notification’s arrival. It is transferred directly to the application.
In the Title field, enter the label of the title that you want to appear in the list of notifications available from the notification center.

This field allows you to define the value of the title parameter of the iOS notification payload.
You can add a Subtitle, value of the subtitle parameter of the iOS notification payload.
Enter the content of the message in the Message content section of the wizard.
From the Sound and Badge tab, you can edit the following options:
- Clean Badge: enable this options to refresh the badge value.
- Value: set a number which will be used to display directly on the application icon the number of new unread information.
- Critical alert mode: enable this option to add sound to your notification even the user’s phone is set on focus mode or if the iPhone is muted.
- Name: select the sound to be played by the mobile terminal when the notification is received.
- Volume: volume of your sound from 0 to 100.
  
  NOTE
  
  Sounds must be included in the application and defined when the service is created.
From the Application variables tab, your Application variables are automatically added. They let you define notification behavior, for instance, you can configure a specific application screen to be displayed when the user activates the notification.
From the Advanced tab, you can edit the following general options:
- Mutable content: enable this option to allow the mobile application to download media content.
- Thread-id: identifier used to group related notifications together.
- Category: name of your category ID which will display action buttons. These notifications give the user a faster way to perform different tasks in response to a notification without opening or navigating in the application.
For time sensitive notification, you can specify the following options:
- Target content ID: identifier used to target which application window to brought forward when the notification is opened.
- Launch image: name of the launch image file to display. If the user chooses to launch your application, the selected image will displayed instead of your application’s launch screen.
- Interruption level:
  - Active: Set by default, the system presents the notification immediately, lights up the screen, and can play a sound. Notifications do not break through Focus modes.
  - Passive: The system adds the notification to the notification list without lighting up the screen or playing a sound. Notifications do not break through Focus modes.
  - Time sensitive The system presents the notification immediately, lights up the screen, can play a sound and break through Focus modes. This level does not require a special permission from Apple.
  - Critical The system presents the notification immediately, lights up the screen, and bypasses the mute switch or focus modes. Note that this level requires a special permission from Apple.
- Relevance score: set a relevance score from 0 to 100. The system uses this to sort the notifications in the notification summary.
Once the notification is configured, click the Preview tab to preview the notification.

To send notifications on Android devices, follow these steps:

Select the Deliver on Android (android) delivery template.
To define the target of the notification, click the To link, then click Add.
Select Subscribers of an Android mobile application, choose the service relevant to your mobile application (Neotrips, in this case), then select the Android version of the application.
Then enter the content for the notification.
Click the Insert emoticon icon to insert emoticons to your push notification.
In the Application variables field, enter the value of each variable. For example, you can configure a specific application screen to be displayed when the user activates the notification.
Once the notification is configured, click the Preview tab to preview the notification.