iOS Realtime Events & In-App Messages

In App Messages are triggered based on realtime In-App events. You have to tag these events in your App when integrating. To read about how In App Message campaigns are created on the platform checkout the In App Messaging docs. Real-time events can also be used for triggering other comms like push notifications, email and SMS.

Session Start

There is a default event for tracking Session Starts or App open events. This is the most basic type of In App Messaging to enable. To enable In App messaging on app open; call the following method, before initialising XtremePush in your App Delegate.

[XPush setInAppMessageEnabled: YES];

You can then select the trigger On Session Start Option when creating an In App Message. 

Custom Events

If you want your In App messages to appear after custom events occur then you must tag these events with the hitEventmethod. For example if the settings page being opened was an event you want to track for In App messages, you would tag it as follows:

\\ Tagging opened_settings in code where settings is opened
[XPush hitEvent: @"opened_settings"];

The "opened_settings" event will then be available as a trigger option when creating an In App Message.

And below you can see an example of a bottom banner In App message that appears after the settings page was opened.

Events Values

It's possible to pass a value with the event hit. It could be used for additional segmentation and personalization of your messages.

To pass a string value with the event use:

[XPush hitEvent: @"test" withValue: @"payload"];

To pass key-value pairs with the event use:

[XPush hitEvent: @"test" withValues: @{@"foo": @"bar", @"lorem": @"ipsum"}];