Events

You can use AppMetrica to collect statistics on your custom app events and view the statistics in the Events report in the web interface. For more information, see Sending events on Android and on iOS.

  1. Event nesting levels
  2. Interpretation of numeric and string values
  3. Partially matched nested events

Event nesting levels

To send a multi-level event, pass a key:value pair. In the interface, key and value are considered nesting levels.

The AppMetrica web interface displays up to five nesting levels for events. So if an event has six or more levels, only the top five are shown in the report.
Note. You can use the Reporting API to get up to ten event nesting levels.

Interpretation of numeric and string values

In the AppMetrica interface, the values {"count": 3} and {"count": "3"} are interpreted the same way. However, when exporting data using the Reporting API or Logs API, a parameter will be exported in the same form as it was sent to the server.

If the same event is passed multiple times with different numeric parameter values, the parameter values are not summed up in the web interface. Each of them is recorded and calculated separately.

Note. You can use the Reporting API to export additional fields: the total and average of all numeric values.

Partially matched nested events

If the server receives events with duplicate parameters but different nesting levels, their values are added together based on duplicate parameters.

For example, the first event has two nesting levels:

{ 
    "param1": "param2"
}

The second one has three nesting levels:

{
    "param1": {
        "param2": "value"
    }
}

In the web interface, these events are displayed as a tree view:

The events are counted using the following algorithm:

  1. The event is recorded, along with two of its sublevels. This adds 1 to each parameter.
  2. We add 1 to the event name and its three sublevels.