Configuration steps for Android

Once the package is installed, you can define your Android app settings in Adobe Campaign Classic.

NOTE

To learn how to configure your app for iOS and how to create a delivery for iOS, refer to this section.

Key steps are:

  1. Configure the Android external account
  2. Configure the Android service
  3. Create the mobile app in Campaign
  4. Extend the app schema with additional data

You will then be able to create an Android rich notification.

Configure Android external account

For Android, two connectors are available:

  • The V1 connector which allows one connection per MTA child.
  • The V2 connector which allows simultaneous connections to the FCM server to improve throughput.

To choose which connector you want to use, follow these steps:

  1. Go to Administration > Platform > External accounts.

  2. Select the Android routing external account.

  3. In the Connector tab, fill in the JavaScript used in the connector field:

    For Android V2: https://localhost:8080/nms/jsp/androidPushConnectorV2.js

    NOTE

    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.

  4. For Android V2, one additional parameter is available in the Adobe Server configuration file (serverConf.xml):

    • maxGCMConnectPerChild: Maximum limit of parallel HTTP requests to the FCM initiated by each child server (8 by default).

Configure an Android service

Learn how to configure an Android service in video

  1. Go to the Profiles and Targets > Services and subscriptions node and click New.

  2. Define a Label and an Internal name.

  3. Go to the Type field and select Mobile application.

    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. For more on creating target mapping, refer to the this section.

  4. Then click the Add button to select the application type.

  5. Create your Android application. For more on this, refer to this section.

Create the Android mobile application

After creating your service, you now need to create your Android application:

  1. From your newly created service, click the Add button to select the application type.

  2. Select Create an Android application and enter a Label.

  3. 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 this section.

    NOTE

    The Integration key is fully customizable with string value but needs to be exactly the same as the one specified in the SDK.

  4. Select the API version: HTTP v1 or HTTP (legacy). These configurations are detailed in this section

  5. Fill in the Firebase Cloud Messaging the Android connection settings fields.

  6. 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:

Select the API version

After creating service and a new mobile application, you need to configure your mobile application depending on the chosen API version.

Configure HTTP v1 API

To configure the HTTP v1 API version, follow the steps below:

  1. In your Mobile application creation wizard window, select HTTPV1 in the API version drop-down.

  2. Click Load project json file to extract project 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:

    • Project Id
    • Private Key
    • Client Email

  3. Click Test the connection to check that your configuration is correct and that the marketing server has access to the FCM.

    CAUTION

    For Mid-Sourcing Deployment, the Test connection button will not check if the MID server has access to the FCM server.

  4. 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.

  5. 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


Configure HTTP (legacy) API

To configure the HTTP (legacy) API version, follow the steps below:

  1. In your Mobile application creation wizard window, select HTTP (legacy) in the API version drop-down.

  2. Enter the Project key that was provided by the developer of the mobile application.

  3. 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.

  4. 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

Extend the appsubscriptionRcp schema

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:

  1. Create an extension of the Subscriber applications (nms:appsubscriptionRcp) schema and define the new fields. Learn more about schema extension in this page

  2. Define the mapping in the Subscription parameters tab.

    CAUTION

    Make sure the configuration names in the Subscription parameters tab are the same as those in the mobile application code. Refer to this section.

On this page