Envoi d'événements

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Présentation

Ce guide explique comment mettre en forme et envoyer des requêtes au protocole de mesure Google Analytics.

Envoi d'événements

Pour envoyer un événement, envoyez une requête POST HTTP au point de terminaison suivant:

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

Paramètres obligatoires

Une requête valide nécessite deux ensembles de paramètres qui varient si vous utilisez Firebase ou gtag.js:

  1. Paramètres d'URL

    • api_secret - Obligatoire. Un élément API SECRET généré dans l'interface utilisateur de Google Analytics. Pour créer un secret, accédez à:
      Administration > Flux de données > choisir votre flux > Protocole de mesure > Créer

    Pour en savoir plus, consultez la section Paramètres de requête.

  2. Corps JSON

    • user_id : facultatif. Identifiant unique d'un utilisateur. Pour en savoir plus sur cet identifiant, consultez la section User-ID pour l'analyse multiplate-forme.

    • events - Obligatoire. Tableau des éléments d'événement.

    Pour en savoir plus, consultez la section BODY POST JSON.

Pour que l'activité des utilisateurs s'affiche dans les rapports standards tels que "Temps réel", les champs engagement_time_msec et session_id doivent être fournis dans le cadre d'un params pour un event.

Exemple :

{
"client_id": "x",
"events": [
  {
    "name": "offline_purchase",
    "params": {
      "engagement_time_msec": "100",
      "session_id": "123"
    }
  }
]
}

Bien que session_start soit un nom d'événement réservé, la création d'un session_id crée une session sans qu'il soit nécessaire d'envoyer session_start.

Envoyer un événement

Pour envoyer un événement tutorial_begin, exécutez la requête suivante:

Limites

  • Les requêtes peuvent contenir jusqu'à 25 événements.
  • Les événements ne doivent pas inclure plus de 25 paramètres.
  • Les événements ne doivent pas inclure plus de 25 propriétés utilisateur.
  • Les noms de propriétés utilisateur ne doivent pas dépasser 24 caractères.
  • Les valeurs des propriétés utilisateur ne doivent pas dépasser 36 caractères.
  • Les noms d'événements ne doivent pas dépasser 40 caractères. Ils ne doivent contenir que des caractères alphanumériques et des traits de soulignement, et doivent commencer par un caractère alphabétique.
  • Les noms de paramètre (y compris les paramètres d'article) ne doivent pas dépasser 40 caractères. Ils ne peuvent contenir que des caractères alphanumériques et des traits de soulignement, et doivent commencer par un caractère alphabétique.
  • Les valeurs de paramètres (y compris les valeurs des paramètres d'article) doivent comporter 100 caractères au maximum.
  • Vous ne pouvez pas définir plus de 10 paramètres personnalisés.
  • Le corps du post doit être inférieur à 130 Ko.