v7
Applies to Campaign Classic v7
v8
Also applies to Campaign v8

Get started with mobile app channel about-mobile-app-channel

The Mobile App Channel lets you use the Adobe Campaign platform to send personalized push notifications to iOS and Android terminals via apps.

Two delivery channels are available:

  • An iOS channel that enables you to send notifications to Apple mobile devices.

  • An Android channel that enables you to send data messages to Android mobile devices.

    note important
    IMPORTANT
    Some important changes to the Android Firebase Cloud Messaging (FCM) service will be released in 2024, and may impact your Adobe Campaign implementation. Your subscription services configuration for Android push messages may need to be updated to support this change. You can already check and take action. Learn more in this Adobe Campaign v8 technote.

Corresponding to those two channels there are two delivery activities in the campaign workflows. Two transactional message templates are also available for transactional messaging.

You can define the application behavior for when the user activates the notification to display the screen that matches the application context. For example:

  • A notification is sent to the customer to let them know their parcel has exited the warehouse. Activating the notification opens a page with delivery-related information on it.
  • The user has added items to the cart, but left the application without completing the purchase. A notification is sent, telling them that their cart has been abandoned. When they activate the notification, the item is displayed on the screen.
CAUTION
  • You need to make sure the notifications sent to a mobile application are compliant with the prerequisites and conditions specified by Apple (Apple Push Notification Service) and Google (Firebase Cloud Messaging).
  • Warning: in some countries, the law requires that you inform users of your collected data type mobile applications and the purpose of their processing. You must check the legislation.

The NMAC opt-out management (mobileAppOptOutMgt) workflow updates notification unsubscriptions on mobile devices. For more information on this workflow, refer to the list of technical workflows.

Adobe Campaign is compatible with HTTP/2 APNs. For more details on the configuration steps, refer to the this section section.

For global information on how to create a delivery, refer to this section.

Data path data-path

The following schemas detail the steps that enable a mobile application to exchange data with Adobe Campaign. This process involves three entities:

  • the mobile application
  • the notification service: APNs (Apple Push Notification Service) for Apple and FCM (Firebase Cloud Messaging) for Android
  • Adobe Campaign

The three main steps of the notification process are: registration of the application in Adobe Campaign (subscription collection), deliveries, and tracking.

Step 1: Subscription collection step-1--subscription-collection

The mobile application is downloaded by the user from the App Store or from Google Play. This application contains the connection settings (iOS certificate and project key for Android) and the integration key. The first time the application is opened, (depending on configuration), the user can be asked to enter registration information (@userKey: email or account number for instance). At the same time, the application questions the notification service to collect a notification ID (push ID). All this information (connection settings, integration key, notification identifier, userKey) is sent to Adobe Campaign.

Step 2: Delivery step-2--delivery

Marketers target application subscribers. The delivery process sends the connection settings to the notification service (iOS certificate and project key for Android), the notification ID (push ID) and the content of the notification. The notification service sends notifications to the targeted terminals.

The following information is available in Adobe Campaign:

  • Android only: number of devices that have displayed the notification (impressions)
  • Android and iOS: number of clicks on the notification

The Adobe Campaign server must be able to contact the APNs server on the 443 port for iOS HTTP/2 connector.

To check that it works correctly, use the following commands:

  • For tests:

    code language-none
    api.development.push.apple.com:443
    
  • In production:

    code language-none
    api.push.apple.com:443
    

With the iOS HTTP/2 connector, the MTA and web server must be able to contact the APNs on port 443.

If you need to use the iOS HTTP/2 connector through a proxy, refer to this page.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1