Integrating with the Medio Platform is easy but it helps to know a few basics. Here are some concepts to keep in mind.


An event is any activity in your application that you want to log. Each event has a type that is a short, descriptive string of your choice. For example, you may want to log an event of type ‘buttonClick’ each time a user clicks on a button.

Event key-value pairs

You can use key-value pairs to provide contextual information for each event that you log in your application. For example, if your application allows users to save their favorite articles, you may want to log an event of type ‘addFavorite’ along with ‘articleId=12345′ as a key-value pair to indicate that the user saved article 12345 to her list of favorites.

User sessions

The SDKs automatically group your application’s events into sessions. A session is generally defined as a time period in which a user is actively engaged with your application. For example, your application can open a session when the user starts the application and close the session when the user exits. Aggregate metrics about your users’ sessions are available to you in the Medio Platform dashboard.

Tracking unique users

You can automatically track unique users of your application using the SDKs. When your application runs on a user’s device for the first time, the SDK will generate an anonymous ID for the user and then log it with each event. The anonymous ID remains the same across all of that user’s interaction with your application. Aggregate metrics about unique users are available to you in the Medio Platform dashboard.

Capturing user location

The SDKs allow you to automatically capture a user’s geographical location with all of your events. This capability is disabled by default. When enabled, the SDKs will periodically obtain approximate latitude and longitude coordinates from the user’s device and send them with each event.