Show Menu
TOPICS×

In-App notifications (#places-push-messaging)

The following information shows you how to configure In-App messages to trigger from Places events.
The messages must be on an Analytics hit.

In-app message

Mobile Services allows you to use location data that is being sent to Analytics as the trigger event(s) and/or condition for an in-app message. If In-App messages are fired from the SDK and do not need to wait for data to be processed by Analytics, the messages can appear in real time as soon as the trigger occurs.

Local notifications

Here is a list of the available In-app messaging types:
  • Full screen
  • Alert
  • Local notifications
These types are in-app messages because they are triggered by the SDK. Local notifications look and feel like push notifications because they appear when the app is in the background. These notifications also deliver real-time notifications as users enter or exit your POIs while the app is in the background. For more information see Places Monitor extension .

Prerequisites

Before you begin, you understand how to send and create an in-app message in Mobile Services and how triggers work. For more information, see Create an in-app message.

Rules in Experience Platform Launch

You can create Launch rules that send the data that you want to be able to use as part of your in-app message Trigger rules to Analytics. You can use data from the Places extensions in your Launch rules as either events and/or conditions depending on your use case.
  • Using location data as the triggering event.
    For example, you can send data to Analytics when a user enters a POI.
  • Using location data as a Condition to a triggering event.
    For example, if you created a custom metadata tag in the Location Service for the weather at different POIs, you can use that metadata as a parameter for your Rule condition. While you can use this condition with a POI entry event described earlier, you can also use the condition as context to any event.
After the rule is set up with the proper event and condition parameters, complete your rule configuration by configuring the action to send data to Analytics.

Create an action

To create an action:
  1. Select the Adobe Analytics extension.
  2. In the Action type drop-down list, select Track.
  3. Type a name for your action.
  4. In the right pane, in Context Data , select the key-value pair to set the context data that will be sent to Analytics.
For example, you can select poiname as the key and {%%Last Entered POI Name} as the value.
Analytics Processing Rules can be set to pick up this context data. For more information, see Processing Rules . In the example in Create an action , the Action will send the poiname as the context to describe the POI entry event that is being sent to Analytics.
Here is an example of the complete rule:

Creating an in-app message in Mobile Services

As part of your Trigger parameters, you can create the audience for the message with data from the Location Service in one of the following ways:
  • Using location-specific actions such as an entry or an exit.
  • Using POI metadata that is sent as context data to narrow the target of your audience.
    This option can be used with a location-specific action, such as entry, or it can be used as context to another event such as a launch or a button click.
    Here is an example of how to configure an in-app message to welcome users who enter a POI that has Adobe in the name:
  • Parameters in the Places headings in the Triggers and Traits page in Mobile Services do not work with data from the Location Service.
    Those parameters are only for the legacy Places database that was created in Mobile Services.