> For the complete documentation index, see [llms.txt](https://server-side.docs.sirdata.net/sirdata-server-side/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://server-side.docs.sirdata.net/sirdata-server-side/traitement-des-donnees/surcouche-gtm-helper.md).

# Surcouche GTM Helper

Ces traitements sont additionnels à ceux décrits à la section [Hébergement seul](/sirdata-server-side/traitement-des-donnees/hebergement-seul.md), y compris dans le cas d'un hébergement confié à un tiers.

Pour les besoins du service, le client instruit à Sirdata de modifier les en-têtes des Requêtes HTTP entrantes, pour ajouter des paramètres supplémentaires, en particulier :

<table data-header-hidden><thead><tr><th width="159"></th><th width="265"></th><th width="115"></th><th width="111"></th><th></th></tr></thead><tbody><tr><td>En-tête</td><td>Définition</td><td>Valeurs possibles</td><td>Exemple</td><td>Activation par défaut</td></tr><tr><td>Gtm_config_id</td><td>Id de la configuration sGTM chez Sirdata</td><td>string</td><td>2hDUjf</td><td>Oui</td></tr><tr><td>Gtm-Helper-Consent</td><td>Signal de consentement générique. Sirdata tente de déduire les signaux de choix depuis les différentes informations disponibles (Signaux du Google Consent Mode, TC String du TCF…)</td><td>true/false/undefined</td><td>false</td><td>Oui</td></tr><tr><td>Gtm-Helper-Consent-Analytics</td><td>Signal de consentement pour la mesure d'audience. Sirdata tente de déduire les signaux de choix depuis les différentes informations disponibles (Signaux du Google Consent Mode, TC String du TCF…)</td><td>true/false/undefined</td><td>false</td><td>Oui</td></tr><tr><td>Gtm-Helper-Consent-Basic-Ads</td><td>Signal de consentement pour la publicité standard. Sirdata tente de déduire les signaux de choix depuis les différentes informations disponibles (Signaux du Google Consent Mode, TC String du TCF…)</td><td>true/false/undefined</td><td>false</td><td>Oui</td></tr><tr><td>Gtm-Helper-Consent-Basic-Content</td><td>Signal de consentement pour le contenu standard. Sirdata tente de déduire les signaux de choix depuis les différentes informations disponibles (Signaux du Google Consent Mode, TC String du TCF…)</td><td>true/false/undefined</td><td>undefined</td><td>Oui</td></tr><tr><td>Gtm-Helper-Consent-Personalized-Ads</td><td>Signal de consentement pour la publicité personnalisée. Sirdata tente de déduire les signaux de choix depuis les différentes informations disponibles (Signaux du Google Consent Mode, TC String du TCF…)</td><td>true/false/undefined</td><td>false</td><td>Oui</td></tr><tr><td>Gtm-Helper-Consent-Personalized-Content</td><td>Signal de consentement pour le contenu personnalisé. Sirdata tente de déduire les signaux de choix depuis les différentes informations disponibles (Signaux du Google Consent Mode, TC String du TCF…)</td><td>true/false/undefined</td><td>undefined</td><td>Oui</td></tr><tr><td>Gtm-Helper-Gdpr-Applies</td><td>Indique si le RGPD (ou réglementation similaire imposant le recueil du consentement) s'applique à l'utilisateur. Exemple : <code>true</code> pour un utilisateur en France, <code>false</code> au Maroc. Si <code>false</code>, les headers de consentement sont automatiquement positionnés à <code>true</code>.</td><td>true/false/undefined</td><td>true</td><td>Oui</td></tr><tr><td>Gtm-Helper-Cookieless-Id-Cross-Domain</td><td>Identifiant cookieless universel (permet le suivi inter-site). Si le service n'est pas actif, ou si l'utilisateur n'a pas donné son consentement, la valeur sera "undefined". Sinon, la valeur sera un identifiant utilisateur au format UUID V4.</td><td>undefined/UUID V4</td><td>no-consent</td><td>Non</td></tr><tr><td>Gtm-Helper-Cookieless-Id-Domain-Specific</td><td>Identifiant cookieless spécifique à un domaine (ne permet pas le suivi inter-site). Si le service n'est pas actif, ou l'utilisateur s'est opposé au traitement, la valeur sera "undefined". Sinon, la valeur sera un identifiant utilisateur au format UUID V4.</td><td>undefined/UUID V4</td><td>f577fc8e-065a-5e5f-6008-eacbc29c17de</td><td>Non</td></tr><tr><td>Gtm-Helper-Device-Is-Mobile</td><td>Type de terminal mobile (vrai/faux)</td><td>true/false/undefined</td><td>false</td><td>Oui</td></tr><tr><td>Gtm-Helper-Device-User-Agent</td><td>User-agent du terminal (non pseudonymisé en cas de proxyfication activée, User-Agent envoyé à GA4 l'étant).</td><td>string</td><td>Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/<a href="http://123.0.0.0/">123.0.0.0</a> Safari/537.36</td><td>Oui</td></tr><tr><td>Gtm-Helper-Optout</td><td>Signal d'opposition à des traitements. Sirdata déduit le signal d'opposition depuis le cookie "gtm-helper-optout" ayant une valeur non nulle (exemple : "true", "1") et qui doit être déposé sur le host utilisé pour sGTM (exemple : "<a href="http://tag.exemple.com/">tag.exemple.com</a>") ou le domaine précédé d'un point (exemple : ".<a href="http://exemple.com/">exemple.com</a>")</td><td>true/false/undefined</td><td>undefined</td><td>Oui</td></tr><tr><td>Gtm-Helper-Site-Domain</td><td>Le domaine d'où provient la requête</td><td>string</td><td><a href="http://example.com/">example.com</a></td><td>Oui</td></tr><tr><td>Gtm-Helper-Site-Host</td><td>Le host d'où provient la requête</td><td>string</td><td><a href="http://www.example.com/">www.example.com</a></td><td>Oui</td></tr><tr><td>Gtm-Helper-Site-Origin</td><td>L'origine de la requête</td><td>string</td><td><a href="https://www.example.com/">https://www.example.com</a></td><td>Oui</td></tr><tr><td>Gtm-Helper-User-City</td><td>Ville de connexion de l'utilisateur</td><td>string</td><td>Paris</td><td>Oui</td></tr><tr><td>Gtm-Helper-User-Country</td><td>Pays de connexion de l'utilisateur</td><td>ISO 3166-1 alpha-2 country code</td><td>FR</td><td>Oui</td></tr><tr><td>Gtm-Helper-User-First-Id</td><td>Identifiant attribué par First-ID à l'utilisateur. Elle n'est mise à disposition que si l'option adquate est activée dans votre compte et qu'un consentement pour First-Id est détecté. Si l'option n'est pas activée, ou si aucun consentement n'est détecté, ou si il n'y a pas d'information connue, la valeur sera "undefined". Si un consentement est détecté et qu'une information existe, sa valeur sera affichée sous forme de chaîne.</td><td>undefined/string</td><td>9440839b080a4aea8077d0d1e867fe14</td><td>Non</td></tr><tr><td>Gtm-Helper-User-Hashed-Email</td><td>Adresse email de l'utilisateur, hashée en sha-256. Elle n'est mise à disposition que si l'option d'enrichissement adquate est activée dans votre compte et qu'un consentement est détecté. Si l'option n'est pas activée, ou si aucun consentement n'est détecté, ou si il n'y a pas d'information connue, la valeur sera "undefined". Si un consentement est détecté et qu'une information existe, sa valeur sera affichée sous forme de chaîne.</td><td>undefined/string (sha-256 hash)</td><td>f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a</td><td>Non</td></tr><tr><td>Gtm-Helper-User-Ip</td><td>Adresse IP de connexion de l'utilisateur (non tronquée en cas de proxyfication activée, l'adresse IP envoyé à GA4 l'étant).</td><td>Adresse IP</td><td>1.1.1.1</td><td>Oui</td></tr><tr><td>Gtm-Helper-User-Isp</td><td>Fournisseur d'accès internet ou VPN (exemple : "Privacy Relay" d'Apple)</td><td>string</td><td>Free Pro SAS</td><td>Oui</td></tr><tr><td>Gtm-Helper-User-Region</td><td>Région de connexion de l'utilisateur</td><td>ISO 3166-2 region code</td><td>IDF</td><td>Oui</td></tr><tr><td>Gtm-Helper-Cluster</td><td>Nom du cluster sGTM (ex: <code>prod-eu</code>, <code>prod-us</code>)</td><td>string</td><td>prod-eu</td><td>Oui</td></tr><tr><td>Gtm-Helper-Config-Id</td><td>ID de la configuration GTM Server-side</td><td>string</td><td>2hDUjf</td><td>Oui</td></tr><tr><td>Gtm-Helper-User-Has-Adblocker</td><td><code>true</code> si un bloqueur de publicités est détecté</td><td>true/false/undefined</td><td>false</td><td>Oui</td></tr><tr><td>Gtm-Helper-User-Connection</td><td>Type de connexion (<code>cellular</code>, <code>wifi</code>, <code>ethernet</code>)</td><td>string</td><td>wifi</td><td>Oui</td></tr><tr><td>Gtm-Helper-User-Type</td><td>Catégorie de trafic (<code>human</code>, <code>bot</code>, <code>anonymized</code>)</td><td>string</td><td>human</td><td>Oui</td></tr><tr><td>Gtm-Helper-User-Is-Bot</td><td><code>true</code> si le trafic est identifié comme bot</td><td>true/false/undefined</td><td>false</td><td>Oui</td></tr><tr><td>Gtm-Helper-Request-Has-User-Data</td><td><code>true</code> si des données utilisateur ont été traitées</td><td>true/false/undefined</td><td>true</td><td>Oui</td></tr><tr><td>Gtm-Helper-Server-Host</td><td>Host du serveur CDN</td><td>string</td><td>tag.example.com</td><td>Oui</td></tr><tr><td>Gtm-Helper-Server-Domain</td><td>Domaine du serveur CDN</td><td>string</td><td>example.com</td><td>Oui</td></tr><tr><td>Gtm-Helper-Version</td><td>Version du GTM Helper</td><td>string</td><td>2.4.1</td><td>Oui</td></tr></tbody></table>

### En-têtes conditionnels

<table data-header-hidden><thead><tr><th width="159"></th><th width="265"></th><th width="115"></th><th width="111"></th><th></th></tr></thead><tbody><tr><td>En-tête</td><td>Définition</td><td>Valeurs possibles</td><td>Exemple</td><td>Activation par défaut</td></tr><tr><td>Gtm-Helper-User-Email</td><td>Email utilisateur en clair</td><td>string/undefined</td><td>user@example.com</td><td>Non*</td></tr><tr><td>Gtm-Helper-User-Hashed-Email-For-Google</td><td>Email hashé format Google</td><td>string/undefined</td><td>f660ab912ec1...</td><td>Non*</td></tr><tr><td>Gtm-Helper-User-Hashed-Phone</td><td>Numéro de téléphone hashé SHA-256</td><td>string/undefined</td><td>a1b2c3d4e5f6...</td><td>Non*</td></tr><tr><td>Gtm-Helper-User-First-Address</td><td>Première ligne d'adresse</td><td>string/undefined</td><td>123 Rue Example</td><td>Non*</td></tr><tr><td>Gtm-Helper-User-Second-Address</td><td>Deuxième ligne d'adresse</td><td>string/undefined</td><td>Apt 4B</td><td>Non*</td></tr><tr><td>Gtm-Helper-Cdn-Ip</td><td>Adresse IP du CDN si différente</td><td>Adresse IP/undefined</td><td>203.0.113.1</td><td>Oui**</td></tr><tr><td>Gtm-Helper-Dev-Info</td><td>Informations de debug</td><td>string/undefined</td><td>debug:v2.4.1</td><td>Non***</td></tr></tbody></table>

\*Activation avec `HashedUserDataEnrich` activé \*\*Automatique si CDN IP ≠ user IP \*\*\*Mode développement uniquement


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://server-side.docs.sirdata.net/sirdata-server-side/traitement-des-donnees/surcouche-gtm-helper.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.