Configuring a mobile application by using Adobe Experience Platform SDKs

To leverage mobile use cases in Adobe Campaign Standard with an Experience Cloud SDK application, a mobile app has to be created in Adobe Experience Platform Launch and be configured in Adobe Campaign Standard.

Note:

For a list of the commonly asked questions, about Push and In-App messaging, see Push and In-App FAQ.

Note:

The terms mobile application and mobile property are used interchangeably in this KB article.

To complete the configuration, complete the following steps:

  1. In Adobe Campaign, ensure that you can access the following:

    • Push notification
    • In-App message 
    • Adobe Places (Beta)

    If not, contact your account team.

  2. Verify that your user has the necessary permissions in Adobe Campaign Standard and Experience Platform Launch.

    • In Adobe Campaign Standard, ensure that the IMS user is part of the Standard User and Administrator Product Profiles.
      This step allows the user to log in to Adobe Campaign Standard, navigate to the Experience Platform SDK mobile app page, and view the mobile app properties that you created in Experience Platform Launch.
    • In Experience Platform Launch, ensure that your IMS user is part of a Experience Platform Launch product profile.
      This step allows the user to log in to Experience Platform Launch to create and view the properties. For more information about product profiles in Experience Platform Launch, see Create your product profile. In the product profile, there should be no permissions set on the company or the properties, but the user should be able to still log in.

      To complete additional tasks like installing an extension, publishing an app, configuring environments, and so on, you need to set permissions in the product profile. 
  3. In Experience Platform Launch, create a mobile property.

    For more information, see Set up a mobile property.

  4. In Experience Platform Launch, click the Extensions tab, go to Catalog, and search for the Adobe Campaign Standard extension.
    For more information, see Adobe Campaign Standard.

  5. To support location use cases in Campaign Standard, install the Places extension and the Places Monitor extension.

  6. In Adobe Campaign Standard, configure the mobile property that you created in Experience Platform Launch.

    For more information, see Setting up your Experience Platform Launch application in Adobe Campaign.

  7. Add the channel-specific configuration to your mobile application set up.

    For more information, see Channel-specific application configuration in Adobe Campaign.

  8. To support mobile use case implementations, see the detailed instructions about extensions, Experience Platform Launch rules, and the SDK implementation in Mobile use cases supported in Adobe Campaign Standard by using the Adobe Experience Platform SDKs.

  9. If required, you can delete your Experience Platform Launch property.

    For more information, see Deleting your Experience Platform Launch application.

Setting up your Adobe Experience Platform Launch application in Adobe Campaign

To use an Experience Platform Launch mobile property in Campaign, you also need to configure this property in Adobe Campaign. In Adobe Campaign, ensure that the IMS user is part of the Standard User and Administrator Product Profiles.

  1. From the advanced menu, select Administration Channels > Mobile app (AEP SDK).

    launch_33
  2. Select the mobile application that you created in Experience Platform Launch.
    Its Property Status should be Ready to configure.

    launch_2

    Note:

    By default, to retrieve the list of mobile applications created in Adobe Launch, Campaign Classic uses the value defined in the NmsServer_URL option to look for matching properties.

    In some cases, the Campaign endpoint for a mobile application may be different from the one defined in NmsServer_URL. In that case, define the endpoint in the Launch_URL_Campaign option. Campaign will use the value from this option to look for matching properties in Adobe Launch..

  3. To make the connection between Campaign and Experience Platform Launch, click Save.

  4. Verify that the status of the mobile app has changed from Ready to Configure to Configured.

    When the Experience Platform Launch Campaign extension shows that the pkey has been set up successfully, you can also verify that the property has been set up successfully in Campaign.

    Note:

    The pkey is a unique key that is used to reference a mobile application in Adobe Campaign.

    launch_3
  5. For this configuration to take effect, the changes need to be published in Experience Platform Launch.

    For more information, see Publish configuration.

Channel-specific application configuration in Adobe Campaign

Your mobile application is now ready to be used in Campaign for push notification or In-app deliveries. You can now further configure it if needed to create events that will trigger your in-app messages and/or upload Push certificates.

  1. From the advanced menu, select Administration > Channels > Mobile app (AEP SDK).

  2. Select the mobile application you created and configured in Experience Platform Launch.

  3. On the Mobile application properties tab, you can start adding events that are available in your mobile application for your in-app messages.

  4. To configure your events, click Create Element.

    launch_25
  5. Type a name and a description. 

    launch_26
  6. Click Add.

    Your event is now available on the Triggers tab when you create an in-app message. For more information, see Preparing and sending an In-App message.

  7. In the Device-specific settings section of a mobile application dashboard, for each device, provide the application details, including the certificate for iOS and the server key for Android.

    After your certificate is uploaded, a message notifies you that the upload was successful and displays the expiration date of your certificate.

    Certificate successful
  8. Click the Mobile application subscribers tab to see a list of subscribers and other information about these subscribers, for example, whether they opted out of your notifications.

Deleting your Adobe Experience Platform Launch application

Caution:

Deleting your Experience Platform Launch application cannot be reversed.

To delete your Experience Platform Launch application, complete the steps in Deleting mobile properties.

After your application is deleted, in Adobe Campaign, verify whether your application's Property status has been correctly updated to Deleted in Launch.

By clicking on your application in Adobe Campaign, you can choose to completely remove this application from Adobe Campaign by clicking Delete from Campaign.

launch_27

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy