DocumentationMobile SDKPlaces Service Guide

Use Places Service with Adobe Target places-target

Last update: Sun Apr 04 2021 00:00:00 GMT+0000 (Coordinated Universal Time)

This document assumes that you have the Places extension implemented in your application. If you need help implementing Places extension, see Places extensions.

After the Places extension is sending in events for entries and exits, you can leverage Rules in Launch to attach your Places Service data to your Adobe Target SDK events. With your desired property selected in Launch, you can create this type of rule by completing the following tasks:

1. Create a Rule

  1. On the Rules tab, click Create New Rule.

    Remember the following information:

    • If you do not have existing rules for this property, the button will be in the middle of the screen.
    • If your property has rules, the button will be in the top right of the screen.

2. Select an Event

  1. Give your rule a meaningful name so it will be easily recognizable in your list of Rules.

    In this example, the Rule is named Attach Places Service Data to Target Content Requested.

  2. Under the Events section, click Add.

  3. From the Extension drop-down list, select Adobe Target.

  4. From the Event Type drop-down list, select Content Requested.

  5. Click Keep Changes.

add an event

3. Add Conditions

IMPORTANT
Complete this step if you want to add Conditions to your rule. Otherwise, skip to the Define the Action below.

In the following example, a Condition is created that causes the Rule to trigger only for users who have launched the app five or more times.

  1. Under the Conditions section, click Add.
  2. From the Extension drop-down list, select Mobile Core.
  3. From the Condition Type drop-down list, select Launches.
  4. On the right pane, modify the drop-down list and number controls so that the condition reads User has launched the app greater than or equal to 5 times.
  5. Click Keep Changes.

add a condition

4. Define the Action

  1. Under the Actions section, click Add.
  2. From the Extension drop-down list, select Mobile Core.
  3. From the Action Type drop-down list, select Attach Data.
  4. On the right pane, in the JSON Payload field, type the data that will be added to this Event.
  5. Click Keep Changes.

On the right pane, you can add a freeform JSON payload that adds data to an SDK event before the extensions listening for this event hear it.

In the following example, poiCity and poiName values are added to the mboxparameters for each request that is processed in the Target event. The values for the new keys are determined dynamically by the SDK at the time this event processes.

TIP
This JSON payload uses a special notation for the request object. In the original event, request is an array of anonymous objects. When attaching data to all of objects in an array using Attach Data, the [*] notation on a key that is known to contain an array causes the payload to be applied to all objects in that array.
The notation of request[*] can be read out loud as for each object in the request array.

define the action

5. Save the Rule and rebuild your Property

After you complete your configuration, verify that your Rule looks like the following image:

completed rule

  1. Click Save
  2. Rebuild your Launch property and deploy it to the correct Environment.
recommendation-more-help
475fad96-f29f-4dca-a109-68bf0557e825