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:
On the Rules tab, click Create New Rule.
Remember the following information:
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.
Under the Events section, click Add.
From the Extension drop-down list, select Adobe Target.
From the Event Type drop-down list, select Content Requested.
Click Keep Changes.
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.
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.
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.
After you complete your configuration, verify that your Rule looks like the following image: