Integracja Google Ads z BigQuery
Dowiedz się, jak połączyć Google Ads z Google BigQuery w WitCloud i automatycznie pobierać dane o kampaniach, kliknięciach, kosztach, zakupach (Shopping) i konwersjach.
Aktualizacja
Wprowadzenie
Ten moduł integruje się z Google Ads API i pozwala pobierać dane o kampaniach, kliknięciach, kryteriach, kampaniach produktowych (Shopping), konwersjach i etykietach oraz zapisywać je w Google Cloud BigQuery. Dzięki temu możesz łączyć dane z Google Ads z danymi z analityki internetowej, CRM lub finansów i budować kompletne raporty skuteczności.
Przewodnik konfiguracji
Wykonaj poniższe kroki, aby połączyć Google Ads z BigQuery. Po zakończeniu konfiguracji dane będą automatycznie trafiać do Twojego projektu BigQuery.
Autoryzuj się kontem Google, które ma dostęp do kont Google Ads, które chcesz eksportować. Na liście kont zobaczysz tylko te, do których to konto ma dostęp.
Konfiguracja modułu
Przejdź do sekcji Integracje w menu > kliknij Dodaj integrację.

Wybierz Google Ads z listy dostępnych integracji.

Wpisz Nazwę źródła danych, np. "Google Ads PL".

Autoryzacja
Jeśli masz już autoryzację Google Ads, a token ma uprawnienie do Google Ads, wybierz go z listy Wybierz autoryzację Google Ads i pomiń ten krok.
Kliknij Autoryzuj.

Otworzy się okno Google. Wybierz konto Google, którego chcesz użyć, i zezwól WitCloud na dostęp. WitCloud prosi o dwa uprawnienia: do zarządzania Twoimi kontami i danymi Google Ads (uprawnienie Google Ads API, które Google opisuje jako „See, edit, create and delete your Google Ads accounts and data”) oraz do wglądu w Twój podstawowy profil Google, z którego pochodzi nazwa autoryzacji na liście. Po zamknięciu okna nowa autoryzacja zostanie wybrana automatycznie.
Konta
Otwórz listę Wybierz konta i wybierz konta Google Ads do eksportu. Konta są wyświetlane jako nazwa (identyfikator konta). Konta menedżerskie nie są wyświetlane, tylko konta, które zawierają dane, w tym konta klientów podpięte pod konto menedżerskie.

Możesz wybrać kilka kont.

Każde wybrane konto staje się osobnym konektorem o nazwie „<Nazwa źródła danych> - <nazwa konta (ID)>”, z własnym zestawem tabel w BigQuery. Wszystkie używają ustawień wpisanych poniżej.
Ustawienia zaawansowane
Kliknij Pokaż ustawienia zaawansowane, aby wybrać Tabele do pobrania. Domyślnie zaznaczone jest wszystkich sześć tabel i co najmniej jedna musi pozostać zaznaczona. Usuń te, których nie potrzebujesz: nie będą wypełniane danymi.

| Tabela do pobrania | Co zawiera |
|---|---|
click_stats | Kliknięcia z identyfikatorem kliknięcia Google (GCLID), kampanią, grupą reklam, urządzeniem i siecią |
criteria_basic_stats | Skuteczność słów kluczowych dzień po dniu: wyświetlenia, kliknięcia, koszt, konwersje |
campaign_stats | Skuteczność kampanii dzień po dniu: wyświetlenia, kliknięcia, koszt, konwersje, Active View |
campaign_conversion_stats | Konwersje kampanii w podziale na akcje konwersji |
shopping_stats | Skuteczność kampanii produktowych w podziale na produkty |
labels | Etykiety wraz z kampaniami, do których są przypisane |
Google Ads udostępnia dane na poziomie kliknięć tylko z ostatnich 90 dni. Starsze dni są pomijane w click_stats, także podczas importu danych historycznych.
Kliknij Dalej, aby przejść dalej.
Dane historyczne i harmonogram
W polu Dane historyczne wpisz liczbę dni danych historycznych do pobrania (wymagane, maksymalnie 365).

Harmonogram synchronizacji danych zostanie utworzony automatycznie. Więcej informacji znajdziesz tutaj.
Kliknij Utwórz, aby zakończyć konfigurację.

Gotowe! Dane z Google Ads będą ładowane do BigQuery zgodnie z harmonogramem, bez ręcznych eksportów.
Schemat danych
Każda tabela jest tworzona osobno dla konta, jako gads_<tabela>_<ID konta>, na przykład gads_campaign_stats_1000000001. Poniższe tabele pokazują kolumny każdej z nich.
Schemat danych tabeli gads_campaign_conversion_stats
| Field Name | Mode | Type |
|---|---|---|
| ExternalCustomerId | NULLABLE | STRING |
| AccountDescriptiveName | NULLABLE | STRING |
| CampaignId | NULLABLE | STRING |
| CampaignName | NULLABLE | STRING |
| ConversionAction | NULLABLE | STRING |
| ConversionActionCategory | NULLABLE | STRING |
| ConversionActionName | NULLABLE | STRING |
| AdNetworkType1 | NULLABLE | STRING |
| AdNetworkType2 | NULLABLE | STRING |
| ConversionValue | NULLABLE | FLOAT |
| Conversions | NULLABLE | FLOAT |
| AllConversions | NULLABLE | FLOAT |
| AllConversionsValue | NULLABLE | FLOAT |
| Date | NULLABLE | DATE |
| DayOfWeek | NULLABLE | STRING |
| Device | NULLABLE | STRING |
| Month | NULLABLE | DATE |
| MonthOfYear | NULLABLE | STRING |
| Quarter | NULLABLE | DATE |
| Week | NULLABLE | DATE |
| Year | NULLABLE | INTEGER |
| CampaignStatus | NULLABLE | STRING |
| Currency | NULLABLE | STRING |
Schemat danych tabeli gads_campaign_stats
| Field Name | Mode | Type |
|---|---|---|
| ExternalCustomerId | NULLABLE | STRING |
| AccountDescriptiveName | NULLABLE | STRING |
| BaseCampaignId | NULLABLE | STRING |
| CampaignGroupId | NULLABLE | STRING |
| CampaignId | NULLABLE | STRING |
| CampaignName | NULLABLE | STRING |
| ActiveViewCpm | NULLABLE | FLOAT |
| ActiveViewCtr | NULLABLE | FLOAT |
| ActiveViewImpressions | NULLABLE | INTEGER |
| ActiveViewMeasurability | NULLABLE | FLOAT |
| ActiveViewMeasurableCost | NULLABLE | FLOAT |
| ActiveViewMeasurableImpressions | NULLABLE | INTEGER |
| ActiveViewViewability | NULLABLE | FLOAT |
| AdNetworkType1 | NULLABLE | STRING |
| AdNetworkType2 | NULLABLE | STRING |
| AverageCost | NULLABLE | FLOAT |
| AverageCpc | NULLABLE | FLOAT |
| AverageCpm | NULLABLE | FLOAT |
| AveragePosition | NULLABLE | STRING |
| ClickType | NULLABLE | STRING |
| Clicks | NULLABLE | INTEGER |
| ConversionRate | NULLABLE | FLOAT |
| ConversionValue | NULLABLE | FLOAT |
| Conversions | NULLABLE | FLOAT |
| AllConversions | NULLABLE | FLOAT |
| Cost | NULLABLE | FLOAT |
| CostPerConversion | NULLABLE | FLOAT |
| Ctr | NULLABLE | FLOAT |
| Date | NULLABLE | DATE |
| DayOfWeek | NULLABLE | STRING |
| Device | NULLABLE | STRING |
| Impressions | NULLABLE | INTEGER |
| InteractionRate | NULLABLE | FLOAT |
| InteractionTypes | NULLABLE | STRING |
| Interactions | NULLABLE | INTEGER |
| Month | NULLABLE | DATE |
| MonthOfYear | NULLABLE | STRING |
| Quarter | NULLABLE | DATE |
| Slot | NULLABLE | STRING |
| ValuePerConversion | NULLABLE | FLOAT |
| Week | NULLABLE | DATE |
| Year | NULLABLE | INTEGER |
| CampaignStatus | NULLABLE | STRING |
| Currency | NULLABLE | STRING |
Schemat danych tabeli gads_click_stats
| Field Name | Mode | Type |
|---|---|---|
| ExternalCustomerId | NULLABLE | STRING |
| AccountDescriptiveName | NULLABLE | STRING |
| CampaignId | NULLABLE | STRING |
| CampaignName | NULLABLE | STRING |
| AdGroupId | NULLABLE | STRING |
| AdGroupName | NULLABLE | STRING |
| CreativeId | NULLABLE | STRING |
| CriteriaId | NULLABLE | STRING |
| GclId | NULLABLE | STRING |
| UserListId | NULLABLE | STRING |
| AdNetworkType1 | NULLABLE | STRING |
| AdNetworkType2 | NULLABLE | STRING |
| Clicks | NULLABLE | INTEGER |
| CriteriaParameters | NULLABLE | STRING |
| KeywordMatchType | NULLABLE | STRING |
| Page | NULLABLE | INTEGER |
| Slot | NULLABLE | STRING |
| Device | NULLABLE | STRING |
| Currency | NULLABLE | STRING |
Schemat danych tabeli gads_criteria_basic_stats
| Field Name | Mode | Type |
|---|---|---|
| ExternalCustomerId | NULLABLE | STRING |
| AccountDescriptiveName | NULLABLE | STRING |
| CampaignId | NULLABLE | STRING |
| CampaignName | NULLABLE | STRING |
| AdGroupId | NULLABLE | STRING |
| AdGroupName | NULLABLE | STRING |
| Id | NULLABLE | STRING |
| Criteria | NULLABLE | STRING |
| ActiveViewImpressions | NULLABLE | INTEGER |
| ActiveViewMeasurability | NULLABLE | FLOAT |
| ActiveViewMeasurableCost | NULLABLE | FLOAT |
| ActiveViewMeasurableImpressions | NULLABLE | INTEGER |
| ActiveViewViewability | NULLABLE | FLOAT |
| AdNetworkType1 | NULLABLE | STRING |
| AdNetworkType2 | NULLABLE | STRING |
| AveragePosition | NULLABLE | STRING |
| Clicks | NULLABLE | INTEGER |
| ConversionValue | NULLABLE | FLOAT |
| Conversions | NULLABLE | FLOAT |
| Cost | NULLABLE | FLOAT |
| CrossDeviceConversions | NULLABLE | STRING |
| Date | NULLABLE | DATE |
| Device | NULLABLE | STRING |
| Impressions | NULLABLE | INTEGER |
| InteractionTypes | NULLABLE | STRING |
| Interactions | NULLABLE | INTEGER |
| ViewThroughConversions | NULLABLE | INTEGER |
| Currency | NULLABLE | STRING |
Schemat danych tabeli gads_labels
| Field Name | Mode | Type |
|---|---|---|
| Id | NULLABLE | STRING |
| Name | NULLABLE | STRING |
| CustomerId | NULLABLE | STRING |
| CampaignId | NULLABLE | STRING |
| CampaignName | NULLABLE | STRING |
Schemat danych tabeli gads_shopping_stats
| Field Name | Mode | Type |
|---|---|---|
| ExternalCustomerId | NULLABLE | STRING |
| AccountDescriptiveName | NULLABLE | STRING |
| CampaignId | NULLABLE | STRING |
| CampaignName | NULLABLE | STRING |
| AdGroupId | NULLABLE | STRING |
| AdGroupName | NULLABLE | STRING |
| AdNetworkType | NULLABLE | STRING |
| ClickType | NULLABLE | STRING |
| ConversionAction | NULLABLE | STRING |
| ConversionActionCategory | NULLABLE | STRING |
| ConversionActionName | NULLABLE | STRING |
| Date | NULLABLE | DATE |
| DayOfWeek | NULLABLE | STRING |
| Device | NULLABLE | STRING |
| ExternalConversionSource | NULLABLE | STRING |
| Month | NULLABLE | STRING |
| ProductAggregatorId | NULLABLE | STRING |
| ProductBiddingCategoryLevel1 | NULLABLE | STRING |
| ProductBiddingCategoryLevel2 | NULLABLE | STRING |
| ProductBiddingCategoryLevel3 | NULLABLE | STRING |
| ProductBiddingCategoryLevel4 | NULLABLE | STRING |
| ProductBiddingCategoryLevel5 | NULLABLE | STRING |
| ProductBrand | NULLABLE | STRING |
| ProductChannel | NULLABLE | STRING |
| ProductChannelExclusivity | NULLABLE | STRING |
| ProductCondition | NULLABLE | STRING |
| ProductCountry | NULLABLE | STRING |
| ProductCustomAttribute0 | NULLABLE | STRING |
| ProductCustomAttribute1 | NULLABLE | STRING |
| ProductCustomAttribute2 | NULLABLE | STRING |
| ProductCustomAttribute3 | NULLABLE | STRING |
| ProductCustomAttribute4 | NULLABLE | STRING |
| ProductItemId | NULLABLE | STRING |
| ProductLanguage | NULLABLE | STRING |
| ProductMerchantId | NULLABLE | STRING |
| ProductStoreId | NULLABLE | STRING |
| ProductTitle | NULLABLE | STRING |
| ProductTypeL1 | NULLABLE | STRING |
| ProductTypeL2 | NULLABLE | STRING |
| ProductTypeL3 | NULLABLE | STRING |
| ProductTypeL4 | NULLABLE | STRING |
| ProductTypeL5 | NULLABLE | STRING |
| Quarter | NULLABLE | DATE |
| Week | NULLABLE | DATE |
| Year | NULLABLE | STRING |
| AllConversions | NULLABLE | FLOAT |
| AllConversionsFromInteractionsRate | NULLABLE | FLOAT |
| AllConversionsValue | NULLABLE | FLOAT |
| AverageCpc | NULLABLE | FLOAT |
| Clicks | NULLABLE | INTEGER |
| Conversions | NULLABLE | FLOAT |
| ConversionsFromInteractionsRate | NULLABLE | FLOAT |
| ConversionsValue | NULLABLE | FLOAT |
| CostMicros | NULLABLE | INTEGER |
| CostPerAllConversions | NULLABLE | FLOAT |
| CostPerConversion | NULLABLE | FLOAT |
| CrossDeviceConversions | NULLABLE | FLOAT |
| Ctr | NULLABLE | FLOAT |
| Impressions | NULLABLE | INTEGER |
| SearchAbsoluteTopImpressionShare | NULLABLE | FLOAT |
| SearchClickShare | NULLABLE | FLOAT |
| SearchImpressionShare | NULLABLE | FLOAT |
| ValuePerAllConversions | NULLABLE | FLOAT |
| ValuePerConversion | NULLABLE | FLOAT |
| Currency | NULLABLE | STRING |
