Envoyer des données à Tag Manager côté serveur

Cet article décrit les différentes manières d'envoyer des événements à un conteneur côté serveur. Pour en savoir plus, consultez la section Fonctionnement du taggage côté serveur.

Cet article explique comment:

• Envoyer des données depuis un site Web vers votre conteneur côté serveur
• Envoyer des données supplémentaires à un conteneur serveur
• Recevoir des données dans votre conteneur côté serveur
• Envoyer des données à partir de sources autres que des sites Web

Avant de commencer

Ce guide suppose que vous disposez des éléments suivants :

• Configurer un conteneur de serveur dans Tag Manager
• Configurer un serveur d'insertion de balises

1. Envoyer des données depuis un site Web vers votre conteneur côté serveur 

Vous pouvez acheminer les données via une implémentation côté serveur via Tag Manager ou gtag.js. Choisissez votre option d'implémentation.

Tag Manager gtag.js

Balise Google: GA4

Pour configurer une balise Google pour le traitement côté serveur, vous devez ajouter l'URL de votre conteneur serveur.

Créer une variable de configuration pour l'URL du conteneur du serveur

1. Ouvrir Google Tag Manager

2. Sélectionnez le conteneur Web que vous souhaitez configurer.

3. Ouvrez le menu Variables.

4. Créez une variable définie par l'utilisateur Nouveau de type Balise Google : paramètres de configuration.

5. Ajoutez les paramètres suivants:

   • Nom : server_container_url
   • Valeur: définie sur l'URL de votre conteneur serveur Tag Manager.

6. Nommez votre variable (par exemple, "URL du serveur"), puis enregistrez-la.

Attribuer l'URL de conteneur serveur à une balise Google

1. Ouvrez le menu Balises .
2. Modifiez une balise Google existante ou ajoutez-en une.
3. Dans Paramètres de configuration, sélectionnez la variable de conteneur serveur que vous venez de créer.
   Conseil: Pour voir les paramètres hérités de la variable de paramètres, cliquez sur Afficher les paramètres hérités.
4. Pour que la balise Google se déclenche avant les autres déclencheurs, cliquez sur Déclenchement et utilisez Initialisation – Déclencheur "Toutes les pages". En savoir plus sur les déclencheurs de page
5. Enregistrez la balise et publiez le conteneur.

(Facultatif) Envoyer des paramètres supplémentaires avec chaque événement

Vous pouvez envoyer deux types de paramètres supplémentaires supplémentaires: les paramètres au niveau de la configuration et les paramètres au niveau de l'événement. Les paramètres de configuration ont une incidence sur le comportement de votre balise Google et ne peuvent être définis qu'au niveau de la balise Google.

Les paramètres d'événement spécifient des informations supplémentaires sur un événement. Ils peuvent être définis pour tous les événements, certains événements ou des événements page_view.

Paramètres de configurationTous les événementsSélectionnez des événementspage_view événements

Découvrez comment réutiliser les paramètres de configuration dans Google Tag Manager.

Pour envoyer des paramètres supplémentaires pour tous les événements, réutilisez les paramètres d'événement dans Google Tag Manager.

Pour envoyer des paramètres supplémentaires avec un événement Google Analytics 4:

1. Dans un conteneur Web, ajoutez un tag d'événement Google Analytics 4 ou modifiez-en un existant.
2. Cliquez sur Paramètres de l'événement > Ajouter une ligne.
3. Ajoutez le paramètre à envoyer avec l'événement. Pour connaître les paramètres d'événement prédéfinis, consultez la documentation de référence sur les événements recommandés.
   • Dans Nom du champ, ajoutez le nom de votre paramètre, par exemple language.
   • Dans Valeur, ajoutez la valeur de votre paramètre.

Conseil :Si votre valeur doit être déterminée au moment du chargement de Tag Manager, utilisez une variable plutôt qu'une valeur codée en dur.

1. Configurez un déclencheur pour qu'il s'active sur Initialisation – Toutes les pages.
2. Enregistrez la balise et publiez le conteneur.

Pour envoyer un paramètre sur un événement page_view:

1. Dans un conteneur Web, modifiez une balise Google existante.

2. Désactivez page_view par défaut dans les paramètres de configuration en ajoutant un nouveau paramètre:

   • Nom : send_page_view
   • Valeur : false

3. Créez un tag Google Analytics: Événement GA4.

   • Sélectionnez la balise de configuration que vous avez modifiée à l'étape 1.
   • Définissez le paramètre Nom de l'événement sur page_view.

4. Ajoutez le paramètre à envoyer avec l'événement. Pour connaître les paramètres d'événement prédéfinis, consultez la documentation de référence sur les événements recommandés. - Dans Nom du champ, ajoutez le nom de votre paramètre, par exemple language.

   • Dans Valeur, ajoutez la valeur de votre paramètre.

Conseil :Si votre valeur doit être déterminée au moment du chargement de Tag Manager, utilisez une variable plutôt qu'une valeur codée en dur.

1. Configurez un déclencheur pour qu'il s'active sur Initialisation – Toutes les pages.
2. Enregistrez la balise et publiez le conteneur.

2. Recevoir des données dans votre conteneur côté serveur

Lorsque vous envoyez une requête HTTP à un conteneur serveur, un client doit revendiquer cette requête.

Terme clé :les "clients" sont des adaptateurs situés entre le logiciel exécuté sur l'appareil d'un utilisateur et votre conteneur Tag Manager côté serveur. Ils reçoivent des données de mesure à partir d'un appareil, les transforment en un ou plusieurs événements, les traitent dans le conteneur et empaquettent les résultats à renvoyer à l'appareil.

Pour afficher la liste des clients disponibles:

1. Ouvrir Google Tag Manager

2. Ouvrez votre conteneur serveur.

3. Dans la barre de navigation de gauche, cliquez sur Clients. Le client GA4 est préinstallé sur votre conteneur côté serveur par défaut.

4. Cliquez sur le nom du client pour afficher ou modifier ses informations.

Paramètres client facultatifs

Dans la plupart des cas, aucune modification n'est requise pour le client. Toutefois, votre cas d'utilisation peut être différent et vous pouvez souhaiter modifier l'un des paramètres suivants:

• Priorité:détermine l'ordre d'exécution des clients. Ceux qui sont associés à des nombres élevés sont exécutés en priorité, et le premier client qui correspond à la requête entrante devient le client actif pour celle-ci.

• Critères d'activation:les critères d'activation définissent le moment où le client répondra aux requêtes:

  • Chemins gtag.js par défaut pour des ID spécifiques:utilisez ce paramètre pour activer la diffusion du code JavaScript gtag.js via l'URL de votre conteneur serveur. Avec ce paramètre, le client s'active en réponse aux requêtes transmises aux chemins de requête gtag.js par défaut (par exemple, /gtag/js?id=TAG_ID). Cliquez sur Ajouter un ID de mesure pour ajouter un ou plusieurs ID de destination.

Facultatif: recevoir des données supplémentaires dans Tag Manager côté serveur

Si vous envoyez des paramètres supplémentaires, vous devez configurer le client Google Analytics 4 dans votre conteneur serveur pour analyser les paramètres supplémentaires et en créer des données d'événement.

Certains tags de serveur incluront les paramètres supplémentaires dans leurs requêtes sortantes sans configuration. Pour exclure ces paramètres, créez une transformation pour supprimer la valeur.

Pour utiliser des paramètres supplémentaires dans d'autres tags:

1. Dans votre conteneur serveur, cliquez sur Variables dans le panneau de navigation de gauche.
2. Créez une variable définie par l'utilisateur.
3. Dans Configuration de la variable, sélectionnez le type de variable Données d'événement.
4. Dans Chemin de la clé, saisissez le nom du paramètre.
5. Attribuez un nom à votre variable, puis cliquez sur Enregistrer.

Vous pouvez désormais utiliser le paramètre d'événement dans n'importe quelle autre balise de votre conteneur serveur.

3. Facultatif: Envoyer des données à partir de sources autres que des sites Web

Le protocole de mesure Google Analytics permet d'activer le taggage côté serveur à partir de sources telles que les applications mobiles et les applications de serveur à serveur.

Applications mobiles

Pour que votre application Android ou iOS envoie des données à votre conteneur serveur, vous devez créer une balise d'image personnalisée et la configurer pour qu'elle utilise le protocole de mesure:

1. Dans votre conteneur mobile (Android ou iOS), cliquez sur Tags > New (Balises > Nouveau).
2. Dans Configuration de la balise, sélectionnez le type de balise Image personnalisée.
3. Définissez la valeur de URL de l'image sur une image de pixel dans le conteneur serveur au chemin du client du protocole de mesure que vous avez spécifié précédemment. Ajoutez les paramètres de protocole de mesure souhaités à la fin de l'URL de votre pixel:
   https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
4. Désélectionnez Activer le cache busting.
5. Enregistrez la balise et publiez le conteneur.
6. Dans votre conteneur côté serveur, cliquez sur Clients > Nouveau.
7. Dans Configuration du client, sélectionnez le type de client Protocole de mesure.
8. Définissez Activation Path (Chemin d'activation) sur le chemin d'accès au point de terminaison de collecte de votre application.
9. Enregistrez la configuration du client et publiez le conteneur côté serveur.

Applications de serveur à serveur

Pour envoyer des données de protocole de mesure à votre conteneur serveur, remplacez le nom d'hôte www.google-analytics.com par le nom de domaine de votre conteneur serveur. Exemple :

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

Pour recevoir des appels du protocole de mesure, configurez votre installation Tag Manager côté serveur avec un client du protocole de mesure:

1. Dans votre conteneur côté serveur, cliquez sur Clients > Nouveau.
2. Dans Configuration du client, sélectionnez le type de client Protocole de mesure.
3. Définissez Activation Path (Chemin d'activation) sur le chemin d'accès du point de terminaison de votre serveur.
4. Enregistrez la configuration du client, puis publiez le conteneur.

Étapes suivantes

Pour envoyer des données dans un contexte first party, vous devez diffuser des scripts Google, tels que la bibliothèque Google Analytics, à partir de vos propres serveurs.

Charger des scripts Google via mon serveur