Configurer la passerelle de balise Google pour les annonceurs

Ce document s'adresse aux utilisateurs qui souhaitent déployer la passerelle de balise Google pour les annonceurs. Nous vous recommandons d'utiliser la passerelle de balise Google pour les annonceurs afin de bénéficier de la configuration de balise la plus durable.

Présentation

La passerelle de balise Google pour les annonceurs vous permet de déployer une balise Google à l'aide de votre propre infrastructure first party, hébergée sur le domaine de votre site Web. Cette infrastructure se situe entre votre site Web et les services Google. La configuration décrite dans cette documentation vous aidera à mieux mesurer votre site Web. Vous pouvez le configurer à l'aide de votre réseau de diffusion de contenu (CDN), de votre équilibreur de charge ou de votre serveur Web existants.

Dans les configurations standards de la balise Google, votre page Web demande une balise Google à un domaine Google. Lorsque le tag se déclenche, il envoie des demandes de mesure directement au produit Google. Avec la passerelle de balise Google pour les annonceurs, votre site Web charge la balise Google depuis votre domaine propriétaire. Lorsque la balise se déclenche, certaines demandes de mesure sont envoyées à Google à l'aide de votre domaine propriétaire.

Ce schéma représente le flux d'informations dans la passerelle de balise Google pour les annonceurs :

Avant de commencer

Ce guide suppose que votre site Web est déjà configuré avec les éléments suivants :

• Une balise Google ou un conteneur Tag Manager.
• Réseau de diffusion de contenu (CDN) ou équilibreur de charge pouvant transférer des requêtes vers des points de terminaison externes.

Pour commencer, choisissez votre type de configuration.

Configuration manuelle Configuration automatique avec Cloudflare

1. Choisir le chemin de diffusion des tags

Vous devez réserver un chemin sur le domaine de votre site Web pour diffuser la balise. Assurez-vous que ce chemin n'est pas déjà utilisé sur votre domaine.

Pour configurer la passerelle de balise Google pour les annonceurs, choisissez un chemin qui n'est pas déjà utilisé sur votre site. Pour réduire le risque de conflit avec un chemin d'accès déjà présent sur le site, vous pouvez choisir n'importe quelle combinaison de lettres et de chiffres. Si vous souhaitez un chemin d'accès plus lisible, vous pouvez choisir d'utiliser un mot tel que /metrics, /securemetric, /analytics ou tout autre mot de votre choix.

Le chemin ne doit pas être le chemin racine / ni dépasser 100 caractères.

Remplissez les champs suivants pour générer les exemples tout au long de ce document.

Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics

Attention : Cette configuration redirige tout le trafic vers le chemin d'accès choisi. Pour éviter d'affecter votre site Web, choisissez un chemin qui n'est pas déjà utilisé.

2. Router le trafic

Cette section suppose que votre site Web utilise déjà un CDN ou un équilibreur de charge compatible avec le routage du trafic par chemins d'accès.

Google Cloud

Vous devez configurer un backend qui recherche la position géographique approximative du visiteur du site et créer des règles de routage dans votre équilibreur de charge d'application externe existant.

Créer le backend

1. Ouvrir l'équilibreur de charge GCP

2. Dans votre équilibreur de charge, ouvrez la section Configuration du backend. Créez un service de backend.

3. Configurez votre nouveau service de backend avec des informations de géolocalisation :

   • Spécifiez un nom, par exemple measurement-be-svc.
   • Définissez Type de backend sur Groupe de points de terminaison du réseau Internet.
   • Définissez Protocole sur HTTPS et conservez la valeur préremplie pour Délai avant expiration.
   • Sous Backends, cliquez sur le menu déroulant Groupe de points de terminaison du réseau Internet et créez un groupe de points de terminaison du réseau Internet :
     • Définissez le type de groupe de points de terminaison du réseau sur NEG Internet (global, régional).
     • Définissez le champ d'application sur Global.
     • Définissez Ajouter via sur Nom de domaine complet et port.
     • Définissez Nom de domaine complet sur G-12345.fps.goog.
     • Cliquez sur CRÉER pour créer le point de terminaison.
     • Fermez l'onglet Groupe de points de terminaison du réseau pour revenir à l'onglet Nouveau service de backend.
   • Recherchez le nom du nouveau groupe de points de terminaison du réseau et sélectionnez-le.
   • Ouvrez la section Configurations avancées. Ajoutez les en-têtes de requête personnalisés suivants.

     Nom de l'en-tête	Valeur de l'en-tête
     Host	G-12345.fps.goog
     X-Forwarded-Country	{client_region}
     X-Forwarded-Region	{client_region_subdivision}

   • Vérifiez les autres paramètres. Ni Cloud CDN ni Cloud Armor ne sont requis pour cette intégration. Vous pouvez donc les désactiver sans problème.
   • Enregistrez le nouveau service de backend.

Configurer des règles de routage

1. Dans votre équilibreur de charge, ouvrez la section Règles de routage.

2. Ajoutez les règles d'hôte et de chemin d'accès suivantes :

   Hôte	Chemin	Backend
   *	/metrics/*	measurement-be-svc

3. Mettez à jour la configuration de l'équilibreur de charge.

4. Dans un navigateur, vérifiez la configuration en accédant à https://example.com/metrics/healthy. La page doit contenir le texte ok. Vérifiez que les informations géographiques sont incluses en accédant à https://example.com/metrics/?validate_geo=healthy. La page doit contenir le texte ok.

Cloudflare

Pour diffuser votre balise dans la passerelle de balises Google pour les annonceurs, vous devez créer une entrée CNAME pour un nouveau sous-domaine, une règle d'origine pour transférer les requêtes et une règle de transformation pour inclure des informations de géolocalisation. Pour effectuer cette configuration, vous devez disposer d'un forfait Cloudflare Enterprise. Si vous ne disposez pas d'un forfait Enterprise, envisagez d'utiliser la configuration automatisée Cloudflare.

Créer une entrée CNAME

Remarque : Les balises n'utiliseront pas cette entrée CNAME. Cloudflare l'utilise pour router les requêtes en interne.

Choisissez un sous-domaine à réserver pour l'entrée CNAME. Renseignez les champs suivants pour remplir les exemples de ce document. Ce CNAME n'est jamais exposé en dehors de votre configuration Cloudflare. Le nom est donc arbitraire.

CNAME subdomain: fps

1. Dans l'onglet "DNS", ouvrez la section Enregistrements.
2. Ajoutez un enregistrement avec la configuration suivante :
   • Définissez Type sur CNAME.
   • Définissez Nom sur fps.
   • Définissez Cible sur G-12345.fps.goog.
3. Enregistrez l'enregistrement CNAME.

Créer la règle d'origine

1. Dans l'onglet "Règles", ouvrez Règles d'origine et créez une règle.
2. Saisissez un nom de règle, par exemple Route measurement.
3. Faites correspondre les requêtes entrantes en fonction d'une expression de filtre personnalisée, puis cliquez sur Modifier l'expression.
4. Collez l'expression suivante dans le générateur : (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
5. Mettez à jour l'en-tête de l'hôte sur Réécrire vers… G-12345.fps.goog.
6. Définissez l'enregistrement DNS sur Remplacer par…. fps.example.com.
7. Enregistrez la règle d'origine.
8. S'il existe d'autres règles d'origine, augmentez la position de la règle que vous venez de créer afin qu'elle s'exécute après tout autre chemin d'accès générique.
9. Dans un navigateur, vérifiez la configuration en accédant à https://example.com/metrics/healthy. La page doit afficher ok.

Inclure des informations de géolocalisation

1. Dans l'onglet "Règles", ouvrez Paramètres.
2. Activez l'option Ajouter des en-têtes de localisation des visiteurs.
3. Patientez quelques minutes pour que la règle se propage. Dans un navigateur, vérifiez la configuration en accédant à https://example.com/metrics/?validate_geo=healthy. La page doit afficher ok.

Akamai

Remarque : La passerelle de balise Google pour les annonceurs avec Akamai est en version bêta. Si vous avez des questions ou rencontrez des problèmes lors de la configuration, contactez-nous à l'adresse [e-mail].

Pour diffuser votre balise dans la passerelle de balise Google pour les annonceurs, vous devez ajouter une règle dans votre propriété afin de transférer les demandes et d'ajouter des informations de géolocalisation.

Créer la règle de redirection

1. Créez une version de votre configuration de diffusion dans Property Manager.
2. Dans la section Paramètres de configuration de la propriété, ajoutez un nouveau Rule
   • Saisissez un nom, par exemple Route measurement.
3. Ajouter une correspondance
   • Définissez les menus déroulants de correspondance sur Chemin d'accès et est l'un des suivants.
   • Définissez la valeur de correspondance sur /metrics/*.
4. Ajouter un comportement
   • Sélectionnez Standard Property Behavior (Comportement standard de la propriété), puis choisissez le comportement Origin Server (Serveur d'origine).
   • Définissez Nom d'hôte du serveur d'origine sur G-12345.fps.goog.
   • Définissez Forward Host Header (Transférer l'en-tête de l'hôte) sur Origin Hostname (Nom d'hôte d'origine).
5. Enregistrez la nouvelle règle et déployez vos modifications.
   • Veillez à tester la nouvelle règle de redirection dans votre environnement de préproduction avant de la déployer en production.
   • Conseil : Assurez-vous qu'aucune règle ne modifie ni ne supprime les en-têtes de réponse sortants. Cela peut entraîner l'échec des scripts Google si l'en-tête de réponse Content-Type est manquant.

Inclure des informations de géolocalisation

1. Accédez à la section Variables de propriété et ajoutez les variables suivantes.

   Nom de la variable	Paramètres de sécurité
   USER_REGION	Hidden
   USER_COUNTRY	Hidden

2. Choisissez votre règle de redirection (créée ci-dessus) sous les paramètres de configuration de la propriété.

3. Ajoutez deux nouveaux comportements Définir la variable.

   • Sélectionnez Comportement standard de la propriété, puis choisissez le comportement Définir la variable. Créez un comportement pour chaque variable.
   • Définissez les valeurs suivantes pour chaque comportement.

     Variable	Créer de la valeur à partir de	Obtenir des données depuis	Champ Edgescape	Opération
     PMUSER_USER_REGION	Extract	Edgescape Data	Region Code	None
     PMUSER_USER_COUNTRY	Extract	Edgescape Data	Country Code	None

4. Ajout de deux nouveaux comportements Modifier l'en-tête de requête sortante

   • Sélectionnez Comportement standard de la propriété, puis choisissez le comportement Modifier l'en-tête de la requête sortante. Créez un comportement pour chaque variable géographique Edgescape.
   • Définissez les valeurs suivantes pour chaque comportement.

     Action	Sélectionner le nom de l'en-tête	Nom de l'en-tête personnalisé	Valeur de l'en-tête
     Add	Other...	X-Forwarded-Region	{{user.PMUSER_USER_REGION}}
     Add	Other...	X-Forwarded-Country	{{user.PMUSER_USER_COUNTRY}}

5. Enregistrez la nouvelle règle et déployez vos modifications.

   • Veillez à tester la nouvelle règle de redirection dans votre environnement de préproduction avant de la déployer en production.

6. Dans un navigateur, vérifiez la configuration en accédant à https://example.com/metrics/healthy. La page doit contenir le texte ok. Vérifiez que les informations géographiques sont incluses en accédant à https://example.com/metrics/?validate_geo=healthy. La page doit contenir le texte ok.

Autre

Pour diffuser votre tag dans la passerelle de balise Google pour les annonceurs, vous devez configurer votre CDN ou votre équilibreur de charge afin de router les requêtes vers le point de terminaison de la passerelle de balise Google pour les annonceurs.

1. Ajoutez une origine ou un backend qui pointe vers G-12345.fps.goog.
2. Remplacez l'en-tête Host pour qu'elle corresponde à G-12345.fps.goog. Autorisez le transfert de tous les cookies et de toutes les chaînes de requête.
3. Transmettez les informations de géolocalisation du visiteur en incluant l'un des en-têtes suivants :
   • X-Forwarded-CountryRegion : pays et région de l'utilisateur dans un seul code ISO 3166-2 (par exemple, US-CA).
   • X-Forwarded-Country et X-Forwarded-Region :
     • X-Forwarded-Country : pays de l'utilisateur sous forme de code ISO 3166-1 alpha-2 (par exemple, US).
     • (Facultatif) X-Forwarded-Region : code de la subdivision régionale de l'utilisateur (par exemple, CA).
   • Si les deux ensembles d'en-têtes sont inclus, X-Forwarded-CountryRegion sera utilisé.
4. Ajoutez une règle de chemin d'accès pour /metrics/* afin d'acheminer le trafic vers la passerelle de balise Google pour les annonceurs.
5. Configurez le chemin d'accès réservé pour qu'il ait une priorité plus élevée que la règle par défaut.
6. Dans un navigateur, vérifiez la configuration en accédant à https://example.com/metrics/healthy. La page doit afficher ok.

Étape 3 : Mettez à jour les scripts sur le site Web pour utiliser le chemin de mesure

Remplacez les scripts sur chaque page du site Web par l'un des éléments suivants :

gtag.js

En haut de la section <head>, recherchez les deux lignes de script contenant l'ID de votre balise Google :

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>

et remplacez-les par le chemin de mesure :

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

En haut de la section <head>, remplacez l'extrait Tag Manager par ce qui suit :

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

Tester la configuration de mesure

Pour tester la configuration de la mesure, configurez votre conteneur de sorte qu'il comporte au moins une balise qui se déclenche.

1. Accédez à Tag Assistant et prévisualisez votre conteneur.
2. Parcourez votre site Web pour déclencher des événements.

3. Dans l'onglet Récapitulatif > Résultat > Hits envoyés, vérifiez que les hits sont acheminés vers /metrics.