Configuration steps for iOS

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

NOTE

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

Configuring 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

    NOTE

    Starting Campaign 20.3 release, the iOS legacy binary connector is deprecated. If you are using this connector, you need to adapt your implementation accordingly. Learn more

  4. Click Save.

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

Configuring iOS service

CAUTION

The application must have been configured for Push actions BEFORE any integration to Adobe Campaign 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.

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

Creating iOS mobile application

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

  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.

    NOTE

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

    NOTE

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

    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.

Creating an iOS rich notification

With iOS 10 or higher, it is possible to generate rich notifications. Adobe Campaign can send notifications using variables that will allow the device to display a rich notification.

You now need to create a new delivery and link it to the mobile application that you created.

  1. Go to Campaign management > Deliveries.

  2. Click New.

  3. Select Deliver on iOS (ios) in the Delivery template drop-down. Add a Label to your delivery.

  4. Click To to define the population to target. By default, the Subscriber application target mapping is applied. Click Add to select our previously created service.

  5. In the Target type window, select Subscribers of an iOS mobile application (iPhone, iPad) and click Next.

  6. In the Service drop-down, select your previously created service then the application you want to target and click Finish.
    The Application variables are automatically added depending on what was added during the configuration steps.

  7. Edit your rich notification.

  8. Check the Mutable content box in the edit notification window to allow the mobile application to download media content.

  9. Click Save and send your delivery.

The image and web page should be displayed in the push notification when received on the subscribers’ mobile iOS devices.

On this page