Référence des paramètres du protocole de mesure

Obligatoire pour tous les types d'appels.

Version du protocole. La valeur actuelle est "1". Cette option ne change que lorsque des modifications ne sont pas rétrocompatibles.

Obligatoire pour tous les types d'appels.

ID de suivi / ID de site Web. Le format est le suivant : UA-XXXX-Y. Toutes les données collectées sont associées à cet ID.

Facultatif.

Le cas échéant, l'adresse IP de l'expéditeur est masquée. Par exemple, l'adresse IP sera masquée si l'un des paramètres suivants est présent dans la charge utile: &aip=, &aip=0 ou &aip=1

Facultatif.

Ce paramètre permet de marquer un événement comme désactivé pour la personnalisation des annonces, y compris pour les événements provenant d'une propriété dont le paramètre autorise la personnalisation des annonces. Par exemple, si une transaction est marquée pour désactiver la personnalisation des annonces, elle ne sera pas utilisée pour renseigner une audience de remarketing pour "anciens acheteurs".

Facultatif.

Indique la source de données de l'appel. La source de données des appels envoyés depuis analytics.js sera définie sur "web". Quant aux appels envoyés à partir de l'un des SDK pour mobile, elle sera définie sur "application".

Facultatif.

Permet de collecter les appels hors connexion / latents. La valeur représente le delta (en millisecondes) entre le moment où l'appel signalé se produit et le moment où il est envoyé. La valeur doit être supérieure ou égale à 0. Les valeurs supérieures à quatre heures peuvent empêcher le traitement des appels.

Facultatif.

Permet d'envoyer un nombre aléatoire dans les requêtes GET pour empêcher les navigateurs et les proxys de mettre en cache les appels. Il doit être envoyé en tant que paramètre final de la requête, car nous avons constaté qu'un logiciel de filtrage Internet tiers ajoutait des paramètres supplémentaires à des requêtes HTTP de manière incorrecte. Cette valeur n'est pas utilisée dans les rapports.

Facultatif.

Ce champ est obligatoire si l'ID utilisateur (uid) n'est pas spécifié dans la requête. Cet alias identifie de manière pseudonyme un utilisateur, un appareil ou une instance de navigateur en particulier. Pour le Web, il est généralement stocké sous forme de cookie propriétaire expirant pendant deux ans. Pour les applications mobiles, il est généré de manière aléatoire pour chaque occurrence d'une installation d'application. La valeur de ce champ doit correspondre à un UUID aléatoire (version 4), comme décrit dans le fichier http://www.ietf.org/rfc/rfc4122.txt.

Facultatif.

Ce champ est obligatoire si l'ID client (cid) n'est pas spécifié dans la requête. Il s'agit d'un identifiant connu pour un utilisateur fourni par le propriétaire du site/de la bibliothèque. Il ne doit pas s'agir d'informations personnelles. La valeur ne doit jamais être conservée dans les cookies Google Analytics ni dans tout autre espace de stockage fourni par Analytics.

Facultatif.

Permet de contrôler la durée de la session. Une valeur de "start" force une nouvelle session à démarrer avec cet appel et "end" force la session en cours à se terminer avec cet appel. Toutes les autres valeurs sont ignorées.

Facultatif.

Adresse IP de l'utilisateur. Il doit s'agir d'une adresse IP valide au format IPv4 ou IPv6. Elle sera toujours anonymisée comme si &aip (anonymiser l'adresse IP) avait été utilisé.

Facultatif.

User-agent du navigateur. Notez que Google dispose de bibliothèques permettant d'identifier les véritables user-agents. Vous pouvez bricoler votre propre agent à tout moment.

Facultatif.

Emplacement géographique de l'utilisateur. L'identifiant géographique doit être un code pays à deux lettres ou un identifiant de critère représentant une ville ou une région (voir http://developers.google.com/analytics/devguides/collection/protocol/v1/geoid). Ce paramètre précède tout emplacement dérivé de l'adresse IP, y compris le paramètre "IP Override". Si le code n'est pas valide, les dimensions géographiques seront définies sur "(non défini)".

Facultatif.

Indique la source qui a généré du trafic vers un site Web. Cette valeur est également utilisée pour calculer la source de trafic. Le format de cette valeur est une URL.

Facultatif.

Indique le nom de la campagne.

Facultatif.

Spécifie la source de la campagne.

Facultatif.

Spécifie le support de la campagne.

Facultatif.

Spécifie le mot clé de la campagne.

Facultatif.

Spécifie le contenu de la campagne.

Facultatif.

Spécifie l'ID de la campagne.

Facultatif.

Spécifie l'identifiant d'annonce Google.

Facultatif.

Indique l'ID des annonces display Google.

Facultatif.

Indique la résolution d'écran.

Facultatif.

Spécifie la zone visible du navigateur / de l'appareil.

Facultatif.

Spécifie le jeu de caractères utilisé pour encoder la page ou le document.

Facultatif.

Indique la profondeur de couleur de l'écran.

Facultatif.

Spécifie la langue.

Facultatif.

Indique si Java a été activé.

Facultatif.

Spécifie la version Flash.

Obligatoire pour tous les types d'appels.

Type d'appel. Doit être 'page vue', 'screenview', 'event', 'transaction', 'item', 'social', 'exception', 'timing'.

Facultatif.

Spécifie qu'un appel est considéré comme non interactif.

Facultatif.

Ce paramètre permet d'envoyer l'URL complète (emplacement du document) de la page sur laquelle se trouve le contenu. Vous pouvez utiliser les paramètres &dh et &dp pour remplacer les parties nom d'hôte et chemin + requête de l'emplacement du document, en conséquence. Les clients JavaScript déterminent ce paramètre en utilisant la concaténation des paramètres de navigateur document.location.origin + document.location.pathname + document.location.search. Assurez-vous de supprimer toute authentification de l'utilisateur ou toute autre information privée de l'URL, le cas échéant. Pour les appels de type "page vue", il faut spécifier &dl ou &dh et &dp pour que l'appel soit valide.

Facultatif.

Indique le nom d'hôte à partir duquel le contenu a été hébergé.

Facultatif.

Partie du chemin de l'URL de la page. Doit commencer par "/". Pour les appels de type "page vue", &dl ou &dh et &dp doivent être spécifiés pour que l'appel soit valide.

Facultatif.

Titre de la page / du document.

Obligatoire pour le type d'appel "visionnage à l'écran".

Ce paramètre est facultatif pour les propriétés Web. Il est obligatoire pour les propriétés mobiles pour les appels de type "Visionnage de l'écran", où il est utilisé pour le "Nom à l'écran" de l'appel de visionnage de l'écran. Sur les sites Web, elle est définie par défaut sur l'URL unique de la page en utilisant le paramètre &dl tel quel ou en l'assemblant à partir de &dh et &dp.

Facultatif.

Vous pouvez avoir jusqu'à cinq regroupements de contenu, chacun ayant un index associé compris entre 1 et 5 inclus. Chaque regroupement de contenu peut comporter jusqu'à 100 groupes de contenu. La valeur d'un groupe de contenu est un texte hiérarchique délimité par "/". Toutes les barres obliques au début et à la fin sont supprimées, et les barres obliques répétées sont réduites à une seule. Par exemple, "/a//b/" sera converti en "a/b".

Facultatif.

Il s'agit de l'ID d'un élément DOM ayant enregistré un clic, qui permet de différencier plusieurs liens vers la même URL dans les rapports d'analyse des pages Web lorsque l'attribution améliorée des liens est activée pour la propriété.

Facultatif.

Spécifie le nom de l'application. Ce champ est obligatoire pour tous les appels qui contiennent des données liées à l'application (c'est-à-dire la version, l'ID ou l'ID du programme d'installation de l'application). Pour les appels envoyés à des propriétés Web, ce champ est facultatif.

Facultatif.

Identifiant de l'application.

Facultatif.

Spécifie la version de l'application.

Facultatif.

Identifiant du programme d'installation de l'application.

Obligatoire pour le type d'appel avec événement.

Spécifie la catégorie d'événement. Ce champ ne peut pas être vide.

Obligatoire pour le type d'appel avec événement.

Spécifie l'action d'événement. Ce champ ne peut pas être vide.

Facultatif.

Spécifie le libellé de l'événement.

Facultatif.

Spécifie la valeur de l'événement. Les valeurs ne doivent pas être négatives.

Obligatoire pour le type d'appel de la transaction.
Obligatoire pour le type d'appel "élément".

Identifiant unique de la transaction. Cette valeur doit être identique pour les appels de type "Transaction" et "Éléments" associés à la transaction concernée.

Facultatif.

Spécifie l'affiliation ou le nom du magasin.

Facultatif.

Spécifie le revenu total associé à la transaction. Cette valeur doit inclure tous les frais de port ou de taxe.

Facultatif.

Spécifie les frais de port totaux de la transaction.

Facultatif.

Spécifie la taxe totale de la transaction.

Obligatoire pour le type d'appel "élément".

Spécifie le nom de l'élément.

Facultatif.

Indique le prix d'un seul article / unité.

Facultatif.

Indique le nombre d'articles achetés.

Facultatif.

Indique le code SKU ou le code article.

Facultatif.

Spécifie la catégorie à laquelle appartient l'article.

Facultatif.

Code SKU du produit. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Nom du produit. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Marque associée au produit. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Catégorie à laquelle le produit appartient. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Le paramètre de catégorie de produit peut être hiérarchique. Utilisez / comme délimiteur pour spécifier jusqu'à cinq niveaux de hiérarchie. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Variante du produit. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Prix unitaire d'un produit. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Quantité d'un produit. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Code promotionnel associé à un produit. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Position du produit dans une liste ou une collection. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Une dimension personnalisée au niveau du produit où l'index de dimension est un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Métrique personnalisée au niveau du produit où l'index de métrique est un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Rôle des produits inclus dans un appel. Si aucune action sur le produit n'est spécifiée, toutes les définitions de produits incluses dans l'appel seront ignorées. Doit être l'un des suivants: detail, click, add, remove, checkout, checkout_option, purchase, refund. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

ID de la transaction. Il s'agit d'un paramètre supplémentaire qui peut être envoyé lorsque l'action sur le produit est définie sur "achat" ou "remboursement". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Le magasin ou l'affiliation depuis lequel cette transaction a été produite. Il s'agit d'un paramètre supplémentaire qui peut être envoyé lorsque l'action sur le produit est définie sur "achat" ou "remboursement". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Valeur totale de la transaction, taxes et frais de livraison inclus Si elle n'est pas envoyée, cette valeur est calculée automatiquement sur la base des champs de quantité et de prix de tous les produits contenus dans le même appel. Il s'agit d'un paramètre supplémentaire qui peut être envoyé lorsque l'action sur le produit est définie sur "achat" ou "remboursement". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Montant total des taxes associées à la transaction. Il s'agit d'un paramètre supplémentaire qui peut être envoyé lorsque l'action sur le produit est définie sur "achat" ou "remboursement". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Frais de port associés à la transaction. Il s'agit d'un paramètre supplémentaire qui peut être envoyé lorsque l'action sur le produit est définie sur "achat" ou "remboursement". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Bon de réduction utilisé lors de la transaction. Il s'agit d'un paramètre supplémentaire qui peut être envoyé lorsque l'action sur le produit est définie sur "achat" ou "remboursement". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Liste ou collection à partir de laquelle une action a été effectuée sur le produit. Il s'agit d'un paramètre supplémentaire qui peut être envoyé lorsque l'action "Product" est définie sur "detail" ou "click". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Numéro d'étape d'un entonnoir de paiement. Il s'agit d'un paramètre supplémentaire qui peut être envoyé lorsque l'action "Product" est définie sur "checkout". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Informations supplémentaires sur une étape de règlement. Il s'agit d'un paramètre supplémentaire qui peut être envoyé lorsque l'action "Product" est définie sur "checkout". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Liste ou collection à laquelle appartient un produit. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

ID produit ou SKU. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Nom du produit. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Marque associée au produit. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Catégorie à laquelle le produit appartient. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Variante du produit. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Position du produit dans une liste ou une collection. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Prix d'un produit. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Une dimension personnalisée au niveau du produit où l'index de dimension est un entier positif compris entre 1 et 200 inclus. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Métrique personnalisée au niveau du produit où l'index de métrique est un entier positif compris entre 1 et 200 inclus. L'index de la liste d'impressions doit être un entier positif compris entre 1 et 200 inclus. L'index de produit doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

ID de la promotion. L'index de promotion doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Nom de la promotion. L'index de promotion doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Création associée à la promotion. L'index de promotion doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Position de la création. L'index de promotion doit être un entier positif compris entre 1 et 200 inclus. Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Spécifie le rôle des promotions incluses dans un appel. Si aucune action de promotion n'est spécifiée, l'action par défaut "afficher" est utilisée. Pour mesurer le nombre de clics d'utilisateurs sur une promotion, définissez ce paramètre sur "promo_click". Pour analytics.js, vous devez installer le plug-in de commerce électronique amélioré avant d'utiliser ce champ.

Facultatif.

Lorsqu'il est présent, indique la devise locale pour toutes les valeurs de devise de la transaction. La valeur doit correspondre à un code de devise ISO 4217 valide.

Obligatoire pour le type d'appel sur les réseaux sociaux.

Indique le réseau social, par exemple Facebook ou Google Plus.

Obligatoire pour le type d'appel sur les réseaux sociaux.

Spécifie l'action d'interaction sur les réseaux sociaux. Par exemple, sur Google Plus, lorsqu'un utilisateur clique sur le bouton +1, l'action sur un réseau social est "plus".

Obligatoire pour le type d'appel sur les réseaux sociaux.

Spécifie la cible d'une interaction sur les réseaux sociaux. Il s'agit généralement d'une URL, mais il peut s'agir de n'importe quel texte.

Obligatoire pour définir le type d'appel de la durée.

Spécifie la catégorie de temps utilisateur.

Obligatoire pour définir le type d'appel de la durée.

Spécifie la variable de temps utilisateur.

Obligatoire pour définir le type d'appel de la durée.

Spécifie la valeur de temps utilisateur. La valeur est exprimée en millisecondes.

Facultatif.

Spécifie le libellé de temps utilisateur.

Facultatif.

Indique le temps nécessaire au chargement d'une page. La valeur est exprimée en millisecondes.

Facultatif.

Indique le temps nécessaire pour effectuer une résolution DNS.La valeur est exprimée en millisecondes.

Facultatif.

Indique le temps nécessaire au téléchargement de la page. La valeur est exprimée en millisecondes.

Facultatif.

Indique le délai de déclenchement des redirections. La valeur est exprimée en millisecondes.

Facultatif.

Indique le temps nécessaire pour établir une connexion TCP. La valeur est exprimée en millisecondes.

Facultatif.

Indique le délai de réponse du serveur après la connexion. La valeur est exprimée en millisecondes.

Facultatif.

Spécifie le temps nécessaire à l'état "interactive" de Document.readyState. La valeur est exprimée en millisecondes.

Facultatif.

Indique le délai de déclenchement de l'événement DOMContentLoaded. La valeur est exprimée en millisecondes.

Facultatif.

Spécifie la description d'une exception.

Facultatif.

Indique si l'exception était fatale.

Facultatif.

Chaque dimension personnalisée est associée à un index. Le nombre de dimensions personnalisées est limité à 20 (200 pour les comptes Analytics 360). L'index de la dimension doit être un entier positif compris entre 1 et 200 inclus.

Facultatif.

Chaque métrique personnalisée est associée à un index. Le nombre de métriques personnalisées est limité à 20 (200 pour les comptes Analytics 360). L'index de métrique doit être un entier positif compris entre 1 et 200 inclus.