Cet article décrit les différentes façons d'envoyer des événements à un conteneur côté serveur. Si vous avez besoin de plus d'informations générales, découvrez le 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 de 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 :
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 la balise Google (gtag.js). Choisissez votre option de mise en œuvre.
Facultatif: envoyer 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 et ne peuvent être définis qu'au niveau de cette balise.
Les paramètres d'événement spécifient des informations supplémentaires sur un événement et peuvent être définis pour tous les événements, certains événements ou les événements page_view.
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.
Pour afficher la liste des clients disponibles:
Ouvrez votre conteneur de serveur.
Dans la barre de navigation à gauche, cliquez sur Clients. Le client GA4 est préinstallé par défaut sur votre conteneur côté serveur. Si vous devez utiliser Universal Analytics, configurez un client Google Analytics: Universal Analytics.
Cliquez sur le nom du client pour afficher ou modifier les détails.
Paramètres client facultatifs
Dans la plupart des cas, aucune modification du client ne sera nécessaire. Cependant, 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. Les nombres plus élevés sont exécutés en premier, et le premier client qui correspond à la requête entrante devient le client actif de cette requête.
Critères d'activation : les critères d'activation définissent le moment auquel le client doit répondre aux requêtes.
Pour les clients UA: Chemins Universal Analytics par défaut: le client s'active lorsque les chemins des requêtes incluent
/collect,/r/collectet d'autres chemins similaires utilisés par les fichiers JavaScript qui envoient des données à Google Analytics. Ce paramètre est actif par défaut.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 de serveur. Lorsque cette option est activée, ce client s'active en réponse aux requêtes envoyées 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 de serveur pour analyser les paramètres supplémentaires et créer des données d'événement à partir de ceux-ci.
Pour utiliser des paramètres supplémentaires dans une balise de serveur:
- Dans votre conteneur de serveur, cliquez sur Variables dans le panneau de navigation de gauche.
- Créez une variable définie par l'utilisateur.
- Dans Configuration de la variable, sélectionnez le type de variable Données d'événement.
- Dans Chemin d'accès de la clé, saisissez le nom du paramètre.
- Attribuez un nom à votre variable, puis cliquez sur Enregistrer.
Vous pouvez maintenant utiliser le paramètre d'événement dans n'importe quelle autre balise de votre conteneur serveur.
3. Facultatif: envoyez des données à partir de sources autres que des sites Web
Vous pouvez utiliser le protocole de mesure de Google Analytics pour activer la compatibilité avec le taggage côté serveur à partir de sources telles que des applications mobiles et des 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 afin d'utiliser le protocole de mesure:
- Dans votre conteneur pour mobile (Android ou iOS), cliquez sur Balises > Nouveau.
- Dans Configuration de la balise, sélectionnez le type de balise Image personnalisée.
- Définissez la valeur de Image URL (URL de l'image) sur une image de pixel sur le conteneur serveur au niveau du chemin d'accès du client du protocole de mesure que vous avez spécifié précédemment.
Ajoutez les paramètres du protocole de mesure de votre choix à 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 - Désélectionnez Activer le cache busting.
- Enregistrez la balise et publiez le conteneur.
- Dans votre conteneur côté serveur, cliquez sur Clients > Nouveau.
- Dans Configuration du client, sélectionnez le type de client Protocole de mesure.
- Définissez Activation Path (Chemin d'activation) sur le chemin d'accès du point de terminaison de la collection de votre application.
- 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 de serveur, remplacez le nom d'hôte www.google-analytics.com par le nom de domaine de votre conteneur de 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:
- Dans votre conteneur côté serveur, cliquez sur Clients > Nouveau.
- Dans Configuration du client, sélectionnez le type de client Protocole de mesure.
- Définissez Activation Path (Chemin d'activation) sur le chemin d'accès du point de terminaison de votre serveur.
- Enregistrez la configuration du client et publiez le conteneur.
Étapes suivantes
Pour envoyer des données dans un contexte propriétaire réel, vous devez diffuser des scripts Google, tels que la bibliothèque Google Analytics, à partir de vos propres serveurs.