Once the package is installed, you can define your Android app settings in Adobe Campaign Classic.
To learn how to configure your app for iOS and how to create a delivery for iOS, refer to this section.
Key steps are:
You will then be able to create an Android rich notification.
For Android, two connectors are available:
To choose which connector you want to use, follow these steps:
Go to Administration > Platform > External accounts.
Select the Android routing external account.
In the Connector tab, fill in the JavaScript used in the connector field:
For Android V2: https://localhost:8080/nms/jsp/androidPushConnectorV2.js
You can also configure it as follow https://localhost:8080/nms/jsp/androidPushConnector.js but we advise you to use version 2 of the connector.
For Android V2, one additional parameter is available in the Adobe Server configuration file (serverConf.xml):
Learn how to configure an Android service in video
Go to the Profiles and Targets > Services and subscriptions node and click New.
Define a Label and an Internal name.
Go to the Type field and select Mobile application.
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. For more on creating target mapping, refer to the Configuration guide.
Then click the Add button to select the application type.
Create your Android application. For more on this, refer to this section.
After creating your service, you now need to create your Android application:
From your newly created service, click the Add button to select the application type.
Select Create an Android application and enter a Label.
Make sure the same Integration key is defined in Adobe Campaign and in the application code via the SDK. For more on this, refer to: Integrating Campaign SDK into the mobile application.
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 API version: HTTP v1 or HTTP (legacy). These configurations are detailed in this section
Fill in the Firebase Cloud Messaging the Android connection settings fields.
Click Finish then Save. Your Android application is now ready to be used in Campaign Classic.
By default, Adobe Campaign saves a key in the User identifier (@userKey) field of the Subscriber applications (nms:appSubscriptionRcp) table. This key enables you to link a subscription to a recipient. To collect additional data (such as a complex reconciliation key), you need to apply the following configuration:
After creating service and a new mobile application, you need to configure your mobile application depending on the chosen API version.
To configure the HTTP v1 API version, follow the steps below:
In your Mobile application creation wizard window, select HTTPV1 in the API version drop-down.
Click Load project json file to extract projet details… to load directly your JSON key file. For more information on how to extract your JSON file, refer to this page.
You can also enter manually the following details:
Click Test the connection to check that your configuration is correct and that the marketing server has access to the FCM.
For Mid-Sourcing Deployment, the Test connection button will not check if the MID server has access to the FCM server.
As an option, 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 Classic.
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 |
To configure the HTTP (legacy) API version, follow the steps below:
In your Mobile application creation wizard window, select HTTP (legacy) in the API version drop-down.
Enter the Project key that was provided by the developer of the mobile application.
As an option, 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.
In the following example, we add title, imageURL and iconURL to create rich push notification and then provides the application with the image, title and icon to display within the notification.
Click Finish then Save. Your Android application is now ready to be used in Campaign Classic.
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 | dryRun |
notification message | title, body, android_channel_id, icon, sound, tag, color, click_action |
dryRun |
Learn how to extend the appsubscriptionRcp schema in video
You need to extend the appsubscriptionRcp to define new additional fields to store parameters from the app in Campaign database . These fields will be used for personalization for example. To do this:
Create an extension of the Subscriber applications (nms:appsubscriptionRcp) schema and define the new fields. Learn more about schema extension in this page
Define the mapping in the Subscription parameters tab.
Make sure the configuration names in the Subscription parameters tab are the same as those in the mobile application code. Refer to the Integrating Campaign SDK into the mobile application section.
With Firebase Cloud Messaging, you can choose between two types of messages:
Data message, handled by the client app.
Messages are sent directly to the mobile application which will generate and display the android notification to the device. Data messages contain only your custom application variables.
Notification message, handled automatically by the FCM SDK.
FCM automatically displays the message on your users’ devices on behalf of the client app. Notification messages contain a predefined set of parameters and options but can still be further personalized with custom application variables.
For more information on Firebase Cloud Messaging messages types, refer to FCM documentation.
Go to Campaign management > Deliveries.
Click New.
Select Deliver on Android (android) in the Delivery template drop-down. Add a Label to your delivery.
Click To to define the population to target. By default, the Subscriber application target mapping is applied. Click Add to select your service.
In the Target type window, select Subscribers of an Android mobile application and click Next.
In the Service drop-down, select your previously created service then application and click Finish.
The Application variables are automatically added depending on what was added during the configuration steps.
Select data message as Message Type.
Edit your rich notification.
You can add information in your previously configured Application variables if needed. Application variables needs to be configured in the Android service and are a part of the message payload sent to the mobile device.
Click Save and send your delivery.
The image and web page should be displayed in the push notification when received on the subscribers’ mobile Android devices.
Additional options for notification message are only available with HTTP v1 API configuration. For more on this, refer to this section.
Learn how to create an Android push notification in video
Go to Campaign management > Deliveries.
Click New.
Select Deliver on Android (android) in the Delivery template drop-down. Add a Label to your delivery.
Click To to define the population to target. By default, the Subscriber application target mapping is applied. Click Add to select your service.
In the Target type window, select Subscribers of an Android mobile application and click Next.
In the Service drop-down, select your previously created service then application and click Finish.
Select notification message as Message Type.
Add a title and edit your message. Personalize your push notification with the Notification options:
For more on the Notification options and how to fill these fields, refer to FCM documentation.
If your application is configured with HTTP v1 API protocol, you can further personalize your push notification with the following HTTPV1 additional options:
For more on the HTTP v1 additional options and how to fill these fields, refer to FCM documentation.
You can add information in your previously configured Application variables if needed. Application variables needs to be configured in the Android service and are a part of the message payload sent to the mobile device.
Click Save and send your delivery.
The image and web page should be displayed in the push notification when received on the subscribers’ mobile Android devices.