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 HTTPS POST.

Envoyez des requêtes au point de terminaison suivant :

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

Si vous souhaitez que vos données soient collecté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 Payload 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 mal formée, ou si les données sont incorrectes ou ne sont pas traitées par Google Analytics.

Charge utile

La charge utile se compose de deux parties :

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

Paramètres de requête

Corps POST JSON

Paramètres d'événement courants

Le protocole de mesure comporte les paramètres d'événement courants suivants :

Consentement

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 l'instance client ou d'application.

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.

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 ip_override, Google Analytics déduit les informations géographiques de l'adresse IP. Si vous envoyez user_location, Google Analytics ignore ip_override.

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

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

Informations sur l'appareil

Pour envoyer des informations sur l'appareil, utilisez le champ device. Voici la structure du champ device. Fournissez autant d'attributs que possible. Nous vous recommandons de définir au moins category.

L'extrait suivant montre un exemple de paramètres device :

"device": {
  "category": "mobile",
  "language": "en",
  "screen_resolution": "1280x2856",
  "operating_system": "Android",
  "operating_system_version": "14",
  "model": "Pixel 9 Pro",
  "brand": "Google",
  "browser": "Chrome",
  "browser_version": "136.0.7103.60"
}

Que vous spécifiiez Google Analytics applique les paramètres de données détaillées sur les appareils de la propriété à la requête.

Comportement de validation

L'attribut validation_behavior contrôle la façon dont le protocole de mesure valide le contenu de la requête.

• La validation RELAXED ne rejette que les requêtes mal formées. Il peut toujours accepter les événements et les paramètres dont les noms de champs ne sont pas valides ou dont les données ne sont pas du bon type, mais il ignore les paramètres qui dépassent les limites. Le protocole de mesure utilise la validation RELAXED par défaut.
• La validation ENFORCE_RECOMMENDATIONS rejette les paramètres d'événement et d'article qui ne sont pas du bon type ou qui contiennent des paramètres qui dépassent les limites. De plus, ENFORCE_RECOMMENDATIONS rejette toute propriété d'événement ou d'utilisateur dont le code temporel ne se situe pas dans les dernières 72 heures.

Nous recommandons l'approche suivante :

• Utilisez ENFORCE_RECOMMENDATIONS lorsque vous validez des événements pour obtenir autant de commentaires que possible sur les problèmes potentiels liés à vos demandes.

  Vous pouvez également valider les requêtes à l'aide de l'outil de création d'événements, car il spécifie ENFORCE_RECOMMENDATIONS lors de la validation des requêtes.

• Ne spécifiez pas validation_behavior lorsque vous envoyez des événements pour minimiser les données rejetées par le protocole de mesure.

  Si vous souhaitez privilégier la validation stricte par rapport à la collecte de données lorsque vous envoyez une requête particulière, ajoutez le champ validation_behavior et définissez-le sur ENFORCE_RECOMMENDATIONS.

Paramètres personnalisés

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

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

Valeurs recommandées pour certains événements

Certains événements ont des paramètres recommandés. Consultez Événements pour connaître les paramètres recommandés pour tous les événements acceptés.

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
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• notification_send
• os_update
• session_start
• user_engagement

De plus, les événements ad_impression, in_app_purchase et screen_view ne sont autorisés que pour les flux d'applications.

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 :

• _ (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_