With the Places extension and a region monitoring solution installed in your mobile application, you can create rules in Adobe Experience Platform Launch that are triggered or conditioned location data including location entry and exit events.
You can configure a rule, which is composed of an event, a condition, and an action. Each rule is composed of the following:
Places Service offers the following events on which you can run a rule:
Conditions define the criteria that the data associated with the event, or the shared state of an extension at that instance, must meet for the action to be taken. For example, you can set a condition to trigger an action on an entry to a coffee shop only in the city of San Francisco.
The Places SDK maintains the following states:
Each POI contains the following data elements:
Actions define what the app will do in response to the condition for the rule is met for the fired event. For example, when your customer enters your POI, you can configure a welcome message to display on their mobile device.
This example assumes that you have created a POI library of all coffee shops in the United States. For more information about creating POIs and libraries, see Create a POI and Create a Library in Manage multiple libraries.
The following procedure is an example of how to create a rule that sends a post back to Slack when you enter a coffee shop in San Francisco.
The event, condition, and action are defined in the following ways:
Before you create a rule, you must create a data element in Adobe Experience Platform Launch. Data elements automatically populate the necessary information about your POI in the postback message.
To create a data element in Experience Platform Launch:
In the Actions section, click + Add.
In the Extension drop-down list, leave the default Mobile Core option selected.
Select an action type, for example, Send Postback.
a. In URL, type the postback URL for Slack, for example, https://hooks.slack.com/services/
.
b. To send a post body, select the Add Post Body check box.
c. In Post Body, add the post body, for example: { "text": "A customer has entered" }
c. Type a content type for example application/json.
d. Select a timeout value, for example, 5.
Click Keep Changes.
Using Places Service geo-fence entries and exits to trigger rules in Experience Platform Launch is incredibly powerful, but you can also use location data as a condition for other events to fire. For example, you could have a Mobile Core Track Action event trigger ready to fire based on a particular trackAction call event inside your app. Based on this event, you can place additional location conditions to the event before an action is performed. For example, open up an in-app survey when a purchase trackAction
event occurs, but only if the user’s current location includes specific Places Service metadata.