How can I have an opened push message trigger an in-app message?

You might want a user who opens a push message to receive an in-app message upon arriving in the app. This push-to-inapp sequence is possible with Localytics. To execute this, follow the steps below:

1. Set up the push campaign. In the creatives page of campaign creation expand the advanced tab by clicking on the slider next to "Advanced." If using Android SDK version 4.2 or lower, also insert a key/value pair, with a unique key (in our example we will use "Localytics-Push-Campaign-ID-Key") and the value as the campaign ID of the push campaign you are creating.

2. Create an in-app campaign. The in-app campaign Audience should be set to Everyone. You will set the display trigger such that the message will only display to users that open a particular push message.

3. Setup the in-app campaign trigger. The in-app trigger should be set to the Event called Localytics Push Opened. Then you should add a filter and select the Campaign Name attribute. You should then select the name of the Push Campaign, if available. If the push campaign has not yet gone live, you won't see this as an option but fortunately, there is an easy workaround. You will need to manually enter the campaign ID for the push campaign (not the campaign name). To find the campaign ID, navigate to the push campaign of interest, look at the URL and note the numeric identifier. Type this campaign ID into the Campaign Name field. For example, in https://dashboard.localytics.com/interact?org_id=152#/campaign/amp/18115?days=31&offset=446, the campaign ID is 18115. (Note: The reason why you paste Campaign ID rather than Campaign Name is that for convenience we let users select Campaign Name then do a lookup in the background for Campaign ID). Please note to only enter the numbers for the campaign ID and no other characters like "#" as entering any other characters in the text field can cause the campaign to not run properly.

4. First, go live with the in-app campaign. It can be beneficial to go live with the in-app campaign well in advance of the push campaign so that the in-app creative has the chance to silently transmit to end-users' devices to be rendered later, once the triggering event occurs. If you don't provide lead time, the creative will need to both transmit to the device and render almost simultaneously, so if the creative is large or end-users' connections are slow the message may not have the chance to render immediately.

5. If you are using Android SDK 4.2 or lower, you will need to do a one time setup of adding a bit of code to ensure the display of the in-app. In all Localytics integrated Activity classes include the following in the onResume() method (if this activity uses manual session management, ensure that this code is included after Localytics.setInAppMessageDisplayActivity(this):

Bundle extras = getIntent().getExtras();
if (extras != null) {
    String campaignId = extras.get("Localytics-Push-Campaign-ID-Key");
    if (campaignId != null) {
        Map<String, String> attributes = new HashMap<String, String>();
        attributes.put("Campaign ID", campaignId);
        Localytics.triggerInAppMessage("Localytics Push Opened", attributes)
        extras.remove("Localytics-Push-Campaign-ID-Key");
    }
}

Finally, make sure to go live with the push campaign and that's it. Only users that open the push message will receive the in-app message.