gtag.js utilise des cookies pour identifier les utilisateurs uniques lors des sessions de navigation. Cette page explique comment personnaliser les paramètres des cookies.
Configurer les paramètres des champs de cookies
Le tableau suivant présente les valeurs par défaut des champs de cookie utilisés par gtag.js:
Nom du champ | Type de valeur | Valeur par défaut |
---|---|---|
cookie_domain |
string |
auto |
cookie_expires |
integer |
63072000 (deux ans, en secondes) |
cookie_prefix |
string |
_ga |
cookie_update |
boolean |
true |
cookie_flags |
string |
|
Pour modifier l'une de ces valeurs, mettez à jour la valeur config
de votre propriété pour la spécifier dans la liste des paramètres. Exemple :
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 days, in seconds
});
Configuration du domaine de cookie
La configuration automatique du domaine de cookie est activée par défaut pour gtag.js. Lorsque cette option est activée, gtag.js définit les cookies sur le domaine de plus haut niveau possible. Par exemple, si l'adresse de votre site Web est blog.example.com
, gtag.js définira des cookies sur le domaine example.com
. Si gtag.js détecte que vous exécutez un serveur localement (par exemple, localhost
), il définit automatiquement cookie_domain
sur 'none'
. gtag.js définira alors des cookies en utilisant le domaine complet à partir de l'emplacement du document.
Pour désactiver la configuration automatique du domaine de cookie, mettez à jour le paramètre config
de votre propriété afin de spécifier une valeur pour le paramètre cookie_domain
:
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_domain': 'blog.example.com'
});
Préfixe de cookie
Pour éviter les conflits avec d'autres cookies, vous devrez peut-être modifier le préfixe du cookie, qui sera ajouté au début des cookies définis par gtag.js. Par exemple, le nom par défaut du cookie ID utilisé par Google Analytics est _ga
. Avec ce code, le cookie sera nommé example_ga
à la place:
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'example'
});
Expiration des cookies
À chaque chargement de page, le délai d'expiration du cookie est mis à jour pour correspondre à l'heure actuelle plus la valeur du champ cookie_expires
. Cela signifie que si cookie_expires
est défini sur une semaine et qu'un utilisateur utilise le même navigateur dans les cinq jours, le cookie reste disponible pendant une semaine supplémentaire et apparaît pour le même visiteur dans Google Analytics. Si ce même utilisateur aurait effectué une visite après l'expiration du cookie d'origine, un nouveau cookie sera créé. Leurs première et deuxième visites apparaîtront alors comme provenant de visiteurs distincts dans Google Analytics.
Si vous définissez la valeur cookie_expires
sur 0
(zéro) seconde, le cookie devient un cookie basé sur la session et expire à la fin de la session de navigateur en cours.
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_expires': 0
});
Mise à jour des cookies
Lorsque cookie_update
est défini sur true
(valeur par défaut), gtag.js met à jour les cookies à chaque chargement de page. Le délai d'expiration des cookies sera alors mis à jour en fonction de la dernière visite sur le site. Par exemple, si le délai d'expiration d'un cookie est défini sur une semaine et qu'un utilisateur visite votre site avec le même navigateur tous les cinq jours, le délai d'expiration du cookie sera mis à jour à chaque visite et n'expirera donc jamais.
Si cette règle est définie sur false
, les cookies ne sont pas mis à jour à chaque chargement de page. En conséquence, l'expiration des cookies dépend de la première visite d'un utilisateur sur le site.
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_update': false
});
Indicateurs pour cookies
Ajoute des indicateurs supplémentaires au cookie lorsqu'il est défini. Les indicateurs doivent être séparés par un point-virgule.
gtag('set', {
'cookie_flags': 'SameSite=None;Secure'
});
Définir l'ID utilisateur
Un ID utilisateur est une chaîne d'ID unique, persistante et ne permettant pas d'identifier personnellement l'utilisateur, qui représente un utilisateur. Il permet d'analyser des groupes de sessions sur plusieurs appareils. Pour découvrir pourquoi vous devez implémenter la fonctionnalité User-ID, consultez la section Avantages de la fonctionnalité User-ID.
Pour implémenter le User-ID avec gtag.js, mettez à jour le config
de votre propriété afin de définir l'User-ID:
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
Ajuster le comportement des balises en fonction du consentement
Vous pouvez configurer gtag.js de sorte qu'il ne lit ni n'écrive de cookies tant que l'utilisateur n'a pas donné son consentement. Pour en savoir plus, consultez Ajuster le comportement des balises en fonction du consentement.