Ce guide vous explique comment envoyer des événements de flux Web et d'application au protocole de mesure Google Analytics à un serveur Google Analytics afin de pouvoir afficher les événements du protocole de mesure dans vos rapports Google Analytics.
Choisissez la plate-forme que vous souhaitez voir dans ce guide:
Mettre en forme la requête
Le protocole de mesure pour Google Analytics 4 n'accepte que les requêtes HTTP POST
.
Pour envoyer un événement, utilisez le format suivant:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
Vous devez fournir les éléments suivants dans l'URL de la requête:
api_secret
: le SECRET de l'API 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.
measurement_id
: ID de mesure associé à un flux, disponible dans l'interface utilisateur Google Analytics sous Administration > Flux de données > choisir votre flux > ID de mesure.measurement_id
n'est pas votre ID de flux.
Pour en savoir plus, consultez la section Paramètres de requête.
Vous devez fournir les éléments suivants dans le corps de la requête:
client_id
: identifiant unique d'un client. Cette méthode diffère d'un objetapp_instance_id
Firebase. Utilisez gtag.js('get').
user_id
: facultatif. Identifiant unique d'un utilisateur. Ne peut contenir que des caractères utf-8. Pour en savoir plus sur cet identifiant, consultez la section User-ID pour l'analyse multiplate-forme.consent
: facultatif. Découvrez comment définir les paramètres de consentement.events
: tableau d'éléments d'événement. Vous pouvez inclure plusieurs événements dans une même requête.Pour que l'activité des utilisateurs s'affiche dans des rapports tels que Temps réel,
engagement_time_msec
etsession_id
doivent être fournis dans leparams
d'unevent
. Le paramètreengagement_time_msec
doit refléter la durée d'engagement de l'événement en millisecondes.Exemple :
{
"client_id": "123456.7654321",
"events": [
{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink",
"session_id": "123",
"engagement_time_msec": "100"
}
}
]
}
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
. Découvrez comment les sessions sont comptabilisées.
Essayer
Voici un exemple permettant d'envoyer un événement tutorial_begin
à votre serveur Google Analytics:
const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
client_id: 'XXXXXXXXXX.YYYYYYYYYY',
events: [{
name: 'tutorial_begin',
params: {},
}]
})
});
Limites
Les limites suivantes s'appliquent à l'envoi d'événements du protocole de mesure à Google Analytics:
- Les requêtes ne peuvent pas comporter plus de 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, ne peuvent 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ètres incluant les paramètres d'élément ne doivent pas comporter plus de 40 caractères, 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 incluant les valeurs de paramètre d'article doivent comporter 100 caractères ou moins pour une propriété Google Analytics 4 standard, et 500 caractères ou moins pour une propriété Google Analytics 360.
- Les paramètres d'élément ne peuvent pas comporter plus de 10 paramètres personnalisés.
- La taille du corps du post doit être inférieure à 130 Ko.
- L'attribution au niveau de l'événement à partir des événements du protocole de mesure est acceptée jusqu'à 63 jours après le dernier événement d'ajout de balises en ligne pour l'exportation des conversions vers Ads et les intégrations de médias, même si la période de suivi de la conversion pour l'événement de conversion est supérieure à 63 jours. En revanche, l'attribution au niveau des événements pour l'ajout de tags aux événements en ligne est compatible avec toute la période de suivi des conversions.
- À des fins de remarketing, vous pouvez associer des événements du protocole de mesure jusqu'au nombre de jours suivant l'événement en ligne le plus récent avec un cookie ou un ID d'appareil associé :
- Flux Web: 30 jours
- Flux d'application: 42 jours
- Les événements du protocole de mesure des applications envoyés à Google Analytics 4 ne renseignent pas les audiences sur le Réseau de Recherche dans Google Ads pour les utilisateurs d'applications.