DAG-i Google Analytics 4

Omówienie

Z tego artykułu dowiesz się, jak skonfigurować DAG-a tcrm_bq_to_ga4 lub tcrm_gcs_to_ga4 oraz jak przygotować dane.

Google Analytics 4 (dawniej „Aplikacje + internet”) to nowa usługa, ale z innymi raportami niż dotychczasowe usługi Universal Analytics. Jedną z zalet usługi Google Analytics 4 jest możliwość jej stosowania do witryny lub aplikacji albo jednocześnie do witryny i aplikacji. Usługi Universal Analytics obsługują tylko witryny. Aby dowiedzieć się więcej, przeczytaj ogłoszenie.

Więcej informacji znajdziesz w artykule Przedstawiamy nową wersję Google Analytics.

Skonfiguruj zmienne Airflow

Uwaga: aby dowiedzieć się, jak skonfigurować zmienną Airflow za pomocą interfejsu, zajrzyj do sekcji 3.2 w podstawowym przewodniku po instalacji.

Uwaga: aby dowiedzieć się, jak skonfigurować zmienne ogólne, takie jak planowanie, ponowienie próby lub monitorowanie, zapoznaj się z sekcją 3.3 w podstawowym przewodniku po instalacji.

Utwórz nowe niezbędne zmienne tcrm_bq_to_ga4 DAG-ów

Poniższa tabela pokazuje, które zmienne są potrzebne do uruchomienia DAG-a tcrm_bq_to_ga4. Zmienne te musisz skonfigurować tylko wtedy, gdy zamierzasz używać BigQuery jako źródła danych.

Nazwa zmiennej	Wartość domyślna	Informacje o zmiennej
bq_dataset_id	my_dataset	Nazwa zbioru danych BigQuery zawierającego dane.
bq_table_id	my_table	Nazwa tabeli BigQuery zawierającej dane.
api_secret		Tajny klucz API Google Analytics 4. Szczegółowe informacje o tworzeniu obiektu tajnego interfejsu API znajdziesz w sekcji dotyczącej parametrów zapytania.
payload_type		Wybierz gtag lub firebase
measurement_id		Wymagane, jeśli payload_type to gtag
firebase_app_id		Wymagane, jeśli payload_type to firebase

Utwórz nowe niezbędne zmienne tcrm_gcs_to_ga4 DAG-ów

Poniższa tabela pokazuje, które zmienne są potrzebne do uruchomienia DAG-a tcrm_gcs_to_ga4. Zmienne te musisz skonfigurować tylko wtedy, gdy zamierzasz używać Google Cloud Storage jako źródła danych.

Nazwa zmiennej	Przykładowa wartość	Informacje o zmiennej
gcs_bucket_name	my_bucket	Nazwa zasobnika Cloud Storage.
gcs_bucket_prefix	folder/sub_folder	Ścieżka do folderu danych wewnątrz zasobnika.
gcs_content_type	JSON	Typ treści w Cloud Storage.
api_secret		Tajny klucz API Google Analytics 4. Szczegółowe informacje o tworzeniu obiektu tajnego interfejsu API znajdziesz w sekcji dotyczącej parametrów zapytania.
payload_type	gtag	Wybierz gtag lub firebase
measurement_id		Wymagane, jeśli payload_type to gtag
firebase_app_id		Wymagane, jeśli payload_type to firebase

Przygotowywanie danych do wysłania do Google Analytics 4

UWAGA: szczegółowe wymagania znajdziesz w interfejsie Measurement Protocol 4 API{target="_blank"}.

Aby wysyłać dane do GA4, możesz wybrać jedną z 2 opcji, np. oparty na zdarzeniu login:

1. Z BigQuery przy użyciu DAG-a tcrm_bq_to_ga4 w formacie tabeli SQL.

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

2. Z Google Cloud Storage przy użyciu DAG-a tcrm_gcs_to_ga4 w formacie JSON.

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

Uruchamianie DAG-a

W konsoli Airflow kliknij opcję DAGs na górnym pasku menu. Znajdź na liście po lewej stronie DAG-a, który chcesz uruchomić. Aby go uruchomić, kliknij przycisk Play po prawej stronie listy.

Odczytywanie logów DAG-a

Więcej informacji znajdziesz w sekcji Odczytywanie dzienników DAG-a w najczęstszych pytaniach.