DAG Google Analytics 4

Présentation

Cette page vous explique comment configurer le DAG tcrm_bq_to_ga4 ou tcrm_gcs_to_ga4, et comment préparer les données.

Google Analytics 4 (anciennement "Application + Web") est un nouveau type de propriété, avec des rapports différents de ceux que vous avez l'habitude de voir dans les propriétés Universal Analytics. Une propriété Google Analytics 4 présente l'avantage de pouvoir être utilisée pour un site Web, pour une application ou pour les deux à la fois. Les propriétés Universal Analytics ne sont compatibles qu'avec les sites Web. Lisez l'annonce pour en savoir plus.

Pour en savoir plus, consultez Découvrez la nouvelle génération de Google Analytics.

Configurer les variables Airflow

Créer des variables de DAG tcrm_bq_to_ga4 nécessaires

Le tableau suivant indique les variables nécessaires pour exécuter le DAG tcrm_bq_to_ga4. Vous ne devez configurer ces variables que si vous prévoyez d'utiliser BigQuery comme source de données.

Nom de la variable Valeur par défaut Informations sur la variable
bq_dataset_id my_dataset Nom de l'ensemble de données BigQuery contenant les données.
bq_table_id my_table Nom de la table BigQuery contenant les données.
api_secret Code secret de l'API Google Analytics 4 (veuillez consulter la section Paramètre de requête pour savoir comment créer le code secret de l'API)
payload_type Sélectionnez gtag ou firebase
measurement_id Obligatoire si payload_type est gtag
firebase_app_id Obligatoire si payload_type est firebase

Créer des variables de DAG tcrm_gcs_to_ga4 nécessaires

Le tableau suivant indique les variables nécessaires pour exécuter le DAG tcrm_gcs_to_ga4. Vous ne devez configurer ces variables que si vous prévoyez d'utiliser Google Cloud Storage comme source de données.

Nom de la variable Exemple de valeur Informations sur la variable
gcs_bucket_name my_bucket Nom du bucket Cloud Storage.
gcs_bucket_prefix folder/sub_folder Chemin d'accès au dossier de données dans le bucket.
gcs_content_type JSON Type de contenu Cloud Storage.
api_secret Code secret de l'API Google Analytics 4 (veuillez consulter la section Paramètre de requête pour savoir comment créer le code secret de l'API)
payload_type gtag Sélectionnez gtag ou firebase
measurement_id Obligatoire si payload_type est gtag
firebase_app_id Obligatoire si payload_type est firebase

Préparer les données à envoyer à Google Analytics 4

REMARQUE: Reportez-vous à l'API du protocole de mesure 4{target="_blank"} pour connaître les exigences détaillées.

Pour envoyer vos données à GA4, vous avez le choix entre les deux options suivantes. Les exemples de données sont basés sur l'événement login :

  1. Depuis BigQuery à l'aide du DAG tcrm_bq_to_ga4 au format de table SQL

    id payload
    1 {"client_id":1,"events":[{"name":"login" "params":{"method": "Google"}}]} }

  2. Depuis Google Cloud Storage, en utilisant le DAG tcrm_gcs_to_ga4 au format JSON.

    {"id": 1, "payload":{"client_id":1,"events":[{"name":"login", "params":{"method": "Google"}}]} }

Exécuter votre DAG

Dans la console Airflow, cliquez sur l'option DAGs dans la barre de menu supérieure. Recherchez le DAG que vous souhaitez exécuter dans la liste de gauche. Exécutez-le ensuite en cliquant sur le bouton Play à droite de la liste.

Lire les journaux du DAG

Consultez la section Lire les journaux du DAG dans les questions fréquentes.