Sentinel Insights Tag Setup Guide
This article describes how to set up the Sentinel Insights tag.
Deploy the Sentinel Insights observer to detect tracking issues, data-layer anomalies, broken pixels, and consent-flow problems in real time across your marketing technology stack.
Tag tips
-
Sentinel Insights passively observes other tags, the data layer, and the consent flow. It must run first in load order to monitor everything else. Enable the Prioritized advanced setting on this tag.
-
For full pre-
utag.jscoverage, copy the Sentinel loader stub from your account team into yourutag.sync.jstemplate via the iQ UI in addition to deploying this tag. The in-tag deployment captures everything fromutag.jsload onward. -
Obtain your Environment ID from your Sentinel Insights account team. For multi-environment setups, configure Environment ID (Dev / Test) as well and override per fire using the
env_idmapping destination, a Lookup Table, or per-environment load rules. -
Use the Configuration tab to override
env_idorcustom_page_nameper fire, for example in multi-brand profiles. -
Consent Logic is a JavaScript function body that the SDK calls to read the current consent state. The function receives one argument (
utils) that exposesutils.getCookie(name), which readsdocument.cookieand returns the URL-decoded value, or an empty string if the cookie does not exist. Your snippet must return a string that Sentinel uses as the consent signal. Avoid embedding credentials in this field, because the tag configuration ships in the customer’sutag.js.var val = utils.getCookie('consent_status'); return val === 'granted' || val === 'accepted' ? 'granted' : 'denied'; -
Use the Cookie Consent tab to map a data layer variable to
grantorrevoke. The tag then signals a consent update to Sentinel, which re-reads the Consent Logic function for the new state. -
Trigger toggles control which Sentinel events fire: Data Layer Updates (default on), SPA Page Changes, and Resume Load. Pair the SPA toggles with customer-side extensions that fire
spa_page_changeorspa_resumeTealium events. -
This tag is exempt from the standard Tealium GDPR consent gate. Sentinel Insights observes consent state rather than relying on it. The Consent Logic function is the consent integration point.
-
CSP requirements: allow
script-src https://config.datas3ntinel.comandconnect-src https://collect.datas3ntinel.com.
Tag configuration
Go to the tag marketplace to add a new tag. For more information, see About tags.
When adding the tag, configure the following settings:
- Environment ID (Production): Required Sentinel Insights environment identifier for production traffic. Must be a UUID (format: 8-4-4-4-12 hex).
- Environment ID (Dev / Test): Optional non-production environment identifier. Override using load rules, a Lookup Table, or a per-fire
env_idmapping. - Consent Logic (Function Body): JavaScript function body the SDK calls to determine consent state. See tag tips for usage details.
- Delay Start: When
True, the SDK initializes but defers monitoring until an explicit resume event. Use for SPA flows that require controlled activation. - Auto Page View Tracking: When
True, the tag sends a page-view event automatically on initial load. - Custom Page Name (SPA): Optional fallback name used by SPA Page Change events when the URL does not change.
- Trigger: Data Layer Updates: When
True, forwards data-layer payloads on every view, link, and custom event. Default on. - Trigger: SPA Page Changes: When
True, fires a Sentinel pageView event when the tag receives a Tealium event namedspa_page_change. - Trigger: Resume Load (SPA): When
True, fires a Sentinel resume event when the tag receives a Tealium event namedspa_resume. Use with Delay Start set toTrue.
Load rules
Load the tag on all pages or set conditions for when your tag will load. For more information, see About load rules.
Data mappings
Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For more information, see About data mappings.
The available categories are:
Configuration
| Variable | Type | Description |
|---|---|---|
env_id |
String | Environment ID |
custom_page_name |
String | Custom page name |
This page was last updated: June 3, 2026