Events

The new "Events" feature has been released in Mobile Messaging SDK version 6.1.0. Events are an integration point for our "Moments" engagement platform. They allow you to track arbitrary user actions and collect arbitrary contextual information represented by event key-value properties. The event data collected on our servers might be later used to:

• build segments of recipients for the Flow message campaigns;
• get insights about user behaviour.

Find more info on Infobip docs.

Standard events

Standard events are enabled for all the Moments users who have Mobile SDK implemented in their mobile app, and you don’t need to perform any additional actions to be able to track them. List of standard events:

1. Personalize
2. Depersonalize
3. Install
4. Uninstall
5. App Launch

Custom events

Custom events are those that you have defined yourself and want to track via Mobile SDK.

Create event definition

The Event needs to be first defined on the Portal. Once defined on Portal side, it can be accepted by Mobile Messaging SDK integrated within your mobile app.

Submit event

According to this event definition, the resulting event can be initialized within your app as follows:

let props = [
    "itemCode"      : "I-001" as NSString,
    "amount"        : 1500.5 as NSNumber,
    "purchaseDate"  : NSDate(),
    "isPremiumUser" : true as NSNumber
]
let event = MMCustomEvent(definitionId: "EventExample", properties: props)

expand to see Objective-C code

NSDictionary * props = @{
	@"itemCode"      : @"I-001",
	@"amount"        : @1500.5,
	@"purchaseDate"  : [NSDate date],
	@"isPremiumUser" : @YES
};
MMCustomEvent * event = [[MMCustomEvent alloc] initWithDefinitionId:@"EventExample" properties: props];
[MobileMessaging submitEvent:event];

In order to send the event to the server, you have two options to choose from:

1. Using submitEvent API with a callback argument in case you need to immediately send an event to the server:

   MobileMessaging.submitEvent(event, completion: { error in
       < handle error if not nil >
   })

   expand to see Objective-C code

   [MobileMessaging submitEvent:event completion:^(NSError * _Nullable error) {
       if (error != nil) {
           //< handle error if not nil >
       }
   }];

   in this case you have to handle possible connection or server errors, do retries yourself.

2. Using submitEvent API without the callback argument:

   MobileMessaging.submitEvent(event)

   expand to see Objective-C code

   [MobileMessaging submitEvent:event];

   in this case the Mobile Messaging SDK will eventually send the event to the server, it will also handle possible errors and do retries for you.

After the successful submission, the new event will appear in the Person screen, under the Events tab:

Notice

Please note the "App Launch" and "Install" events on the screenshot above - these events are not custom ones but our internal standard events, the Mobile Messaging SDK submits them automatically for you. Full list of standard events is: "App Launch", "Install", "Uninstall", "Personalize", "Depersonalize".