Live Events and Feeds are used to manage and inspect incoming data. This article shows how to inspect incoming event data, create and manage feeds, and evaluate data quality.
This article covers the following topics:
Access Live Events by navigating to EventStream > Live Events.
You control which events are displayed in the chart using the Data Sources and Event Feeds drop-down menus. The default selections are "All Data Sources" and "All Events". Adjusting these menus refreshes the chart and displays the event activity for the selected combination.
If you select a specific event for Event Feed, Live Events displays data for that event only. To compare an event feed to all event data, click Compare against All Events. For example, you can create event feeds for specific countries or regions, then compare a country or region event feed to all events.
Use a Trace ID to filter out all incoming events except for the ones you trigger. A Trace ID is a temporary, unique identifier to be inserted into your event tracking code (or the Trace Tool) so that only specific events are displayed in Live Events. This is commonly used for testing purposes.
To set up a trace:
If you have event specifications defined, Live Events displays the quality of your incoming data. Each bar in the chart is segmented according to the status of the event specifications applied. The following filters can be toggled on or off to adjust the display of the chart:
tealium_eventattribute and all the required attributes from the specification. The more valid events you see the better. This means your installations are sending the data expected in your specifications.
tealium_eventattribute, but they are either missing required attributes or the attributes contain unexpected values. These issues can be resolved by fixing the installation code that is sending the events or, in some cases, adjusting the event specification.
tealium_eventattribute or the value does not have a corresponding event specification.
Click a bar in the chart to view the event details from an incoming data sample. The data sample is limited to 10 events per bar in the chart. Events are primarily identified by the
tealium_event attribute. The detected value of this attribute is displayed in the heading of the event detail. If
tealium_event has a corresponding event specification, the event is displayed as either valid or invalid according to the requirements in the specification. The heading also displays the data source from which the event originated.
An unknown attribute is an attribute detected in the incoming event that has not yet been created in your account as an event attribute with a data type (eg. string, number, Boolean, etc.). Before you can use an attribute in your account, it must be created as an event attribute.
In the event details view, unknown attributes are indicated in the Data Type column as "Unknown".
Unknown attributes can be defined directly from this screen by using the Quick Add action, as follows:
A standard set of built-in event specifications are available to be added to your configuration. If an incoming event matches a built-in event specification that has not yet been activated, you can preview and activate the event from the event detail view.
To preview and activate a matching built-in specification:
Events with a custom value for
tealium_event display as "Unknown" in the event details view if they do not have an associated event specification. When this occurs, you can create a custom event specification directly from the event details view based on the detected value of
tealium_event and the attributes of the event.
To create a custom event specification for an unknown event: