Tracking ID

A Coveo organization can serve many ecommerce sites or applications. It’s important to segregate the data gathered from each of these sites or applications to ensure personalized and relevant outputs from your Coveo Machine Learning models, as well as usable reporting, and clear merchandising actions.

A tracking ID is a unique identifier used to differentiate and categorize Coveo Usage Analytics (Coveo UA) data by site or app. Similar to the organization ID which identifies the organization itself, the tracking ID points to sections within the digital experience, creating a way to bucket events belonging to different user experiences.


The trackingId parameter can only contain letters, numbers, hyphens (-), underscores (_), and periods (.). For example, barca_sports_us-2.1.

In a user journey, all events should be tied together for consistency and for accurate data analytics. The tracking ID is therefore the common thread that connects all user actions within a single experience, facilitating the process of analyzing the data including user behavior and preferences.


Your Coveo organization powers two brands: Barca sports and Barca parts. You operate in two different countries: United States and Canada.

Therefore, you have four different sites that require their own unique tracking ID:

  • barca_sports_us

  • barca_sports_ca

  • barca_parts_us

  • barca_parts_ca


A single user journey can’t span multiple tracking IDs, and UA data is segregated by tracking ID. Therefore when you analyze metrics like views, clicks, or conversions, the Advanced Reports will show them for each tracking ID.

Additionally, the tracking ID shouldn’t be confused with other factors such as the site’s domain, locale, or catalog ID.

Single vs. multiple tracking IDs

One tracking ID can span across various locales and/or top-level domains, while multiple tracking IDs can be used for a single top-level domain.

  • Your website includes translated pages where each one contains the same core content. Each page is assigned the same tracking ID since the context remains the same regardless of language.

  • You have separate web properties that cater to North American and Asian audiences. Each property is therefore assigned its own tracking ID since the content differs from one property to another.

When deciding between using single or multiple tracking IDs, you must consider the following:

  • An ecommerce ordering and checkout process can’t span more than one tracking ID, because it represents a single journey.

  • A service episode can’t span more than one tracking ID, because it represents a single journey even though it may cross different top-level domains.

Leading practice

We recommend using different tracking IDs in the following scenarios:

  • Your web properties have different branding, different domains, and no cross-navigation.

  • Your web properties have the same top-level domain, but their individual audience, indexed content, and visitor behavior, are quite different, meaning there’s no cross-navigation in a single journey.

  • You want to explicitly separate reporting between properties.

    For example, the following sites and could have two different tracking IDs and treated as separate sites with segregated reporting. Alternatively, they could be considered as a single site, using the same tracking ID for unified reporting. This choice is dependent on the desired setup and the similarity in underlying content.