Configuring Adobe Experience Platform Launch rules to support Adobe Campaign Standard use cases

In Experience Platform Launch, you need to create data elements and rules to send PII and other data from mobile applications to Campaign.

Caution:

To ensure that all configuration changes in Experience Platform Launch take effect, you must publish these changes. For more information, see Publishing.

To create rules in Experience Platform Launch, follow these steps:

Step 1 Create data elements

Here are the data elements we recommend that you create in Experience Platform Launch:
(You can create additional data elements as per your business needs.)

  • Experience Cloud ID
  • Pkey
  • Campaign server

To create these data elements:

  1. In Experience Platform Launch, from your mobile application dashboard, click the Data Elements tab.

  2. To create the Experience Cloud ID data element, click Create New Data Element.

  3. Complete the following steps:

    1. In the Name field, for example, type in mcid.
    2. From the Extension drop-down, select Mobile Core.
    3. From the Data element type drop-down, select Experience Cloud ID.
    creating a data element
  4. Click Save.

  5. To create the Pkey data element, click Add data element.

  6. Complete the following steps:

    1. In the Name field, for example, type in pkey.
    2. From the Extension drop-down, select Adobe Campaign Standard.
    3. From the Data element type drop-down, select PKey.
    4. Click Save.
  7. Click Save.

  8. To create the Campaign server data element, click Add data element.

  9. Complete the following steps:

    1. In the Name field, type a name, for example, camp-server.
    2. From the Extension drop-down, select Adobe Campaign Standard.
    3. From the Data element type drop-down, select Campaign Server.
    4. Click Save.
  10. Click Save.

Step 2 Create rules

PII postback

Note:

To send PII information from a mobile app to Campaign, you need to implement an SDK API. For more information, go to CollectPII.

To send PII data to Campaign Standard, create a rule in Experience Platform Launch:

  1. In Experience Platform Launch, from your mobile application dashboard, click the Rules tab.

  2. Click Create New Rule.

  3. Type a name, for example, Mobile Core - Collect PII.

  4. In the Events section, click Add.

  5. Complete the following steps:

    1. From the Extension drop-down, select Mobile Core.
    2. From the Event type drop-down, select Collect PII.
  6. Click Keep changes.

  7. In the Actions section, click Add.

  8. Complete the following steps:

    1. From the Extension drop-down, select Mobile Core.
    2. From the Action type drop-down, select Send PII.
  9. In URL, enter the following URL:

    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}

  10. Select the Add Post Body check box.

  11. In Post Body, type the following:

    {
    "marketingCloudId":
    "{%%mcid%%}",
    "cusEmail":
    "{%contextdata.email%}",
    "cusFirstName":
    "{%contextdata.firstName%}",
    "cusLastName":
    "{%contextdata.lastName%}" }

    Note:

    • The marketingCloudId enables you to reconcile your app subscribers with the recipients in the database and, as a result, is required. You can specify other key-value pairs as per your business needs. In the example above, EmailFirst Name, and Last Name are being passed from the app.

      The keys (for example cusEmail, cusFirstName, and cusLastName) should match the field IDs that are defined in your custom resource in the Adobe Campaign Standard instance. The value variables (for example email, firstName, and LastName) should match the keys in the JSON data that is sent from the mobile app while calling the AMS collectPII API from the app code.
    • You can also pass Lifecycle data in the Collect PII postback or a different postback depending on your Event triggers. here is an example of the Lifecycle data JSON: 

      {

    "marketingCloudId":"{%%mcid%%}",

    "cusDayslastlaunch": "{%%DaysSinceLastUse%%}", 

    "cusDaysfirstlaunch": "{%%DaysSinceFirstUse%%}", 

    "cusLaunches": "{%%Launches%%}"

    }

    • The data elements that are defined in Experience Platform Launch should be enclosed in double percentages, for example %%mcid%%and context variables from app should be enclosed in single percentages, for example %contextdata.email%.

  12. In Content Type, type application/json

  13. In Timeout, select 0.

    Collect PII
  14. Click Keep changes and then Save.

    Your user data is now configured to be sent to Campaign.

In-App tracking postback

To send tracking data to Campaign Standard for reporting on how your users interact with In-App messages in your mobile application, create the following rule in Experience Platform Launch:

  1. In Experience Platform Launch, from your mobile application dashboard, select the Rules tab.

  2. Click Add Rule.

  3. Type a name, for example, Adobe Campaign - In-App click tracking.

  4. In the Events section, click Add.

  5. Complete the following steps:

    1. From the Extension drop-down, select Adobe Campaign Standard.
    2. From the Event type drop-down, select In-App click tracking.
  6. Click Keep changes.

  7. In the Actions section, click Add.

  8. Complete the following steps:

    1. From the Extension drop-down, select Mobile Core.
    2. From the Event type drop-down, select Send postback.
  9. In URL, type the following URL:

    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}

  10. Select the Add post body check box.

  11. In Post Body, type {}.

  12. In Content Type, type application/json

  13. In Timeout, select 0.

    creating a rule for an in-app postback
  14. Click Keep changes and then Save.

Push notifications tracking postback

To send tracking data to Campaign Standard, which helps track your Push notification deliveries and your users’ interaction with your mobile application, you need to create a rule in Experience Platform Launch.

Note:

For more information about push tracking, see Push Tracking.

Note:

To track app actions, use the trackAction API. For more information, see Track app actions

  1. In Experience Platform Launch, from your mobile application dashboard, click the Rules tab.

  2. Click Add Rule.

  3. Type a name, for example, Adobe Campaign - push click tracking.

  4. In the Events section, click Add.

  5. Complete the following steps:

    1. From the Extension drop-down, select Mobile Core.
    2. From the Event type drop-down, select Track Action.
  6. From the Action drop-down, select Action, select equals, and type tracking.

  7. Click Keep changes.

  8. In the Actions section, click Add.

  9. Complete the following steps:

    1. From the Extension drop-down, select Mobile Core.
    2. From the Action type drop-down, select Send postback.
  10. In URL, enter the following URL:

    https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}

  11. Select the Add post body check box. 

  12. Add your post body, for example, { }.

  13. In Content Type, type application/json

  14. In Timeout, select 0.

  15. Click Keep changes and then Save.

Location postback

  1. In Experience Platform Launch, from your mobile application dashboard, click the Rules tab.

  2. Click Add Rule.

  3. Type a name, for example, Location postback.

  4. In the Events section, click Add.

  5. Create an event (for example, Enter POI or Exit POI):

    1. From the Extension drop-down, select Places - Beta.
    2. From the Event type drop-down, select Enter POI or Exit POI.
    3. Enter a name, for example, Places - Beta - Enter POI or Exit POI.
  6. In the Actions section, click Add.

  7. Complete the following steps:

    1. From the Extension drop-down, select Mobile Core.
    2. From the Action type drop-down, select Send postback.
    3. Enter a name, for example, Mobile Core - Send Location Postback.
  8. In URL, enter the following URL:

    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/

  9. Select the Add post body check box. 

  10. Add your post body, for example:

    {
        "locationData": {
            "distances": "{%%Distance%%}",
            "poiLabel": "{%%POILabel%%}",
            "latitude": "{%%Latitude%%}",
            "longitude": "{%%Longitude%%}",
            "appId": "{%%AppId%%}",
            "marketingCloudId": "{%%ECID%%}"
        }
    }

    Note:

    In the example above, the data elements on the right-hand side need to be configured in Experience Platform Launch by leveraging the steps in Step 1 Create data elements. The data elements on the left-hand side are supported in Campaign Standard and do not need any configuration. If you require additional data, you need to carry out custom resource extensions in Campaign Standard.

  11. In Content Type, type application/json

  12. In Timeout, select 5.

  13. Click Keep changes and then Save.

    location postback

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