Manage event specifications

This article explains how to manage event specifications.

Event specifications can be added as custom events or added from the marketplace. Custom events can use any event name and any attribute requirements.

Add a Marketplace specification

The Event Specification Marketplace contains commonly used pre-built events. Once an event is added, the only change that can be made to a marketplace specification is the addition of attributes to the definition.

When adding an event specification from the marketplace, the original event name and attribute list cannot be changed.

To add a marketplace specification:

  1. Go to EventStream > Event Specs.
  2. Click Add Event Specification > Add From Marketplace.
    Add From Marketplace
  3. Click an event name to preview the specification.
  4. Click Select All or select one or more specifications by selecting the checkbox next to the event name.
    Choose Event Specifications and Click Finish
  5. Click Finish.
  6. Click Save and Publish to save and publish to your account.

Create a custom event specification

Custom specifications use a tealium_event value that you determine.

Once you create a custom event specification, the name of the event cannot be changed.

To add a custom event specification:

  1. In the sidebar, select EventStream > Event Specs.
  2. Click + Add Event Specification and select Add Custom Specification from the drop-down list.
  3. Enter the name of the event (value of tealium_event).
  4. Optional. In the Notes field, enter notes to describe the event, such as how the event is triggered and what the event is to accomplish.
  5. Click Add Label to apply labels.
    This step is optional.
  6. From the drop-down list, select an event attribute and mark the attribute as required or not required.
    • Click + Define New Attribute to create a new attribute for this specification.
    • Remove an attribute clicking the (-) button.
  7. You can add additional attributes by clicking + Add Attribute and then repeating Step 6.
  8. Click Finish.
    The following example shows a custom event specification named gallery_view.
    Gallery View
  9. Click Save and Publish to save and publish to your account.

Create an event specification from Live Events

Event specifications can be added directly from the event details view of Live Events. Live Events detect events that match a marketplace specification and provide a preview of the requirements to make it easy to add the specification without leaving the screen.

Events that are unknown can be defined as custom specifications directly from the event details view. The event attributes from the event will be pre-filled in the Add Event Specification modal.

Learn more about using Live Events.

Tealium Events Extension

For users of iQ Tag Management, use the Tealium Events extension to populate the tealium_event variable to match your event specifications.

Get the code

Creating event specifications is the first step in defining and standardizing your data layer. The second step is implementing the event tracking code on your platform of choice. While each platform has different code syntax, the event and attribute names implemented should be consistent across each of them.

Event specifications combine the event definitions with each of your data sources to provide a full installation guide, complete with the base code and examples for each specification. The resulting installation guide can be downloaded as a PDF and shared with your development team.

Use the following steps to get the code for your event specifications:

  1. Go to EventStream > EventSpecs.
  2. Click Get Code.
  3. From the drop-down menu, select a data source.
    The base code for the selected data source appears.
  4. Click Event Tracking Code to preview the sample code for each event specification.
  5. Click Download as PDF to generate a full installation guide for the selected data source.
    Event Tracking Code Tab
  6. Click Close.


Was this page helpful?

This page was last updated: January 7, 2023