Activate Events


With the Conviva ECO sensor module scripts installed, Conviva provides access to dashboards and features that visualize the events auto-collected by the sensor and enables event management so you can quickly get started mapping additional events for your own specific event-based experience-centric analysis.

In this context, an event is a record related to a discrete user action or application behavior, such as a user clicking a button or a web page loading. Event mappings are composed of initial and follow-up events that together define metrics in ECO dashboards. Mettrics can be conversion type metrics that measure the percent of actions completed in an event sequence and interval type metrics that measure the time to complete the events tied to a task.

Note: For each use case, it's recommended to have an inventory mapping of UX elements to the associated keys and values, such as related text tags, associated events, and class values. This inventory will help guide the selection of events, tag keys, and tag values for the mapped events that form the building blocks of your experience-centric analysis.

  • Conversion Metric Example: Cart to Purchase Completion Rate

    • initial event: Add To Cart Event

    • follow-up event: Payment Success

  • Interval Metric Example: Login Process Time

    • initial event: Login Submit Button click

    • follow-up event: View site page

Event mappings align events with the specific tag keys that identify the defined related behavior, such as a button_click event mapped to a login tag value that can be deployed as part of the login duration metric.

For example, to get starting measuring the user login action, open the Activation option and in Semantic Mapper select conviva_button_click as the event name and set the tag value to login. This equates the button click action that is associated with the login tag to the mapped event named Click Login Button.


To track when login is complete, a follow-up event can be mapped to define the completion based on an API response token or network request receipt.

Repeat this process of mapping events with tag keys and values to specify your event building blocks for experience-centric metrics.

For more details, see Semantic Mapper.

Out-of-Box Events

Check the auto-ingested events and minimum player versions for details about auto-collected event support.

Activating Data Steps

ECO data activation enables you to map new events and create metrics to efficiently explore and manage the current application events for enhanced insights and do data analysis for more complex scenarios.

Mapping New Event

  • Map events as ECO trend drill-down entities to enable deeper analysis using dimensional drill-down.

  • Map events to create customized metrics.

Perform These Tasks: View Image:
  1. Click Map New Event on the Activation page from ECO.

  2. Specify the event name along with the tag key and tag value that consist of the mapped event.

  3. Select a suitable category, type the event name in the Set Mapped Event field, and then click Save.

  4. Click Deploy from the top right corner.

Learn more: Map New Event


Setting Collection Rules for Network Requests

Set collection rules for conviva_network_request events. When the rules are configured, the Conviva sensor will collect events that match these rules. You can then select the collected events as raw data for mapping if necessary.

Perform These Tasks: View Image:
  1. To begin creating rules, click Add New.

  2. To set rules, fill out the fields in the right pane.

  3. Click Save. The Conviva sensor will collect the conviva_network_request events that match the rules.

Learn more: Configure Network Request


Next Step: Build Experience Metrics