Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Le protocole de mesure Google Analytics vous permet d'envoyer des données hors connexion à votre flux Web ou d'application, en plus des données que vous collectez déjà avec le taggage ou le SDK Firebase.
Ce guide décrit les cas d'utilisation courants du protocole de mesure Google Analytics et leurs exigences.
Résumé des exigences
Ce tableau offre un aperçu rapide des exigences pour chaque cas d'utilisation. Pensez à appliquer les bonnes pratiques suivantes :
Le timestamp_micros des événements et des propriétés utilisateur correspond par défaut à la date/l'heure de la requête. Lorsque vous envoyez une modification d'événement ou de propriété utilisateur qui s'est produite dans le passé, remplacez le code temporel dans les guides sur l'envoi d'événements et les propriétés utilisateur.
Pour obtenir des métriques d'engagement et des rapports "Temps réel" précis, incluez le paramètre d'événement engagement_time_msec défini selon le nombre de millisecondes écoulées depuis l'événement précédent.
Cas d'utilisation
ID de session
Exigences concernant la date/l'heure de la requête
Exigence timestamp_micros
Attribution d'un User-ID à des événements
Obligatoire
<= fin du jour ouvré du début de la session
>= début de la session et <= fin de la session
Attribution de la session
Obligatoire
<= début de la session + 24 heures
>= début de la session et <= fin de la session
Exportation d'événements vers des plates-formes publicitaires
Non obligatoire
<= jour ouvré de la dernière session + 63 jours
>= date/heure de la requête moins deux jours ouvrés et <= date/heure de la requête
Envoyer des événements ou des propriétés utilisateur pour créer une audience
Non obligatoire
Web : <= date/heure du dernier événement en ligne + 30 jours
Application : <= date/heure du dernier événement en ligne + 42 jours
>= date/heure de la requête moins deux jours ouvrés et <= date/heure de la requête
Attribution d'un User-ID à des événements
Utilisez le protocole de mesure pour fournir un User-ID aux événements en ligne ou hors connexion.
Voici quelques exemples d'utilisation de l'ajout d'un User-ID à un événement :
Votre mesure en ligne ne dispose pas des informations nécessaires pour rechercher l'User-ID des événements en ligne, mais vous disposez d'un pipeline de traitement des événements capable d'établir l'association entre une session en ligne et un User-ID.
Dans ce scénario, vous utilisez le protocole de mesure pour fournir des événements en ligne avec un User-ID.
Vous ne disposez pas de l'ID utilisateur pour les événements que vous envoyez avec le protocole de mesure, mais vous souhaitez que ces événements soient associés à un ID utilisateur si l'utilisateur s'est connecté en ligne au cours de la session.
Dans ce scénario, vous utilisez des événements en ligne pour fournir des événements Protocole de mesure avec un User-ID.
Voici les conditions requises pour ajouter un User-ID à un événement :
Incluez session_id dans la liste des paramètres de l'événement.
Envoyez les événements du protocole de mesure le même jour ouvré que la session en ligne.
Si vous remplacez timestamp_micros, définissez-le sur un code temporel compris entre l'heure de début et l'heure de fin de la session en ligne.
Si votre objectif est de fournir un User-ID pour les événements en ligne, définissez user_id dans la requête.
Si votre objectif est que chaque événement du protocole de mesure dispose de l'User-ID de sa session en ligne correspondante, vous n'avez pas besoin de définir user_id.
Attribution de la session
Les événements du protocole de mesure qui répondent à des exigences spécifiques apparaissent dans les rapports avec les mêmes attributs de session (tels que les informations géographiques, la source, le support et la campagne) que les événements en ligne de la même session.
Voici les exigences concernant l'attribution de session :
Incluez session_id dans la liste des paramètres de l'événement.
Envoyez la demande au plus tard 24 heures après le début de la session en ligne.
Par exemple, si la session a commencé le lundi à 11h15 dans le fuseau horaire de votre propriété, envoyez la demande avant le mardi à 11h15.
Si vous remplacez timestamp_micros, définissez-le sur un code temporel compris entre l'heure de début et l'heure de fin de la session en ligne.
Exportation d'événements vers des plates-formes publicitaires
Google Analytics inclut les événements que vous envoyez à l'aide du protocole de mesure dans les exportations vers les produits publicitaires associés, tels que Google Ads ou Campaign Manager 360.
Voici quelques scénarios courants dans lesquels cette fonctionnalité est utile :
Votre entreprise organise des événements hors connexion que vous souhaitez inclure dans l'attribution et les rapports publicitaires.
Vous disposez d'événements supplémentaires dans un système qui n'est pas disponible pour le taggage ni le SDK Firebase, mais vous souhaitez tout de même inclure ces événements dans les produits associés.
Voici les exigences à respecter pour exporter des événements vers des plates-formes publicitaires :
Envoyez la demande au plus tard à la fin du jour ouvré 63 jours après le dernier événement en ligne, même si la période d'attribution de l'événement clé est supérieure à 63 jours.
Par exemple, si le dernier événement en ligne pour client_id ou app_instance_id a eu lieu le 1er mars, envoyez l'événement du protocole de mesure au plus tard à la fin de la journée ouvrée du 3 mai.
Si vous remplacez timestamp_micros, définissez-le sur un code temporel datant des trois derniers jours ouvrés.
Envoi d'événements ou de propriétés utilisateur pour créer l'audience
Les événements et les propriétés utilisateur envoyés à l'aide du protocole de mesure sont inclus dans l'évaluation des conditions d'audience si vous respectez quelques exigences.
Voici les conditions requises pour envoyer des événements ou des propriétés utilisateur afin de créer une audience :
Envoyez la demande à un flux Web au plus tard à la fin du jour ouvré 30 jours après le dernier événement en ligne pour le même client_id.
Par exemple, si le dernier événement en ligne pour client_id a eu lieu le 1er mars, envoyez l'événement du protocole de mesure au plus tard à la fin de la journée du 31 mars.
Envoyez la demande à un flux d'applications au plus tard à la fin du jour ouvré 42 jours après le dernier événement en ligne pour le même app_instance_id.
Par exemple, si le dernier événement en ligne pour app_instance_id a eu lieu le 1er mars, envoyez l'événement du protocole de mesure au plus tard à la fin de la journée du 12 avril.
Si vous remplacez timestamp_micros, définissez-le sur un code temporel datant des trois derniers jours ouvrés.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/08 (UTC).
[null,null,["Dernière mise à jour le 2025/08/08 (UTC)."],[[["\u003cp\u003eThe Google Analytics Measurement Protocol allows you to send offline data, supplementing your existing online data collection.\u003c/p\u003e\n"],["\u003cp\u003eThis protocol enables you to assign User IDs to events, attribute sessions, export events for advertising, and leverage data for audience creation within Google Analytics.\u003c/p\u003e\n"],["\u003cp\u003eSpecific requirements, including session IDs and timestamps, must be met for each use case to ensure data accuracy and integration with online data.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided tables and guidelines for detailed requirements and best practices for each use case, such as session attribution and audience creation.\u003c/p\u003e\n"],["\u003cp\u003eAdhering to these guidelines ensures accurate reporting, attribution, and audience creation based on both online and offline data within your Google Analytics property.\u003c/p\u003e\n"]]],["The Google Analytics Measurement Protocol allows sending offline data to web or app streams. Key actions include: assigning User-IDs to events (requiring a `session_id`, same-day processing, and specific `timestamp_micros`), attributing sessions (requiring `session_id` and submission within 24 hours of session start), exporting events to advertising platforms (no `session_id` required, must be sent within 63 days of the last online event), and using data for audience creation (no `session_id`, web data must be sent within 30 days and app data within 42 days of the last event).\n"],null,["# Measurement protocol use cases\n\nThe Google Analytics Measurement Protocol lets you send offline data to your Web or App stream, in\naddition to the data you're already collecting with tagging or the Firebase SDK.\n\nThis guide describes common Google Analytics Measurement Protocol use cases and their requirements.\n| **Key Term:** In this guide, \"business day\" is the business day of an event or session in the [time zone of your property](//support.google.com/adsense/answer/9830725).\n\nSummary of requirements\n-----------------------\n\nThis table provides a quick reference of the requirements for each use\ncase. Keep the following best practices in mind:\n\n1. The `timestamp_micros` of events and user properties defaults to the request\n time. When sending an event or user property change that occurred in the\n past, override the timestamp as described in the [sending events](/analytics/devguides/collection/protocol/ga4/sending-events) guide and\n the [user properties](/analytics/devguides/collection/protocol/ga4/user-properties) guide.\n\n2. For accurate Realtime reports and engagement metrics, include the\n `engagement_time_msec` event parameter set to the milliseconds elapsed since\n the preceding event.\n\n| Use case | Session ID | Request time requirement | `timestamp_micros` requirement |\n|------------------------------------------------------|--------------|-----------------------------------------------------------------------------------------|---------------------------------------------------------------|\n| Assign User-ID to events | Required | \\\u003c= end of the session start's business day | \\\u003e= session start and \\\u003c= session end |\n| Session attribution | Required | \\\u003c= session start + 24 hours | \\\u003e= session start and \\\u003c= session end |\n| Export events to advertising platforms | Not required | \\\u003c= last session business day + 63 days | \\\u003e= request time minus two business days and \\\u003c= request time |\n| Send events or user properties for audience creation | Not required | Web: \\\u003c= latest online event time + 30 days App: \\\u003c= latest online event time + 42 days | \\\u003e= request time minus two business days and \\\u003c= request time |\n\nAssign User-ID to events\n------------------------\n\nUse the Measurement Protocol to provide online or offline events with a\n[User-ID](//support.google.com/analytics/answer/9213390).\n\nHere are some example use cases for adding a User-ID to an event:\n\n1. Your online measurement lacks the information needed to look up the\n User-ID for online events, but you have an event-processing pipeline that\n is able to make the association between an online session and a User-ID.\n\n In this scenario, you are using the Measurement Protocol to provide\n *online* events with a User-ID.\n2. You don't have the User-ID for events you are sending with the\n Measurement Protocol, but you want those events to be associated with a\n User-ID if the user logged in online over the course of the session.\n\n In this scenario, you are using online events to provide\n *Measurement Protocol* events with a User-ID.\n\nHere are the requirements to add a User-ID to an event:\n\n- Include the `session_id` in the event's parameter list.\n- Send the Measurement Protocol events on the *same business day* as the online session.\n- If you override `timestamp_micros`, set it to a timestamp between the start and end time of the online session.\n- If your goal is to provide User-ID for online events, set the `user_id` in the request.\n- If your goal is for each Measurement Protocol event to have the User-ID from its corresponding online session, you don't need to set `user_id`.\n\nSession attribution\n-------------------\n\nMeasurement Protocol events that meet specific requirements appear in reports\nwith the same session attributes (such as geographic information, source,\nmedium, and campaign) as online events from the same session.\n\nHere are the requirements for session attribution:\n\n- Include the `session_id` in the event's parameter list.\n- Send the request no later than 24 hours after the start of the online\n session.\n\n For example, if the session started at 11:15 AM on Monday in your property's\n time zone, send the request before 11:15 AM on Tuesday.\n- If you override `timestamp_micros`, set it to a timestamp between the\n start and end time of the online session.\n\nExport events to advertising platforms\n--------------------------------------\n\nGoogle Analytics includes the events you send using Measurement Protocol\nin exports to linked advertising products such as Google Ads or Campaign Manager\n360.\n| **Tip:** This use case doesn't require `session_id`.\n\nA few common scenarios where this is useful include:\n\n- Your business has offline events that you want included in advertising attribution and reporting.\n- You have additional events in a system that is not available to tagging or the Firebase SDK, but you still want to include those events in linked products.\n\nHere are the requirements to export events to advertising platforms:\n\n- Send the request no later than the end of the business day 63 days after\n the latest online event, even if the key event's attribution window is more\n than 63 days.\n\n For example, if the latest online event for the `client_id` or\n `app_instance_id` occurred on March 1, send the Measurement Protocol\n event no later than the end of the business day on May 3.\n- If you override `timestamp_micros`, set it to a timestamp within the last\n three business days.\n\nSend events or user properties for audience creation\n----------------------------------------------------\n\nEvents and user properties sent using Measurement Protocol are included in\nthe evaluation of [audience conditions](//support.google.com/analytics/answer/9267572) if you adhere to a few requirements.\n| **Tip:** This use case doesn't require `session_id`.\n\nHere are the requirements to send events or user properties for audience\ncreation:\n\n- Send the request to a Web stream no later than the end of the business day\n 30 days after the latest online event for the same `client_id`.\n\n For example, if the latest online event for the `client_id` occurred on\n March 1, send the Measurement Protocol event no later than the end of the\n business day on March 31.\n- Send the request to an App stream no later than the end of the business day\n 42 days after the latest online event for the same `app_instance_id`.\n\n For example, if the latest online event for the `app_instance_id` occurred\n on March 1, send the Measurement Protocol event no later than the end of\n the business day on April 12.\n- If you override `timestamp_micros`, set it to a timestamp within the last 3\n business days."]]
