Show Menu
TOPICS×

Configuring a mobile application

Configuring a mobile application using Adobe Experience Platform SDKs

Push notification and In-App implementations have to be performed by expert users. If you need to be assisted, contact your Adobe Account executive or Professional services partner.
To send push notifications and In-App messages with Experience Platform SDK application, a mobile application has to be set up in Adobe Experience Platform Experience Platform Experience Platform Launch and configured in Adobe Campaign.
For more information on the deprecated feature Mobile version 4 SDKs, refer to this page .
Once a mobile application is set up, you can retrieve the PII data it collected to create or update profiles from your database. For more on this, refer to this section: Creating and updating profile information based on mobile application data .
To learn more on the different mobile use cases supported in Adobe Campaign Standard by using the Adobe Experience Platform SDKs, refer to this page .
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
    If not, contact your account team.
  2. Check 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.
    • Install the Places extension in Experience Platform Launch. Refer to this page .
    • Install the Places Monitor extension in Experience Platform Launch. Refer to this page
  6. In Adobe Campaign Standard, configure the mobile property that you created in Experience Platform Launch. Refer to Setting up your Adobe 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. If required, you can delete your Experience Platform Launch property. For more information, see Deleting your Experience Platform Launch application .

Sync Mobile app AEPSDK from Launch technical workflow

This feature is a beta capability in Adobe Campaign as of release 20.3. You will need to submit a ticket to Adobe Customer Care (either directly or through your Adobe contact) to have the sync Mobile app AEPSDK from Launch technical workflow enabled in your Adobe Campaign instance.
After creating and configuring your mobile property in Experience Platform Launch, the Sync Mobile app AEPSDK from Launch technical workflow will now synchronize the Adobe Launch mobile properties imported in Adobe Campaign Standard.
By default, the technical worflow starts every 15 minutes. If needed, it can be manually restarted:
  1. In Adobe Campaign Standard, from the advanced menu, select Administration > Application Settings > Workflows .
  2. Open the Sync Mobile app AEPSDK from Launch (syncWithLaunch) workflow.
  3. Click on the Scheduler activity.
  4. Select Immediate execution .
Your workflow will now restart and synchronize the Adobe Launch mobile properties imported in Adobe Campaign Standard.

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.
For users with the Sync Mobile app AEPSDK from Launch technical workflow feature flag enabled, you will need to wait for the technical workflow to run and sync the Launch mobile property to Adobe Campaign. You can then configure it in Adobe Campaign.
For more information on Sync Mobile app AEPSDK from Launch technical workflow feature flag, refer to this section .
By default, administrators with organizational unit set to ALL can edit the mobile application.
  1. From the advanced menu, select Administration > Channels > Mobile app (AEP SDK) .
  2. Select the mobile application that you created in Experience Platform Launch. Its Property Status should be Ready to configure .
    By default, to retrieve the list of mobile applications created in Adobe Launch, Campaign Standard 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. You can change the organizational unit of your mobile application under the Access Authorization section to limit access to this mobile application to specific organization units. For more information, refer to this page.
    Here, the administrator can assign sub organizational units by selecting them from the drop-down.
  4. To make the connection between Campaign and Experience Platform Launch, click Save .
  5. 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.
  6. 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 .
  5. Type a name and a description.
  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.
    After successfully adding the certificate in Adobe Campaign Standard, you will no longer be able to change your settings back since only one APNS platform (production or sandbox) can be added to the MCPNS app.
  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

Deleting your Experience Platform Launch application cannot be reversed.
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.