GTM Helper Layer

Processing Involved in the GTM Helper Processing Layer

These processing operations are in addition to those described in the "Hosting Only" section, including cases where hosting is managed by a third party.

For the purposes of the service, the client instructs Sirdata to modify the headers of incoming HTTP requests to add additional parameters, specifically :

Header
Definition
Possible Values
Example
Default Activation

Gtm_config_id

sGTM Configuration ID at Sirdata

string

2hDUjf

Yes

Gtm-Helper-Consent

Generic Consent Signal. Sirdata attempts to infer choice signals from the various available information (Google Consent Mode signals, TCF TC String, etc.).

true/false/undefined

false

Yes

Gtm-Helper-Consent-Analytics

Consent Signal for Audience Measurement. Sirdata attempts to infer choice signals from the various available information (Google Consent Mode signals, TCF TC String, etc.).

true/false/undefined

false

Yes

Gtm-Helper-Consent-Basic-Ads

Consent Signal for Standard Advertising. Sirdata attempts to infer choice signals from the various available information (Google Consent Mode signals, TCF TC String, etc.).

true/false/undefined

false

Yes

Gtm-Helper-Consent-Basic-Content

Consent Signal for Standard Content. Sirdata attempts to infer choice signals from the various available information (Google Consent Mode signals, TCF TC String, etc.).

true/false/undefined

undefined

Yes

Gtm-Helper-Consent-Personalized-Ads

Consent Signal for Personalized Advertising. Sirdata attempts to infer choice signals from the various available information (Google Consent Mode signals, TCF TC String, etc.).

true/false/undefined

false

Yes

Gtm-Helper-Consent-Personalized-Content

Consent Signal for Personalized Content. Sirdata attempts to infer choice signals from the various available information (Google Consent Mode signals, TCF TC String, etc.).

true/false/undefined

undefined

Yes

Gtm-Helper-Gdpr-Applies

Indicates whether GDPR (or similar regulation requiring consent) applies to the user. Example: true for a user in France, false for Morocco. If false, consent headers are automatically set to true.

true/false/undefined

true

Yes

Gtm-Helper-Cookieless-Id-Cross-Domain

Universal Cookieless Identifier (enables cross-site tracking). If the option is not enabled, or no consent is detected, the value will be "undefined". If the user has not provided consent, the value will be "no-consent." Otherwise, the value will be a user identifier in UUID V4 format.

undefined/UUID V4

no-consent

No

Gtm-Helper-Cookieless-Id-Domain-Specific

Domain-Specific Cookieless Identifier (does not enable cross-site tracking).If the option is not enabled, or the user has objected, the value will be "undefined." Otherwise, the value will be a user identifier in UUID V4 format.

undefined/UUID V4

f577fc8e-065a-5e5f-6008-eacbc29c17de

No

Gtm-Helper-Device-Is-Mobile

Mobile Device Type (true/false)

true/false/undefined

false

Yes

Gtm-Helper-Device-User-Agent

Device User-Agent (Not pseudonymized if proxyfication is enabled; the User-Agent sent to GA4 is pseudonymized).

string

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36

Yes

Gtm-Helper-Optout

Opt-Out Signal for Processing. Sirdata infers the opt-out signal from the "gtm-helper-optout" cookie with a non-null value (e.g., "true", "1"). This cookie must be set on the host used for sGTM (e.g., "tag.example.com") or the domain preceded by a dot (e.g., ".example.com").

true/false/undefined

undefined

Yes

Gtm-Helper-Site-Domain

The Domain Originating the Request

string

example.com

Yes

Gtm-Helper-Site-Host

The Host Originating the Request

string

www.example.com

Yes

Gtm-Helper-Site-Origin

The Origin of the Request

string

Yes

Gtm-Helper-User-City

User's Connection City

string

Paris

Yes

Gtm-Helper-User-Country

User's Connection Country

ISO 3166-1 alpha-2 country code

FR

Yes

Gtm-Helper-User-First-Id

Identifier assigned to the user by First-ID. It is only available if the appropriate option is enabled in your account and consent for First-ID is detected. If the option is not enabled, or no consent is detected or no information is available, the value will be "undefined". If consent is detected and information exists, the value will be displayed as a string.

undefined/string

9440839b080a4aea8077d0d1e867fe14

No

Gtm-Helper-User-Hashed-Email

User's email address, hashed in SHA-256. It is only available if the appropriate enrichment option is enabled in your account and consent is detected. If the option is not enabled, or no consent is detected or no information is available, the value will be "undefined". If consent is detected and information exists, the value will be displayed as a string.

undefined/string (sha-256 hashed)

f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a

No

Gtm-Helper-User-Ip

User's Connection IP Address (Not truncated if proxyfication is enabled; the IP address sent to GA4 is truncated).

Adresse IP

1.1.1.1

Yes

Gtm-Helper-User-Isp

Internet Service Provider or VPN (Example: Apple's "Privacy Relay").

string

Free Pro SAS

Yes

Gtm-Helper-User-Region

User's Connection Region

ISO 3166-2 region code

IDF

Yes

Gtm-Helper-Cluster

sGTM cluster name (e.g., prod-eu, prod-us)

string

prod-eu

Yes

Gtm-Helper-Config-Id

GTM Server-side configuration ID

string

2hDUjf

Yes

Gtm-Helper-User-Has-Adblocker

true if an ad blocker is detected

true/false/undefined

false

Yes

Gtm-Helper-User-Connection

Connection type (cellular, wifi, ethernet)

string

wifi

Yes

Gtm-Helper-User-Type

Traffic category (human, bot, anonymized)

string

human

Yes

Gtm-Helper-User-Is-Bot

true if traffic is identified as bot

true/false/undefined

false

Yes

Gtm-Helper-Request-Has-User-Data

true if user data has been processed

true/false/undefined

true

Yes

Gtm-Helper-Server-Host

CDN server host

string

tag.example.com

Yes

Gtm-Helper-Server-Domain

CDN server domain

string

example.com

Yes

Gtm-Helper-Version

GTM Helper version

string

2.4.1

Yes

Conditional Headers

Header
Definition
Possible Values
Example
Default Activation

Gtm-Helper-User-Email

User email in clear text

string/undefined

No*

Gtm-Helper-User-Hashed-Email-For-Google

Google-formatted hashed email

string/undefined

f660ab912ec1...

No*

Gtm-Helper-User-Hashed-Phone

SHA-256 hashed phone number

string/undefined

a1b2c3d4e5f6...

No*

Gtm-Helper-User-First-Address

First address line

string/undefined

123 Example Street

No*

Gtm-Helper-User-Second-Address

Second address line

string/undefined

Apt 4B

No*

Gtm-Helper-Cdn-Ip

CDN IP address if different

IP Address/undefined

203.0.113.1

Yes**

Gtm-Helper-Dev-Info

Debug information

string/undefined

debug:v2.4.1

No***

*Enabled when HashedUserDataEnrich is enabled **Automatic when CDN IP ≠ user IP ***Development mode only

Mis à jour