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

Cet article décrit les différentes façons d'envoyer des événements à un conteneur côté serveur. Si vous avez besoin d'informations générales supplémentaires, consultez Fonctionnement du taggage côté serveur.

Cet article explique comment :

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

Avant de commencer

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

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

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

Choisissez votre option d'implémentation.

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

Vous pouvez envoyer deux types de paramètres 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 influencent le comportement de votre balise Google. Ils 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. Vous pouvez les définir pour tous les événements, pour certains événements ou pour les événements page_view.

Choisissez votre option d'implémentation.

Recommandations de configuration

Nous vous recommandons d'utiliser une balise GA4 sur une page Web pour envoyer des données au conteneur serveur. Cette balise peut utiliser différentes méthodes de transport pour assurer le meilleur taux de diffusion des événements. Ces méthodes incluent, sans s'y limiter :

  • Pixel d'image
  • API Fetch
  • XHR
  • Service worker qui s'exécute dans un iFrame chargé à partir du domaine de votre conteneur de serveur.

Pour vous assurer que toutes les méthodes sont prises en charge, vérifiez les points suivants :

Content Security Policy (CSP)

Directive Content Purpose
img-src [SERVER_CONTAINER_URL] Demandes de mesure
connect-src [SERVER_CONTAINER_URL] Demandes de mesure
frame-src [SERVER_CONTAINER_URL] Implémentation du service worker

De plus, X-Frame-Options ne doit pas empêcher le chargement des iFrames à partir de l'URL du conteneur de serveur.

Consultez https://developers.google.com/tag-platform/security/guides/csp pour connaître les règles spécifiques à chaque produit.

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

Lorsqu'un client envoie une requête HTTP à un conteneur serveur, il doit revendiquer cette requête.

Pour afficher la liste des clients disponibles :

  1. Ouvrez 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é par défaut dans votre conteneur côté serveur.

  4. Cliquez sur le nom du client pour afficher ou modifier les détails.

Paramètres client facultatifs

Dans la plupart des cas, le client ne nécessitera aucune modification. Toutefois, votre cas d'utilisation peut être différent et vous pouvez 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 : ils définissent le moment où le client répondra aux requêtes :

    • Chemins gtag.js par défaut pour des ID spécifiques : ce paramètre permet d'activer la diffusion du code JavaScript gtag.js via votre URL de conteneur de 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 créer des données d'événement à partir de ceux-ci.

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

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

  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 d'accès à la clé, saisissez le nom du paramètre.
  5. Nommez votre variable et 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 provenant d'autres sources que des sites Web

Le protocole de mesure Google Analytics peut être utilisé pour activer la prise en charge du taggage côté serveur à partir de sources telles que les applications mobiles et les applications de serveur à serveur. Cette option vous permet d'envoyer des événements à votre conteneur au format du protocole de mesure. Le conteneur envoie ces événements à Google Analytics en utilisant le même mécanisme que tous les autres événements SGTM.

Cette option n'est pas compatible avec toutes les fonctionnalités du point de terminaison du protocole de mesure, comme la dérivation des informations géographiques et sur les appareils à partir des événements de taggage.

Applications mobiles

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

  1. Dans votre conteneur mobile (Android ou iOS), cliquez sur Balises > Nouvelle.
  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 pixel du conteneur serveur, au chemin d'accès du client Measurement Protocol que vous avez spécifié précédemment. Ajoutez les paramètres du 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 du 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 hits 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 au point de terminaison de votre serveur.
  4. Enregistrez la configuration du client et publiez le conteneur.

Étapes suivantes

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

Charger les scripts Google via mon serveur