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:
Paramètres d'URL
api_secret
- Obligatoire. Un élémentAPI 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.
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.
Paramètres recommandés pour les rapports
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.