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, dans que vous collectez déjà grâce aux tags ou au SDK Firebase.

Ce guide décrit les cas d'utilisation courants du protocole de mesure Google Analytics et les exigences associées.

Récapitulatif des exigences

Ce tableau fournit un aperçu rapide des conditions requises pour chaque utilisation. . Gardez à l'esprit les bonnes pratiques suivantes:

  1. Le timestamp_micros des événements et des propriétés utilisateur est défini par défaut sur la requête. en temps réel. Lors de l'envoi d'un événement ou d'une modification de propriété utilisateur survenue dans le passé, remplacez l'horodatage comme décrit dans le guide sur les événements d'envoi. consultez le guide des propriétés utilisateur.

  2. Pour obtenir des rapports "Temps réel" et des métriques d'engagement précis, incluez les Le paramètre d'événement engagement_time_msec a été défini sur le nombre de millisecondes écoulées depuis l'événement précédent.

Cas d'utilisation ID de session Délai requis pour la requête Exigence de timestamp_micros
Attribuer le User-ID aux événements Obligatoire <= fin du jour ouvré de début de la session >= début de session et <= fin de session
Attribution des sessions Obligatoire <= début de session + 24 heures >= début de session et <= fin de session
Exporter des événements vers des plates-formes publicitaires Non obligatoire <= dernier jour ouvré de la session + 63 jours <= au moment de la demande
Envoyer des événements ou des propriétés utilisateur pour l'audience création Non obligatoire Web : <= durée du dernier événement en ligne + 30 jours
Application : <= durée du dernier événement en ligne + 42 jours		 <= au moment de la demande

Attribuer le User-ID aux événements

Utilisez le protocole de mesure pour fournir des événements en ligne ou hors connexion avec une User-ID :

Voici quelques exemples d'utilisation du User-ID pour un événement:

  1. Vos mesures en ligne ne disposent pas des informations nécessaires pour rechercher le User-ID pour les événements en ligne, mais vous disposez d'un pipeline de traitement des événements est capable d'associer une session en ligne et un User-ID.

    Dans ce scénario, vous utilisez le protocole de mesure pour fournir online avec un User-ID.

  2. Vous ne disposez pas du User-ID des événements que vous envoyez à l'aide du paramètre le protocole de mesure, mais vous voulez que ces événements soient associés User-ID 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 Événements du 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 le session en ligne.
  • Si vous remplacez timestamp_micros, définissez un horodatage compris entre les les heures de début et de fin de la session en ligne.
  • Si votre objectif est de fournir le User-ID pour les événements en ligne, définissez le user_id dans la demande.
  • Si vous souhaitez que le User-ID soit associé à chaque événement du protocole de mesure à partir de la session en ligne correspondante, vous n'avez pas besoin de définir user_id.

Attribution des sessions

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) comme des événements en ligne de la même session.

Voici les conditions requises pour l'attribution des sessions:

  • 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. session.

    Par exemple, si la session a commencé à 11h15 lundi dans la section fuseau horaire, envoyez la demande avant 11h15 le mardi.

  • Si vous remplacez timestamp_micros, définissez un horodatage compris entre les les heures de début et de fin de la session en ligne.

Exporter des é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 cas d'utilisation courants:

  • Votre entreprise dispose d'événements hors connexion que vous souhaitez inclure dans la publicité l'attribution et la création de rapports.
  • Vous avez des événements supplémentaires dans un système qui ne permet pas d'ajouter des tags ni le SDK Firebase, mais que vous souhaitez quand même les inclure dans produits.

Voici les conditions requises 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 plus plus de 63 jours.

    Par exemple, si le dernier événement en ligne du client_id ou app_instance_id a eu lieu le 1er mars, envoyez le protocole de mesure au plus tard le 3 mai, en fin de journée ouvrée.

  • Si vous remplacez timestamp_micros, définissez-le sur un code temporel inférieur ou égal à à la date et à l'heure de la requête.

Envoyer des événements ou des propriétés utilisateur pour créer des audiences

Les événements et les propriétés utilisateur envoyés à l'aide du protocole de mesure sont inclus dans l'évaluation des conditions de l'audience si vous respectez un certain nombre d'exigences.

Voici les conditions requises pour envoyer des événements ou des propriétés utilisateur à l'audience création:

  • Envoyer 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" s'est produit le Le 1er mars, envoyez l'événement du protocole de mesure au plus tard à la fin de la jour ouvré le 31 mars.

  • Envoyer la demande à un flux d'application avant 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 s'est produit le 1er mars, envoyez l'événement du protocole de mesure au plus tard à la fin le jour ouvré du 12 avril.

  • Si vous remplacez timestamp_micros, définissez-le sur un code temporel inférieur ou égal à à la date et à l'heure de la requête.