Cette page a été traduite par l'API Cloud Translation.

Cas d'utilisation du protocole de mesure

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. Gardez à l'esprit les bonnes pratiques suivantes:

Les timestamp_micros des événements et des propriétés utilisateur correspondent 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	Configuration requise pour `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
Envoi d'événements ou de propriétés utilisateur pour créer l'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 des événements en ligne ou hors connexion avec un ID utilisateur.

Voici quelques exemples d'utilisation d'un ID utilisateur dans un événement:

Votre mesure en ligne ne dispose pas des informations nécessaires pour rechercher l'ID utilisateur 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 ID utilisateur.

Dans ce scénario, vous utilisez le protocole de mesure pour fournir un ID utilisateur aux événements en ligne.
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 un ID utilisateur aux événements du protocole de mesure.

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 comporte l'ID utilisateur 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 (comme 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é à 11h15 le lundi dans le fuseau horaire de votre établissement, envoyez la demande avant 11h15 le mardi.
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 des 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 dispose d'événements hors connexion que vous souhaitez inclure dans l'attribution publicitaire et les rapports.
Vous disposez d'événements supplémentaires dans un système qui ne sont pas disponibles pour le taggage ni le SDK Firebase, mais vous souhaitez tout de même les inclure 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 s'est produit le 1er mars, envoyez l'événement du protocole de mesure au plus tard à la fin du jour ouvré du 3 mai.
Si vous remplacez timestamp_micros, définissez-le sur un code temporel 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 pour créer une audience:

Envoyez la requête à 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 s'est produit le 1er mars, envoyez l'événement du protocole de mesure au plus tard à la fin de la journée ouvrée du 31 mars.
Envoyez la requête à un flux d'application 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 le app_instance_id s'est produit le 1er mars, envoyez l'événement du protocole de mesure au plus tard à la fin de la journée ouvrée du 12 avril.
Si vous remplacez timestamp_micros, définissez-le sur un code temporel des trois derniers jours ouvrés.