# Surcouche GTM Helper

Ces traitements sont additionnels à ceux décrits à la section [Hébergement seul](https://server-side.docs.sirdata.net/sirdata-server-side/traitement-des-donnees/hebergement-seul), 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