Cette page s'adresse aux développeurs qui doivent configurer la balise Google à l'aide de gtag.js. Pour ajuster les paramètres dans l'interface utilisateur, consultez Configurer les paramètres de votre balise Google.
Après avoir installé la balise Google, vous pouvez appeler des commandes gtag() n'importe où dans votre code, après l'extrait de code de la balise Google.
Cette page vous explique comment :
- Envoyer des événements à vos produits Google à l'aide de la commande
event - Définir les valeurs envoyées avec chaque événement à l'aide de la commande
set
Avant de commencer
Ce guide part du principe que vous avez effectué les opérations suivantes :
- Vous êtes familiarisé avec le fonctionnement de la balise Google.
- Installer la balise Google
Pour configurer le flux de données, vous avez besoin des éléments suivants :
- Accès au code du site Web sur lequel vous avez installé la balise Google
- L'ID de balise du produit Google que vous souhaitez associer à la balise Google
Qu'est-ce qu'un ID de balise et où le trouver ?
Un ID de balise ou de conteneur identifie le conteneur Google Tag Manager ou la configuration de destination Google chargée par l'extrait de votre balise Google. Les nouvelles installations utilisent par défaut un ID de conteneur Google Tag Manager (GTM-), tandis que les ID spécifiques à une destination identifient des produits Google individuels. Le tableau suivant présente les préfixes d'ID acceptés :| Préfixe | Type d'ID | Description |
|---|---|---|
| GTM-XXXXXX | ID de conteneur Google Tag Manager (par défaut) | ID par défaut des conteneurs Google Tag Manager. Compatible avec toutes les balises Google, tierces et personnalisées. |
| G-XXXXXX | ID spécifique à la destination | Identifie une destination Google Analytics (ID de mesure). |
| AW-XXXXXX | ID spécifique à la destination | Identifie une destination Google Ads (ID de conversion). |
| DC-XXXXXX | ID spécifique à la destination | Identifie une destination Floodlight (référence annonceur). |
| MC-XXXXXX | ID spécifique à la destination | Identifie une destination Google Merchant Center. |
| GT-XXXXXX | ID de balise Google | Identifie une balise Google créée dans des versions antérieures. |
Trouver l'ID de votre balise :
Étape 1 : Associez des produits Google à votre balise
Utilisez la commande config pour établir le flux de données vers les produits Google.
À propos de la commande config
La commande config spécifie les produits Google auxquels vous souhaitez envoyer des données d'événement.
La commande est au format suivant :
gtag('config', 'TAG_ID', {<additional_config_params>});
Paramètres de configuration supplémentaires
Vous pouvez ajuster et étendre une commande config en spécifiant des paramètres dans l'objet {<additional_config_params>} facultatif. Par exemple, l'ajout du paramètre suivant empêchera l'envoi automatique d'une page vue Google Analytics :
gtag('config', 'TAG_ID', {'send_page_view': false});
Configurer la collecte de données
Pour configurer la collecte de données pour un produit Google, ajoutez la commande config avec un ID de balise.
Exemple
La balise Google (GT-XXXXXX) envoie des données aux destinations que vous avez définies, par exemple Google Ads et Google Analytics.
L'exemple suivant montre comment modifier votre code pour charger une deuxième balise Google associée à une destination Floodlight.
Pour envoyer des données à Floodlight (ID de balise DC-ZZZZZZ), ajoutez une autre commande config après avoir initialisé la première balise Google (ID de balise GT-XXXXXX) :
<head>
...
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments)};
gtag('js', new Date());
gtag('config', 'GT-XXXXXX');
gtag('config', 'DC-ZZZZZZ');
</script>
</head>
Comportement de config spécifique au produit
Selon le produit spécifié dans TAG_ID, la commande config peut également déclencher un certain comportement pour ce produit. Par exemple, dans certains cas, la commande config indique à gtag.js de lancer un événement de page vue.
Pour en savoir plus sur le comportement de la commande config par rapport à des produits individuels, consultez la documentation spécifique au produit :
- Conversions Google Ads et remarketing
- Campaign Manager et Display & Video 360
- Search Ads 360
- Google Analytics
Étape 2 : Envoyez des données avec event
Après avoir configuré les connexions aux produits Google, vous devez utiliser la commande event pour envoyer des données.
À propos de la commande event
La commande event vous permet d'envoyer des données d'événement aux produits que vous avez spécifiés avec config. La commande est au format suivant :
gtag('event', 'event_name', {
'key': 'value',
});
À propos des noms d'événements et des paires clé-valeur
Événements recommandés : les événements recommandés sont des événements que vous implémentez, mais qui ont des paires clé-valeur prédéfinies. Ces événements permettent de profiter de fonctionnalités de création de rapports, actuelles ou futures.
Événements personnalisés : pour définir vos propres événements et structures de données, vous pouvez saisir des valeurs personnalisées afin d'envoyer un événement personnalisé.
Configurer des événements
Vous pouvez appeler la méthode event n'importe où dans votre code après avoir initialisé la balise Google.
Définissez un événement. Si vous utilisez un événement recommandé, veillez à utiliser les noms d'événements standardisés et les paires clé-valeur prédéfinies.
Définissez quand l'événement sera déclenché, par exemple s'il est envoyé lors du chargement d'une page ou lorsqu'un utilisateur clique sur un bouton.
Exemple
L'exemple suivant illustre une méthode possible pour mesurer les inscriptions à une newsletter lorsqu'un utilisateur clique sur un bouton. L'exemple utilise un événement personnalisé et l'envoie à une propriété Google Analytics.
<head>
...
/* 1. Initialize the Google tag and gtag.js library */
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments)};
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
</head>
<body>
<script>
let date = Date.now();
/* 2. Define your event. */
function newsletterSignup() {
gtag('event', 'newsletter_signup', {
'time': date,
});
}
</script>
...
/* 3. Trigger your event */
<button type="submit" onclick="newsletterSignup()">Sign me up!</button>
...
</body>
Facultatif : Envoyer des données avec chaque événement à l'aide de set
La commande set vous permet de définir des paramètres qui seront associés à chaque événement ultérieur sur la page.
Par exemple, vous pouvez partager des paramètres de campagne afin que plusieurs balises puissent y accéder sur la même page.
La commande est au format suivant :
gtag('set', 'parameterName');
Étape 3 : Validez votre configuration
Pour vous assurer que vos données d'événement sont envoyées correctement :
- Ouvrez le produit Google dans lequel vous vous attendez à voir des données.
- Vérifiez si des données sont reçues. Chaque produit dispose d'un emplacement différent où vous pouvez vérifier si les données sont reçues :
- Google Analytics : consultez le rapport Temps réel.
- Google Ads : consultez le tableau Actions de conversion et examinez la colonne État (la mise à jour peut prendre jusqu'à 24 heures).
- Floodlight : utilisez Tag Assistant pour vérifier que les balises Floodlight se déclenchent.
Étapes suivantes
Une fois que vous avez configuré vos produits et événements Google, vous avez terminé la configuration de base de la balise Google.
Si vous gérez plusieurs produits et que vous souhaitez gérer leur flux de données plus en détail, consultez Regrouper et acheminer les données.