Configuration steps for Android

Last update: April 8, 2025

CREATED FOR:

  • Intermediate
  • Experienced
  • User
  • Developer

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

Key steps are:

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

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.

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.

    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: