netID Implementation Guide
This article describes how to implement netID as a Tealium Identity Partner.
First-party data, such as a netID, is crucial for accurate retargeting and personalization. The Tealium real-time first-party data platform helps activate these identifiers across channels, enhancing the effectiveness of advertising campaigns.
Prerequisites
- A request to the netID browser-based JavaScript API
- Tealium EventStream or AudienceStream
How it works
When integrating netID’s Single Sign-On (SSO) and consent management solutions, netID partners must implement a request to the netID browser-based JavaScript API. The properties returned from the API must be persisted in the browser session as first-party cookies, in localStorage
, or in sessionStorage
.
NetID properties like tpid
can be used with client-side tags in Tealium iQ to integrate with advertising technologies on your webpage.
Additionally, the same netID properties are collected by the Tealium Collect tag and made available as attributes in EventStream and AudienceStream. With netID saved as a visitor attribute, the visitor profiles can then be activated through real-time connectors to advertising vendors.
For more information about the netID browser-based JavaScript API, see the following:
Tealium iQ
netID properties that have been stored in the browser can be fetched as part of the data layer (UDO object). This data can then be used in Tealium iQ load rules and tag data mappings where relevant.
For example, if you’ve persisted the netID tpid
parameter in a first-party cookie, add a new variable of type First-Party Cookie in the data layer, and set the value for Source to the cookie’s name (for example, netid_tpid
).
As a netID partner, use one of the following methods to include netID’s properties as key-value pairs in the Tealium Data Layer:
-
First-Party-Cookie: Persist the netID
tpid
as a first-party-cookie namednetid_tpid
in the browser, and it will appear in the data layer with thecp.
prefix alongside Tealium standard cookies:{ ..., "cp.netid_tpid": "Bst040QDNr1nB9JM6sWH0I9__70JEvRyIiKvvd7G0MQLQ", ... }
-
Universal Data Object (UDO): Use a UDO variable to explicitly persist the netID property in
utag_data
. For example, add the netID identity property asnetid_tpid
to the UDO of your pages:<script type="text/javascript"> var utag_data={ "tealium_event" : "page_view", "page_name" : "product_page", "product_id" : "423543", "netid_tpid" : "12345" }; </script>
-
Track an event: Use
utag.link()
to track a successful netID authentication and response from the browser-based JavaScript API, and include the netIDtpid
asnetid_tpid
in the payload:utag.link({ "tealium_event" : "netid_login", "netid_tpid" : "12345", ... });
EventStream API
After the Tealium Collect Tag captures netID properties from the browser’s data layer, this data is processed as event attributes.
To do this, create an event attribute to capture the netid_tpid
value. In the following example, the attribute is set to the value of the first-party cookie:
netID’s identifier (tpid
) can be activated as a first-party (Advertiser) ID to an advertising platform using their connector, such as:
Example
If you use Adform, map the netid_tpid
event attribute to Adform’s First-Party ID attribute:
AudienceStream CDP
This data is processed as event attributes and can be stored as visitor attributes on the real-time visitor profile.
To do this, set a visitor string attribute on the visitor profile to the netid_tpid
event attribute value. In the following example, the attribute is set to the value of the first-party cookie:
The visitor ID can then be used to create audiences for visitors using netID as their authentication method.
For real-time activation to advertising platforms such as Adform and The Trade Desk, use their Tealium connectors:
References
This page was last updated: December 12, 2024