Event Management

The Upshot.ai iOS SDK provides comprehensive event tracking capabilities to monitor user interactions and app usage.

What is an Event?

Any action performed by the user in the application that is of interest for analytics and improving the app/user experience is an event. Every time such an action occurs, the details of this action are recorded in Upshot.ai as an event.

Examples of Events

• Any button tap
• User making an in-app purchase
• User visiting any particular screen, like "settings"

Dispatch Frequency

Events are dispatched to the server within a time interval of 10secs to 120secs. You can choose the frequency at which events should be dispatched. By default, events are dispatched to the server once in every 60 secs.

How to set dispatch interval?

Objective-C

// Set dispatch interval (in seconds)
[[Brandkinesis sharedUpshot] setDispatchInterval:30]; // 30 seconds

Swift

// Set dispatch interval (in seconds)
BrandKinesis.sharedInstance().dispatchInterval = 30 // 30 seconds

Dispatch / Flush Events

DispatchEventsWithTimedEvents method allows you to flush all events from your app to the Upshot.ai server immediately. You can use this method for any particular action in your application.

• dispatchEventsWithTimedEvents:YES: Sending all closed and non-closed events to server
• dispatchEventsWithTimedEvents:NO: Sending all closed events to server

How to flush events?

Objective-C

// Flush all events immediately
[[BrandKinesis sharedInstance] dispatchEventsWithTimedEvents:YES completionBlock:^(BOOL dispatched) {
}];

Swift

// Flush all events immediately
BrandKinesis.sharedInstance().dispatchEvents(withTimedEvents: true) { status in
}

Event Types

1. PageView Events - Track screen views and navigation
2. Custom Events - Track specific user interactions
3. Attribution Events - Track campaign and attribution data
4. Session Events - Track app sessions and user engagement

Getting Started

To start tracking events, ensure you have:

1. Installed the SDK
2. Initialized the SDK
3. Configured event tracking in your application

Best Practices

• Track meaningful events that provide actionable insights
• Use consistent naming conventions for events
• Include relevant properties with each event
• Validate events in development environment
• Monitor event data quality regularly
• Close timed events properly to ensure data integrity

Validation

You can validate PageView and Custom events in the Dashboard Live Events section to ensure your events are being captured correctly.