About persistent cookie matching

Persistent cookie matching works with cookie matching tags in iQ Tag Management to request a third-party vendor user identifier.

How It Works

The third-party vendor sends an anonymous identifier back to Tealium to be associated to the visitor. That visitor data is then returned back to the website through data layer enrichment. This process allows events across multiple domains to be associated to the same visitor.

Here’s how it works:

  • In iQ Tag Management, a specific vendor cookie matching tag is added. When it runs in the page, it sends a request to the vendor asking for the visitor identifier and providing a return endpoint to which it can be sent.
  • The vendor then makes a request back to the Customer Data Hub with the requested identifier (cookie ID).
  • In the Customer Data Hub, the cookie matching request is received and the identifiers is saved to a Tealium third-party cookie.
  • In subsequent EventStream events collected, the third-party cookie values are made available as event attributes. This process continues until the cookie expires.

The Tealium Cookie Sync (TCS) cookie is valid for one (1) year, or when reaching the storage capacity of 4093 bytes.

As an example scenario, the interaction between a TiQ cookie matching tag and the vendor might translate into something like this:

  • Tealium Cookie Matching Tag:
    “Hi, I’m Tealium, can you give me the visitor ID so that I can later tell you who this person is and something about them in a way you will understand?”
  • Vendor:
    “Sure. Here you go, this is the Visitor ID.”
  • Tealium Cookie Matching Tag
    “Thanks. I’ll take the Visitor IDs you provided andpersist them in the Customer Data Hub. As useful data emerges, I’ll leverage the data to your benefit and return it to you to use as needed.”

Flow Diagram

The following diagram describes the flow of data between the Tealium Customer Data Hub and the customer website.

Cookie Sync Persistence Diagram_1.jpg
  • Standard Event Collection
    The Tealium Collect tag fires for actions that do not need cookie sync data.__ No third-party cookie sync data is attached at this point.
  • Cookie Matching Requests
    A cookie sync request is sent from the customer site to the vendor cookie matching service.
  • Cookie Match Response
    The cookie sync services sends a “302” redirect to the customer site.
  • Customer Data Hub Saves Cookie
    The cookie sync redirect received by the customer site is forwarded to the Customer Data Hub where the matched identifier is saved in the third-party Tealium cookie.
  • Tealium Third-Party Cookie Updated
    The Customer Data Hub redirect back to the customer site sets the third-party cookie containing the synced identifier from the vendor.
  • Event Collection with Persisted Cookies
    The customer site then sends Tealium Collect tag requests that contain the persisted cookie data.__ The collect tag waits for all (or a percentage or preset delay time) cookie sync tags to complete and then fires again with third-party cookie sync data to ensure that actions that rely on visitor identifiers can fire.__ Third-party cookie sync data is attached at this point.
  • EventStream Actions
    In the final step, EventStream events now contain the persisted vendor identifiers as event attributes, which are then available to be mapped in connector actions.

Supported Marketplace Tags

The following table lists the callback method and callback formatting for Tealium marketplace tags that support the persistent cookie matching service:

Callback Method Callback formatting Tag Name
Calls Visitor Data Uses a callback to make the vdata call.
Calls Visitor Data Formatted (url+vdata+query-params)
Does not call vdata Copies an ID from one cookie to another

Use the following steps to add a cookie matching tag:

  1. Log into iQ Tag Management (TiQ).
  2. In the left sidebar, go to the iQ Tag Managment > Tags.
  3. Click + Add Tag.
  4. In the left panel, click Cookie Match.
    A list of available marketplace tags supporting the cookie matching service displays.
    TiQ_Add Tag_Sort by Cookie Match.jpg
  5. Click + Add next to the tag you want to add.
  6. Follow the onscreen instructions to configure your tag.
  7. Save and publish your changes.

How do I update my tag to get the latest functionality?

To verify that your tag is the latest version and contains the latest functionality, click on the tag and view the Tool Tips section in the left navigation panel. The Tips section will contain a notification if a newer version of the tag is available and instruct you to disable the current version and add the new tag from the tag marketplace.

Learn more about adding and configuring tags from the tag marketplace.

Was this page helpful?

This page was last updated: January 7, 2023