DAG Google Analytics 4

Panoramica

Nella pagina troverai indicazioni su come configurare tcrm_bq_to_ga4 o tcrm_gcs_to_ga4DAG e su come preparare i dati.

Google Analytics 4 (precedentemente noto come "App + Web") è un nuovo tipo di proprietà con report diversi rispetto a quelli delle proprietà Universal Analytics. Uno dei vantaggi di una proprietà Google Analytics 4 è che puoi utilizzarla per un sito web, un'app o entrambi. Le proprietà Universal Analytics supportano solo i siti web. Leggi l'annuncio per saperne di più.

Per maggiori dettagli, consulta Scopri la nuova generazione di Google Analytics

Configura variabili Airflow

Crea nuove variabili DAG tcrm_bq_to_ga4 necessarie

La tabella seguente indica quali variabili sono necessarie per eseguire il DAG tcrm_bq_to_ga4. Devi configurare queste variabili solo se prevedi di utilizzare BigQuery come origine dati.

Nome variabile Valore predefinito Informazioni sulle variabili
bq_dataset_id my_dataset Il nome del set di dati BigQuery contenente i dati.
bq_table_id my_table Il nome della tabella BigQuery contenente i dati.
api_secret API secret di Google Analytics 4, consulta la sezione Parametro di ricerca per dettagli su come creare l'API secret
payload_type Scegli tra gtag o firebase
measurement_id Obbligatorio se payload_type è gtag
firebase_app_id Obbligatorio se payload_type è firebase

Crea nuove variabili DAG tcrm_gcs_to_ga4 necessarie

La tabella seguente indica quali variabili sono necessarie per eseguire il DAG tcrm_gcs_to_ga4. Devi configurare queste variabili solo se prevedi di utilizzare Google Cloud Storage come origine dati.

Nome variabile Valore di esempio Informazioni sulle variabili
gcs_bucket_name my_bucket Nome del bucket Cloud Storage.
gcs_bucket_prefix folder/sub_folder Il percorso della cartella di dati all'interno del bucket.
gcs_content_type JSON Tipo di contenuti di Cloud Storage.
api_secret API secret di Google Analytics 4, consulta la sezione Parametro di ricerca per dettagli su come creare l'API secret
payload_type gtag Scegli tra gtag o firebase
measurement_id Obbligatorio se payload_type è gtag
firebase_app_id Obbligatorio se payload_type è firebase

Prepara i dati da inviare a Google Analytics 4

NOTA: per i requisiti dettagliati, consulta l'API Measurement Protocol 4{target="_blank"}.

Per inviare i tuoi dati a GA4, puoi scegliere tra le due opzioni seguenti. I dati di esempio si basano sull'evento login:

  1. Da BigQuery utilizzando il DAG tcrm_bq_to_ga4 in formato tabella SQL.

    id payload
    1 {"client_id":1,"events":[{"name":"login" "params":{"method": "Google"}}]} }
  2. Da Google Cloud Storage utilizzando il DAG tcrm_gcs_to_ga4 in formato JSON.

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

Gestisci il tuo DAG

Nella console Airflow fai clic sull'opzione DAGs nella barra dei menu in alto. Individua il DAG da eseguire nell'elenco a sinistra. Quindi eseguilo facendo clic sul pulsante Play sul lato destro dell'elenco.

Lettura dei log di DAG

Consulta le Domande frequenti sulla lettura dei log di DAG nelle Domande frequenti.