Tealium

Integrating First-id with Tealium iQ (TMS) and Tealium AudienceStream (CDP) allows you to capture a persistent identifier and use it as a visitor attribute for cross-domain stitching.

Here is a quick technical guide to setting up this integration.

How can I do that ?

Global worflow

Tealium acts as the orchestrator. It picks up the First-id value from the browser and populates a Data Layer variable, which is then sent to the Tealium Collective Data Hub (AudienceStream).

• Source: First-id First-Party Cookie.
• Vector: Tealium iQ Tag Management.
• Destination: Tealium AudienceStream (Visitor Profile).

Step 1: Capture First-id in Tealium iQ

You need to make the First-id available in the Tealium Data Layer (utag_data).

Option A: Using the Cookie Variable (Simplest)

1. In Tealium iQ, go to the Data Layer tab.
2. Add a new Variable of type First-Party Cookie.
3. Set the Cookie ID (usually firstid, verify this in your browser console).
4. Name it cp.first_id.

Option B: Using a JavaScript Extension (Most Reliable)
To ensure the ID is captured even if it’s generated asynchronously:

1. Go to the Extensions tab.
2. Add a Javascript Code extension.
3. Scope it to “All Tags – After Load Rules”.
4. Use the following logic:

// Check if the First-id SDK is present and get the ID
if (window.firstid && typeof window.firstid.getFid === "function") {
    b['first_id'] = window.firstid.getFid();
}

a – create a Variable: Create a “1st Party Cookie” variable in GTM (usually named firstid or similar, depending on your setup).

b – Event Tag: In your Imagino Event tag, map this variable to a custom attribute named first_id

Step 2: Configure AudienceStream (CDP)

Once the variable is flowing from the website to Tealium, you must map it to a Visitor Attribute to enable stitching.

Create the Visitor Attribute

1. In AudienceStream, go to Attributes.
2. Add a new attribute: Visitor String.
3. Name it First-id.
4. Enrichment: Set this attribute to the value of the Data Layer variable first_id (captured in Step 1).

Enable Identity Stitching (The “Magic” Step)

1. In the settings of your First-id attribute, check the box: “Add to Visitor ID Service”.
2. By marking it as a Visitor ID, Tealium will automatically merge two separate profiles if they share the same First-id.

Step 3: Verification & Validation

1. Save & Publish to your QA environment.
2. Open your website and verify the firstid cookie exists in your Application tab.
3. Use the Tealium Trace tool:
   • Start a trace session.
   • Navigate your site.
   • Check the Visitor Profile in the Trace log.
   • Under Visitor ID Service, ensure First-id Identifier is populated and active.

⚠️ Consent: In the Tealium Consent Manager, ensure that the First-id cookie is mapped to the “Performance” or “Personalization” category so it only fires when the user accepts.

don’t hesitate to contact us directly if you have any more specific questions or consult the Tealium documentation.