Documentation de référence sur le protocole de mesure

Cette page décrit le mécanisme de transport et les paramètres de données du protocole de mesure.

Transport

Toutes les données doivent être envoyées de manière sécurisée à l'aide de requêtes POST HTTPS.

Envoyez des requêtes au point de terminaison suivant:

https://www.google-analytics.com/mp/collect

Si vous souhaitez que vos données soient traitées dans l'UE, utilisez plutôt le point de terminaison suivant:

https://region1.google-analytics.com/mp/collect

Voici un exemple de requête POST:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
PAYLOAD_DATA

Remplacez PAYLOAD_DATA par la charge utile de la requête.

Le protocole de mesure renvoie un code d'état 2xx si la requête HTTP est reçue. Le protocole de mesure ne renvoie pas de code d'erreur si la charge utile est incorrecte, ou si les données sont incorrectes ou non traitées par Google Analytics.

Charge utile

La charge utile se compose de deux parties:

  1. Paramètres de requête.
  2. Corps POST JSON.

Paramètres de requête

Nom du paramètre Description

api_secret

 Obligatoire. Le code secret de l'API de l'UI Google Analytics.

Vous le trouverez sous Administration > Flux de données > Choisissez votre flux > Protocole de mesure > Créer.

Privées pour votre organisation Doit être mis à jour régulièrement pour éviter un spam excessif.

Corps POST JSON

Clé Type Description

user_id

 string

Facultatif. identifiant unique d'un utilisateur. Pour en savoir plus sur cet identifiant, consultez User-ID pour l'analyse multiplate-forme. Ne peut contenir que des caractères UTF-8.

timestamp_micros

 number

Facultatif. Code temporel Unix, en microsecondes, et non en millisecondes. Représente l'heure de l'événement. Doit être défini uniquement pour enregistrer les événements qui se sont produits Peut être remplacé par des codes temporels user_property ou d'événement. Les événements peuvent être rétrodatés jusqu'à trois jours calendaires en fonction du fuseau horaire de l'établissement.

user_properties

 object Facultatif. Les propriétés utilisateur pour la mesure.

user_data

 object Facultatif. Données fournies par l'utilisateur
object Facultatif. Paramètres de consentement pour la requête. Pour en savoir plus, consultez la section Consentement.

non_personalized_ads

 boolean Facultatif. Définissez la valeur sur true pour indiquer que les données de l'utilisateur ne doivent pas être utilisées pour les annonces personnalisées.

user_location

 object Facultatif. Définit les informations géographiques de la requête dans un format structuré.

ip_override

 string Facultatif. Adresse IP utilisée par Google Analytics pour déduire des informations géographiques pour la requête.

events[]

 array Obligatoire. Tableau d'éléments event. Vous pouvez envoyer jusqu'à 25 événements par requête. Consultez la documentation de référence sur les événements pour connaître tous les événements valides.

events[].name

 string Obligatoire. Nom de l'événement. Pour toutes les options, consultez Événements.

events[].params

 object Facultatif. Paramètres de l'événement. Consultez Événements pour connaître les paramètres suggérés pour chaque événement.

L'attribut consent configure les types et les états de consentement. Si vous ne spécifiez pas consent, Google Analytics utilise les paramètres de consentement des interactions en ligne correspondantes pour le client ou l'instance de l'application.

Clé Type Description

ad_user_data

 string

Facultatif. Consentement pour l'envoi de données utilisateur provenant des événements et des propriétés utilisateur de la requête à Google à des fins publicitaires.

GRANTED ou DENIED.

ad_personalization

 string

Facultatif. Consentement de l'utilisateur pour la publicité personnalisée.

GRANTED ou DENIED.

Informations géographiques

Les attributs user_location et ip_override fournissent des informations géographiques. user_location est prioritaire sur ip_override.

Voici la structure du champ user_location. Fournissez autant d'attributs que possible. Nous vous recommandons d'utiliser au moins country_id et region_id.

Clé Type Description

city

 string Facultatif. Nom de la ville.

region_id

 string Facultatif. Pays et subdivision ISO 3166. Par exemple, US-CA, US-AR, CA-BC, GB-LND, CN-HK.

country_id

 string Facultatif. Pays au format ISO 3166-1 alpha-2. Exemple : US, AU, ES, FR.

subcontinent_id

 string Facultatif. Sous-continent au format UN M49. Par exemple, 011, 021, 030, 039.

continent_id

 string Facultatif. Continent au format UN M49. Par exemple, 002, 019, 142, 150.

Voici un exemple de user_location:

"user_location:" {
  "city:" "Mountain View",
  "region_id:" "US-CA",
  "country_id:" "US",
  "subcontinent_id:" "021",
  "continent_id:" "019"
}

ip_override est une alternative à user_location. Si vous envoyez plutôt ip_override, Google Analytics déduit des informations géographiques à partir de l'adresse IP. Si vous envoyez user_location, Google Analytics ignore ip_override.

Si vous n'envoyez pas user_location ou ip_override, Google Analytics dérive des informations géographiques à partir des événements de taggage à l'aide de client_id.

Google Analytics applique les paramètres des données de localisation précises de la propriété à la requête, quelles que soient les informations géographiques envoyées.

Paramètres personnalisés

Vous pouvez inclure des paramètres personnalisés de portée utilisateur, d'événement et d'article dans une charge utile du protocole de mesure.

  • Vous pouvez inclure des paramètres personnalisés de portée utilisateur dans user_properties.
  • Les paramètres personnalisés de portée événement peuvent être inclus dans events[].params.
  • Les paramètres personnalisés de portée article peuvent être inclus dans items.

Certains événements comportent des paramètres recommandés. Pour connaître les paramètres recommandés pour tous les événements compatibles, consultez Événements.

Noms réservés

Certains noms d'événements, de paramètres et de propriétés utilisateur sont réservés et ne peuvent pas être utilisés:

Noms d'événements réservés

Les noms d'événements suivants sont réservés et ne peuvent pas être utilisés:

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_query
  • ad_reward
  • adunit_exposure
  • app_clear_data
  • app_exception
  • app_install
  • app_remove
  • app_store_refund
  • app_update
  • app_upgrade
  • dynamic_link_app_open
  • dynamic_link_app_update
  • dynamic_link_first_open
  • error
  • firebase_campaign
  • firebase_in_app_message_action
  • firebase_in_app_message_dismiss
  • firebase_in_app_message_impression
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • notification_send
  • os_update
  • session_start
  • user_engagement

Noms de paramètres réservés

Les noms de paramètres suivants sont réservés et ne peuvent pas être utilisés:

  • firebase_conversion

Les noms de paramètres ne peuvent pas commencer par les éléments suivants:

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

Noms de propriétés utilisateur réservés

Les noms de propriétés utilisateur suivants sont réservés et ne peuvent pas être utilisés:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

De plus, les noms de propriétés utilisateur ne peuvent pas commencer par:

  • _ (underscore)
  • firebase_
  • ga_
  • google_