Cookies et identification des utilisateurs avec gtag.js

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.

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
});

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'
});

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'
});

À 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
});

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
});

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'
});

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.