Configuring Campaign-Points of Interest data integration

The mobile applications used to collect location data must be configured by an administrator in the Adobe Campaign interface.

To use the Point of Interest data feature, you need to:

  1. Have access to Adobe Analytics for Mobile. Check your licence agreement or contact your Adobe Account executive for more information.

  2. Set up your mobile application in Adobe Campaign. See Setting up a mobile app in Campaign.

  3. Set up your mobile application in the Adobe Mobile Services interface. This enables you to ensure that data collected by Adobe Mobile Services is sent to Adobe Campaign. See Configuring a mobile app in Adobe Mobile Services.

  4. Perform the mobile application's specific setup:

    • Package the configuration file downloaded from the Adobe Mobile Services interface with the mobile application.

    • Integrate the Experience Cloud Mobile SDK into your mobile application. See Integrating the SDK into a mobile application.

  5. Define Points of Interest in the Adobe Mobile Services interface. See Defining Points of Interest in Adobe Mobile Services.

  6. Define the data that you want to collect from your mobile application's subscribers. See Collecting subscribers' Points of interest data.

  7. Make sure you access the mobile application and the collected location data in Adobe Campaign. See Accessing mobile apps used to collect location data and Accessing collected location data.

Setting up a mobile app in Campaign

To be able to collect Points of interest data with Adobe Campaign, you must configure the mobile application which Adobe Campaign will be receiving data from.

  1. Click the Adobe Campaign logo, in the top left corner, then select Administration > Channels > Mobile app.

  2. Click Create to set up an application.

  3. Enter a name in the Application name field and click Create.

    Do not fill in the Device-specific settings section. This only applies to configuring applications that receive push notifications.

In the Mobile application properties section, two URLs are listed: Collect PII endpoint and Location Services endpoint. They will be used in the Adobe Mobile Services interface. See Configuring a mobile app in Adobe Mobile Services.

  • The Collect PII endpoint URL is used to collect the users' Experience Cloud IDs and registration tokens from the mobile application when it is launched. When a user logs into the application using credentials such as email, first name, last name etc., this data is also collected and used to reconcile the user's registration token with an Adobe Campaign profile.

  • The Location Services endpoint URL is used to collect location data such as a user's latitude, longitude and radius from a Point of Interest.

You can now use these values in Adobe Mobile Services to finish the configuration, as explained in the Configuring a mobile app in Adobe Mobile Services section.

POI_mobile_app_properties

Configuring a mobile app in Adobe Mobile Services

To send the data collected by Adobe Mobile Services to Adobe Campaign, you must configure postbacks in the Mobile Services interface.

You will need specific information that you can find in the mobile application parameters set in Adobe Campaign (see Setting up a mobile app in Campaign):

  • IMS Organization ID

  • Collect PII Endpoint

  • Location Services endpoint

You must have access to Adobe Analytics to do the following configuration. If you are not an Adobe Analytics user, contact your Adobe Campaign administrator.

  1. Create the application or select an existing one.

  2. Go to the Manage App Settings page.

  3. In the Visitor ID Service section, check Enable and select your organization from the drop-down list. Click Save.

    Увага!

    This organization must be the same as the one you use on the Adobe Campaign instance.

  4. Click Manage Postbacks.

  5. Create a postback.

    • Select PII as the Postback Type.

    • In the URL field, copy the Collect PII Endpoint URL from the mobile application that you configured in the Adobe Campaign interface, preceded by the server name. See Setting up a mobile app in Campaign.

    • Fill in the Post Body field as follows:

      For iOS:

      {
      "userKey": "{userKey}",
      "pushPlatform":"apns",
      "marketingCloudId":"{%mcid%}",
      "cusEmail":"{email}",
      "cusFirstName":"{firstName}",
      "cusLastName":"{lastName}"
      }
      

      For Android:

      {
      "userKey": "{userKey}",
      "pushPlatform":"gcm",
      "marketingCloudId":"{%mcid%}",
      "cusEmail":"{email}",
      "cusFirstName":"{firstName}",
      "cusLastName":"{lastName}"
      }
      
    • Set Content Type as application/json.

    • In the Which Data Tags Trigger the Postback?, select any event, typically Launched and exists.

    • Click Save & Activate.

  6. Create a second postback.

    • Select Postback as the Postback Type.

    • In the URL field, copy the Location Services Endpoint URL from the mobile application that you configured in the Adobe Campaign interface, preceded by the server name. See Setting up a mobile app in Campaign.

    • Fill in the Post Body field as follows:

      {
      "locationData":{
      "distances":"{a.loc.dist}",
      "poiLabel":"{a.loc.poi}",
      "latitude.a":"{a.loc.lat.a}",
      "latitude.b":"{a.loc.lat.b}",
      "latitude.c":"{a.loc.lat.c}",
      "longitude.a":"{a.loc.lon.a}",
      "longitude.b":"{a.loc.lon.b}",
      "longitude.c":"{a.loc.lon.c}",
      "appId":"{a.appid}",
      "marketingCloudId":"{mid}"
      }
      }
      
    • Set Content Type as application/json.

    • In the Which Data Tags Trigger the Postback?, select campaign.test and exists.

    • Click Save & Activate.

Примітка.

For detailed information on configuring postbacks, refer to the Adobe Mobile Services documentation.

Integrating the SDK into a mobile application

The Mobile core service’s software development kit (SDK) facilitates the integration of a mobile application into Adobe Campaign.

This step is described in the Administrating guide.

Defining Points of Interest in Adobe Mobile Services

To define the Points of Interest that are used to collect location data:

  1. Go to the Adobe Mobile Services interface.

  2. Add your application.

    For more information on managing applications in Mobile Services, refer to the Adobe Mobile Services documentation.

  3. Define the Points of Interest.

    For more information on managing Points of Interest, refer to the Adobe Mobile Services documentation.

Collecting subscribers' Points of interest data

A specific custom resource enables you to define the data that you want to collect from your applications' subscribers.

This step is described in the Administrating guide.

Accessing mobile apps used to collect location data

To access the successfully created applications in Adobe Campaign:

  1. Click the Adobe Campaign logo, in the top left corner.

  2. Select Administration > Channels > Mobile app.

  3. Select a mobile application from the list to display its properties.

    POI_mobile_app_subscribers

A list of the application's subscribers is also displayed. The subscribers are all of the users who have installed the application on their mobile device. The Adobe Campaign database profiles are identified with a registration token.

Accessing collected location data

Once the setup is done, the collected Points of Interest data is listed in the Places tab of each profile. To access the list:

  1. Select a profile.

  2. Click the Edit profile properties button on the right.

  3. Select the Places tab.

    POI_profile_places

The collected Points of Interest data for the current profile are listed. Location data are stored in the Adobe Campaign database for six months.

Related topics:

For more information on accessing and editing profiles, see Profiles.

Цей документ захищено ліцензією Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Публікації Twitter™ і Facebook не підпадають під умови ліцензії Creative Commons.

Юридична інформація   |   Політика мережевої конфіденційності