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.

Configurer les paramètres des champs de cookies

Le tableau suivant présente les valeurs de champ de cookie par défaut utilisées par gtag.js:

Pour modifier l'une de ces valeurs, mettez à jour le config pour votre propriété afin de les 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

Par défaut, la configuration automatique du domaine de cookie est activée pour gtag.js. Lorsque cette option est activée, gtag.js définit des cookies sur le domaine de premier niveau. Par exemple, si l'adresse de votre site Web est blog.example.com, gtag.js définit 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', ce qui entraîne la définition de cookies par gtag.js en utilisant le domaine complet à partir de l'emplacement du document.

Pour désactiver la configuration automatique du domaine de cookie, mettez à jour config pour 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 des cookies, qui sera ajouté aux 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:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

Expiration des cookies

À chaque chargement de page, le délai d'expiration des cookies 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 visite le même navigateur dans un délai de cinq jours, le cookie sera disponible pendant une semaine supplémentaire et apparaîtra comme le même visiteur dans Google Analytics. Si ce même utilisateur a effectué la visite après l'expiration du cookie d'origine, un nouveau cookie est créé, et sa première et sa deuxième visite apparaissent comme provenant de visiteurs distincts dans Google Analytics.

Si vous définissez la valeur cookie_expires sur 0 (zéro) seconde, le cookie se transforme en 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 l'expiration des cookies est définie sur une semaine et qu'un utilisateur visite le même navigateur tous les cinq jours, le délai d'expiration des cookies est mis à jour à chaque visite et n'expire jamais.

Lorsque ce paramètre est défini sur false, les cookies ne sont pas mis à jour lors de chaque chargement de page. 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 options doivent être séparées par un point-virgule.

gtag('set', {
  'cookie_flags': 'SameSite=None;Secure'
});

Définir un ID utilisateur

Un ID utilisateur est une chaîne d'ID unique, persistante et non personnelle qui représente un utilisateur. Il permet d'analyser des groupes de sessions sur plusieurs appareils. Pour savoir pourquoi il est recommandé d'intégrer 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 le 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 pour qu'il ne lise ou n'écrive des cookies tant que l'utilisateur n'a pas accordé son consentement. Pour en savoir plus, consultez Ajuster le comportement des balises en fonction du consentement.