- Krok 1. Utwórz nowy projekt konsoli Google Cloud i włącz BigQuery
- Krok 2. Przygotuj projekt do wyeksportowania za pomocą funkcji BigQuery Export
- Krok 3. Połącz BigQuery z usługami w Google Analytics 4
- Usuwanie połączenia z BigQuery
- Limity funkcji BigQuery Export
- Filtrowanie danych
- Ceny i płatności
- Kiedy zaczniesz widzieć dane
- Przyczyny nieudanego łączenia kont
- Przyczyny niepowodzenia eksportu
- Powiązane artykuły
Krok 1. Utwórz projekt w Konsoli interfejsów API Google i włącz usługę BigQuery
- Zaloguj się w konsoli Google Cloud.
- Utwórz nowy projekt konsoli Google Cloud lub wybierz istniejący.
- Przejdź do tabeli interfejsów API.
Otwórz menu nawigacyjne w lewym górnym rogu i kliknij kolejno Interfejsy API i usługi oraz Biblioteka. - Włącz usługę BigQuery.
W sekcji Interfejsy Google Cloud APIs kliknij BigQuery API. Na następnej stronie kliknij Włącz. - Jeśli pojawi się taka prośba, zapoznaj się z „Warunkami korzystania z usługi” i je zaakceptuj.
Krok 2. Przygotuj projekt do wyeksportowania za pomocą funkcji BigQuery Export
Możesz bezpłatnie eksportować dane z Google Analytics do piaskownicy BigQuery (obowiązują limity piaskownicy).
Więcej informacji o uaktualnianiu piaskownicy i cenniku BigQuery.
Krok 3. Połącz usługę w Google Analytics 4 z BigQuery
Gdy ukończysz 2 pierwsze kroki, możesz włączyć BigQuery Export na karcie Administracja w Analytics.
Funkcja BigQuery Export podlega tym samym limitom gromadzenia danych i konfiguracji co Google Analytics. Jeśli potrzebujesz wyższych limitów, możesz uaktualnić swoją usługę do wersji Analytics 360.
- W sekcji
Administracja w sekcji Połączenia usług kliknij Połączenia z BigQuery.
Link Poprzednia otwiera ostatnio używaną usługę w Analytics. Możesz zmienić usługę za pomocą selektora usługi.- Musisz mieć rolę Edytujący (lub o większych uprawnieniach) na poziomie usługi, aby połączyć usługę w Analytics z BigQuery.
- Musisz też użyć adresu e-mail, który ma uprawnienia dostępu do projektu BigQuery na poziomie WŁAŚCICIELA (szczegółowe informacje o wymaganiach dotyczących dostępu znajdziesz w sekcji Uprawnienia poniżej).
- Kliknij Połącz.
- Aby wyświetlić listę projektów, do których masz dostęp, kliknij Wybierz projekt BigQuery.
Jeśli masz połączone konta Analytics i Firebase (lub planujesz je połączyć), możesz wyeksportować dane do tego samego projektu Cloud. Ułatwi to ich łączenie z pozostałymi danymi Firebase. - Wybierz projekt na liście i kliknij Potwierdź.
- Wybierz lokalizację danych (jeśli Twój projekt ma już zbiór danych w usłudze Analytics, nie możesz skonfigurować tej opcji).
- Kliknij Dalej.
- Kliknij Skonfiguruj strumienie danych i zdarzenia, aby określić, które strumienie danych mają zostać uwzględnione w eksporcie, a które zdarzenia z niego wykluczone. Zdarzenia możesz wykluczać, klikając Dodaj, aby wybrać z listy istniejących zdarzeń, lub klikając Podaj nazwę zdarzenia, aby wybrać nazwy istniejących zdarzeń lub podać nazwy zdarzeń, które mają być dopiero rejestrowane przez daną usługę.
- Kliknij Gotowe.
- Jeśli chcesz uwzględniać identyfikatory wyświetlania reklam, kliknij Uwzględniaj identyfikatory reklamowe w przypadku strumieni danych z aplikacji mobilnej.
- Zaznacz jedną lub obie opcje eksportu danych: Codziennie (raz dziennie) lub Strumieniowe przesyłanie danych (w sposób ciągły). W przypadku usług w Analytics 360 możesz też wybrać opcję Odświeżanie codzienne.
- Kliknij Dalej.
- Sprawdź ustawienia i kliknij Prześlij.
Uprawnienia
Uprawnienia getIamPolicy/setIamPolicy do projektu oraz uprawnienia get/enable do usług
OWNER (Właściciel) to superzestaw tych uprawnień.Aby utworzyć połączenie z BigQuery, musisz mieć co najmniej te uprawnienia:
resourcemanager.projects.get- Aby pobrać projekt
resourcemanager.projects.getIamPolicy- Aby uzyskać listę uprawnień
resourcemanager.projects.setIamPolicy- Aby sprawdzić, czy użytkownik ma uprawnienia do utworzenia połączenia w tym projekcie
serviceusage.services.enable- Aby włączyć interfejs BigQuery API
serviceusage.services.get- Aby sprawdzić, czy interfejs BigQuery API jest włączony
Sprawdzanie konta usługi
Gdy połączysz Analytics i BigQuery, w ramach tego procesu zostanie utworzone to konto usługi:
firebase-measurement@system.gserviceaccount.com
Sprawdź, czy konto zostało dodane do projektu jako członek i czy ma rolę Użytkownik BigQuery (roles/bigquery.user).
Jeśli funkcja BigQuery Export została wcześniej skonfigurowana w taki sposób, aby Twoje konto usługi uzyskało w projekcie Google Cloud rolę Edytujący, możesz ograniczyć jego uprawnienia do roli Użytkownik BigQuery. Aby zmienić rolę konta usługi, odłącz i ponownie połącz Analytics z projektem BigQuery. Najpierw musisz odłączyć Analytics od BigQuery oraz usunąć konto usługi o roli Edytujący. Następnie ponownie połącz Analytics z BigQuery zgodnie z podanymi wyżej instrukcjami, aby utworzyć nowe konto usługi z odpowiednimi uprawnieniami do projektu.
Po ponownym połączeniu sprawdź, czy konto usługi ma rolę Właściciel (bigquery.dataOwner) w dotychczasowym zbiorze danych eksportu. Aby to zrobić, wyświetl zasady dostępu zbioru danych.
Zmiana regionów
Jeśli podczas tworzenia połączenia wybierzesz niewłaściwy region i chcesz go zmienić:
- Usuń połączenie z BigQuery (patrz niżej).
- Utwórz kopię zapasową danych w innym zbiorze danych w BigQuery (przenosząc je lub kopiując).
- Usuń pierwotny zbiór danych. Zanotuj jego nazwę, ponieważ będzie Ci potrzebna w następnym kroku.
- Utwórz nowy zbiór danych o tej samej nazwie co usunięty właśnie zbiór i wybierz lokalizację danych.
- Udostępnij nowy zbiór danych użytkownikowi firebase-measurement@system.gserviceaccount.com i przypisz do konta usługi rolę Właściciel danych BigQuery.
- Skopiuj dane z kopii zapasowej do nowego zbioru danych.
- Utwórz nowe połączenie z BigQuery, wykonując podaną wyżej procedurę.
Po zmianie lokalizacji wystąpi luka w danych: strumieniowanie i codzienne eksporty danych nie będą przetwarzane w czasie między usunięciem dotychczasowego połączenia a utworzeniem nowego.
Usuwanie połączenia z BigQuery
- W sekcji Link Poprzednia otwiera ostatnio używaną usługę w Analytics. Możesz zmienić usługę za pomocą selektora usługi.Musisz mieć rolę Edytujący (lub o większych uprawnieniach) na poziomie usługi, aby usunąć połączenie z BigQuery.
- Kliknij wiersz połączenia.
- W prawym górnym rogu kliknij
> Usuń.
> Usuń.Limity funkcji BigQuery Export
W standardowych usługach w GA4 obowiązuje dzienny limit eksportów (zbiorczych) BigQuery Export wynoszący 1 mln zdarzeń. W przypadku eksportu strumieniowego nie ma limitu liczby zdarzeń. Jeśli Twoja usługa stale przekracza limit eksportu, dzienny eksport z BigQuery zostanie wstrzymany, a eksporty z poprzednich dni nie zostaną ponownie przetworzone.
W przypadku usług w Analytics 360 eksport z odświeżaniem codziennym zawiera wszystkie pola i kolumny danych, które są uwzględniane w eksporcie dziennym, w tym dane o atrybucji użytkowników i o wyświetleniach reklam. Dowiedz się więcej o eksporcie z odświeżaniem codziennym.
Edytorzy i administratorzy usług otrzymują e-maile z powiadomieniami za każdym razem, gdy usługa, którą zarządzają, przekroczy limit dzienny. Powiadomienie informuje, kiedy eksportowanie zostanie wstrzymane w przypadku braku działania ze strony użytkownika. Poza tym, jeśli usługa standardowa znacznie przekroczy limit dzienny wynoszący 1 milion zdarzeń, Analytics może natychmiast wstrzymać codzienne eksporty. Jeśli otrzymasz powiadomienie, skorzystaj z funkcji filtrowania danych (eksportowanie strumieni danych i wykluczanie zdarzeń), aby zmniejszyć liczbę zdarzeń eksportowanych każdego dnia i dzięki temu utrzymać codzienne eksportowanie.
Dowiedz się więcej o wyższych limitach dostępnych w usługach w wersji 360.
Filtrowanie danych
Możesz wykluczać z eksportowania określone strumienie danych i zdarzenia, aby ograniczyć rozmiar eksportowanego pliku lub aby upewnić się, że eksportujesz do BigQuery tylko odpowiednie zdarzenia.
Wykluczanie strumieni danych i zdarzeń podczas procesu łączenia
Wybierając w procesie łączenia strumienie danych, które chcesz wyeksportować, możesz też wybrać zdarzenia, które chcesz wykluczyć. Zobacz krok 9 procesu łączenia
Dodawanie i usuwanie strumieni danych lub zdarzeń po skonfigurowaniu połączenia
Po skonfigurowaniu połączenia z BigQuery możesz dodawać i usuwać strumienie danych, a także dodawać zdarzenia do listy wykluczeń i usuwać je z niej.
- W sekcji Link Poprzednia otwiera ostatnio używaną usługę w Analytics. Możesz zmienić usługę za pomocą selektora usługi.
- Musisz mieć rolę Edytujący (lub o większych uprawnieniach) na poziomie usługi, aby Dodawanie i usuwanie strumieni danych lub zdarzeń.
- Musisz też użyć adresu e-mail, który ma uprawnienia dostępu do projektu BigQuery na poziomie WŁAŚCICIELA.
- Kliknij wiersz projektu, którego połączenie chcesz zmienić.
- W sekcji Strumienie danych i zdarzenia kliknij Wyświetl strumienie danych i zdarzenia.
- W sekcji Strumienie danych do wyeksportowania możesz wybrać dodatkowe strumienie danych do wyeksportowania lub usunąć z listy istniejące strumienie.
- Na liście Zdarzenia do wykluczenia kliknij Dodaj, aby wybrać zdarzenia z listy istniejących zdarzeń, lub kliknij Podaj nazwę zdarzenia, aby wybrać nazwy istniejących zdarzeń lub podać nazwy zdarzeń, które mają być dopiero rejestrowane w danej usłudze.
- Aby usunąć zdarzenie z listy, kliknij znak minusa na końcu tego wiersza.
Ceny i płatności
Płatność za korzystanie z BigQuery jest uzależniona od 2 elementów: miejsca na dane i przetwarzania zapytań. Możesz sprawdzić tabelę cen i poznać różnice między zapytaniami interaktywnymi a zbiorczymi.
Do eksportowania danych wymagana jest ważna forma płatności na platformie Cloud. Jeśli eksport zostanie przerwany z powodu nieważnej formy płatności, nie będziemy mogli ponownie wyeksportować danych z tego okresu.
Możesz też bezpłatnie eksportować dane z Analytics do piaskownicy BigQuery, ale pamiętaj o obowiązujących limitach piaskownicy.
Kiedy zaczniesz widzieć dane
Dane powinny zacząć spływać do Twojego projektu BigQuery w ciągu 24 godzin od chwili, gdy proces łączenia się zakończy. Jeśli włączysz codzienny eksport danych, każdego dnia będzie eksportowany 1 plik zawierający dane z poprzedniego dnia (zazwyczaj w godzinach popołudniowych strefy czasowej ustawionej dla raportowania).
Przyczyny nieudanego łączenia kont
Utworzenie połączenia z BigQuery może się zakończyć niepowodzeniem z jednego z 2 powodów:
- Zasady Twojej organizacji zabraniają eksportowania danych do Stanów Zjednoczonych. Jeśli jako lokalizacja danych zostały wybrane Stany Zjednoczone, podaj inną lokalizację.
- Zasady Twojej organizacji zabraniają dodawania kont usługi z domeny, z której chcesz wyeksportować dane. W takim przypadku musisz zmodyfikować zasady organizacji.
Przyczyny niepowodzenia eksportu
| Niepowodzenie | Przyczyna | Wynik |
|---|---|---|
| Brak konta usługi | W projekcie Cloud nie ma konta usługi z przypisaną rolą Aktywny użytkownik. | Analytics nie może utworzyć tabel. Nie można wykonać eksportu. |
| Po instalacji konto robota zostało usunięte | Użytkownik konta Cloud usunął konto robota zainstalowane przez Google Analytics. | Analytics nie może już tworzyć tabel. Wszystkie operacje eksportu zostają zatrzymane. |
| Zasady organizacji są niezgodne z funkcją BigQuery Export | Użytkownik w projekcie Cloud utworzył zasady organizacji, które uniemożliwiają Analytics eksportowanie danych. Te zasady mogą uniemożliwiać tworzenie tabel BigQuery lub zapisywanie w tabelach. Konflikt może również dotyczyć regionu przechowywania danych. | Tabela nie zostaje utworzona lub zostaje utworzona, a następnie szybko usunięta (w ciągu ok. 30 min). |
| Użytkownik zmienił ustawienia płatności | Użytkownik w projekcie Cloud zmienił bezpłatną wersję BigQuery na płatną. Zwykle przebiega to bezproblemowo, jednak czasami mogą wystąpić błędy, np. jeśli rozmiar projektu przekracza 10 GB (limit piaskownicy). Może wówczas wystąpić błąd eksportu. | Tabele nie wypełniają się danymi. |
| Rozmiar projektu Cloud przekroczył limit | Zasoby Cloud dla większości projektów są ograniczone. Po przekroczeniu limitu miejsca na dane BigQuery nie możesz zapisywać więcej informacji. Pamiętaj, że w przypadku bezpłatnych projektów ten limit jest niewielki (10 GB). | Tabele nie wypełniają się danymi. |
| Użytkownik zmienił strefę czasową usługi | Podczas eksportu wykonywana jest migawka usługi obejmująca 24 godziny. W przypadku zmiany strefy czasowej eksportowany okres może się w danym dniu skrócić lub wydłużyć (np. skrócić o 3 godziny przy zmianie strefy czasowej ze standardowego czasu wschodniego USA na czas pacyficzny USA). W obu sytuacjach użytkownik zobaczy nietypową liczbę zdarzeń. | Jeden dzień z nietypową liczbą zdarzeń. Ogólna dezorientacja użytkownika. |
Pomoc
Jeśli masz problemy z BigQuery, np. dotyczące płatności, skontaktuj się z zespołem pomocy Google Cloud.
Przydatne materiały
BigQuery Export
Informacje o eksporcie i dostępie do przykładowego zbioru danych znajdziesz w dokumentacji funkcji BigQuery Export.