Events

Use event tracking to record user actions on a page, such as button taps, swipes, or other interactions that are not screen views. Each action is tied to the current page name and can carry custom event parameters.

Method

Build an action event

Use MIActionEvent with a name. Attach MIEventParameters for the action‑level data and any of the optional parameter objects (session, user, e‑commerce, campaign).

MIEventParameters

Examples

Simple action

let actionEvent = MIActionEvent(name: "AddToCart")
MappIntelligence.shared()?.trackAction(actionEvent)

MIActionEvent *actionEvent = [[MIActionEvent alloc] initWithName:@"AddToCart"];
[[MappIntelligence shared] trackAction:actionEvent];

Action with custom parameters

let actionEvent = MIActionEvent(name: "AddToCart")
actionEvent.eventParameters = MIEventParameters(dictionary: [
    1: "size-42",
    2: "color-black"
])
MappIntelligence.shared()?.trackAction(actionEvent)

MIActionEvent *actionEvent = [[MIActionEvent alloc] initWithName:@"AddToCart"];
actionEvent.eventParameters = [[MIEventParameters alloc] initWithDictionary:@{
    @1: @"size-42",
    @2: @"color-black"
}];
[[MappIntelligence shared] trackAction:actionEvent];

Event parameter numbers must match the custom event parameters configured in your Mapp Intelligence account.

Related: Object Oriented Tracking, Pages, Products and Orders.