Configuration steps for iOS

Last update: 2023-08-31
  • Topics:
  • Push
    View more on this topic
  • Created for:
  • User

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


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

Key steps are:

  1. Configure the iOS external account
  2. Configure the iOS service
  3. Integrate the iOS mobile app in Campaign

You will then be able to create a push notification for iOS devices.

Configure iOS external account

For iOS, the iOS HTTP/2 connector sends notifications to the HTTP/2 APNs.

To configure this connector, follow these steps:

  1. Go to Administration > Platform > External accounts.

  2. Select the iOS routing external account.

  3. In the Connector tab, fill in the Access URL of the connector field with the following URL: http://localhost:8080/nms/jsp/iosHTTP2.jsp

  4. Click Save.

Your iOS connector is now configured. You can start creating your service.

Configure iOS service


The application must have been configured for Push actions BEFORE any integration to Adobe SDK.

If this is not the case, please refer to this page.

  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.


    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.

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

  5. Create your iOS Development and Production applications. For more on this, refer to this section.

Create iOS mobile app

After creating your service, create your iOS application in Campaign. Follow the steps below:

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

  2. The following window appears. Select Create an iOS application and start by entering the Label.

  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 mediaURl and mediaExt to create rich push notification and then provides the application with the image to display within the notification.

  4. The Subscription parameters tab allows you to define the mapping with an extension of the Subscriber applications (nms:appsubscriptionRcp) schema.


    Make sure that you do not use the same certificate for the development version (sandbox) and the production version of the application.

  5. The Sounds tab allows you to specify 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.

  6. Click Next to start configuring the development application.

  7. 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 page. This integration key, which is specific to each application, lets you link the mobile application to the Adobe Campaign platform.


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

  8. Select one of the out-of-the-box icons from the Application icon field to personalize mobile application in your service.

  9. Select the Authentication mode. Note that you can always change your authentication mode later on in the Certificate tab of your mobile application.

    • Certificate-based authentication: Click Enter the certificate… then select your p12 key and enter the password that was provided by the mobile application developer.
    • Token-based authentication: Fill in the 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.

    Adobe recommends using Token-based authentication for your iOS configuration since this authentication mode is more secured and not bound to certificate expiration.

  10. You can click Test the connection to be sure it is successful.

  11. Click Next to start configuring the production application and follow the same steps as detailed above.

  12. Click Finish.

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

On this page