Skonfiguruj Google Analytics 4 i Google BigQuery do pobierania danych w usłudze Azure Databricks

Na tej stronie opisano sposób konfigurowania usług Google Analytics 4 (GA4) i Google BigQuery (BigQuery) w celu pozyskiwania danych pierwotnych, na poziomie zdarzeń do usługi Azure Databricks.

Wybieranie metody uwierzytelniania

Obsługiwane są następujące metody uwierzytelniania:

  • OAuth (zalecane)
  • Uwierzytelnianie podstawowe za pomocą pliku JSON konta usługi

Usługa Databricks zaleca uwierzytelnianie OAuth, ponieważ jest bezpieczniejsze. Jednak organizacja może zdecydować się na użycie klucza konta usługi, jeśli na przykład przeprowadzasz migrację z dostawcy obsługującego tę metodę uwierzytelniania.

Użyjesz danych uwierzytelniających uzyskanych podczas konfiguracji źródła, aby utworzyć połączenie Unity Catalog z GA4.

Wymagania dotyczące uprawnień są takie same dla obu opcji, co umożliwia uwierzytelnienie użytkownika w celu uzyskania dostępu do schematu i pozyskiwania danych.

Włącz interfejsy API Google Cloud

Włącz wymagane interfejsy API Google Cloud w projekcie BigQuery, który zawiera wyeksportowane dane GA4.

  1. Zidentyfikuj projekt BigQuery zawierający wyeksportowane dane ga4.
  2. Włącz następujące interfejsy API w projekcie, postępując zgodnie z dokumentacją firmy Google:

Udzielanie uprawnień użytkownika

Ta sekcja umożliwia uwierzytelnionemu użytkownikowi dostęp do schematu źródłowego i importowanie danych. Kroki, które należy wykonać, zależą od metody uwierzytelniania.

Aby pozyskać dane ga4 z projektu BigQuery przy użyciu protokołu OAuth, musisz udzielić uwierzytelniającemu użytkownikowi dostępu do odpowiedniego konta BigQuery.

  1. W konsoli Google Cloud przejdź do IAM i administracja > IAM.
  2. Włącz następujące role dla uwierzytelniającego użytkownika:
    • Podgląd danych bigquery
    • Użytkownik zadania BigQuery
    • Użytkownik sesji odczytu BigQuery

Uwierzytelnianie konta usługi

Aby pozyskać dane ga4 z projektu BigQuery przy użyciu uwierzytelniania konta usługi, potrzebujesz odpowiedniego klucza konta usługi GCP w formacie JSON.

  1. W górnym menu strony Konta usług kliknij pozycję + UTWÓRZ KONTO USŁUGI.

    Tworzenie konta usługi ga4

  2. W obszarze Udziel temu kontu usługi dostępu do projektu włącz następujące role:

    • Podgląd danych bigquery
    • Użytkownik zadania BigQuery
    • Użytkownik sesji odczytu BigQuery

    Udziel dostępu kontu usługi do projektu BigQuery

  3. Ukończ tworzenie konta usługi.

  4. Na stronie Konta usług kliknij utworzone konto usługi.

  5. Na karcie KLUCZE kliknij pozycję DODAJ KLUCZ > Utwórz nowy klucz.

    Tworzenie nowego klucza

  6. W oknie modalnym Utwórz klucz prywatny, dla Typ klucza, wybierz JSON.

  7. Kliknij przycisk UTWÓRZ.

    Spowoduje to pobranie klucza JSON konta usługi.

    Pobieranie klucza JSON konta usługi

Eksportowanie danych ga4 do bigquery

Zidentyfikuj właściwość GA4, z której chcesz pozyskać dane, a następnie wyeksportuj dane właściwości do obiektu BigQuery. Aby uzyskać instrukcje, zobacz Konfigurowanie eksportu BigQuery w dokumentacji firmy Google.

Warning

Nie twórz własnych tabel, takich jak niestandardowe eksporty czy zaplanowane wyniki zapytań, których nazwy zaczynają się od events w źródłowym zbiorze danych BigQuery. Łącznik traktuje te tabele jako tabele zdarzeń GA4, co może powodować problemy z ewolucją schematu i awarie potoku przy tym CANNOT_WRITE_TO_INACTIVE_COLUMNS błędzie. Przechowuj niestandardowe tabele w osobnym zbiorze danych lub używaj innego prefiksu nazwy tabeli.