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ę.

Lista integracji z przyciskiem Dodaj integrację

Wybierz Google Ads z listy dostępnych integracji.

Katalog integracji zawężony do Google Ads

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

Pole Nazwa źródła danych wypełnione przykładową nazwą 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.

Przycisk Autoryzuj obok pola Wybierz autoryzację Google Ads

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.

Otwarta lista Wybierz konta z przykładowymi kontami Google Ads

Możesz wybrać kilka kont.

Pole Wybierz konta z dwoma wybranymi przykładowymi kontami Google Ads

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.

Otwarte ustawienia zaawansowane z polem Tabele do pobrania

Tabela do pobraniaCo zawiera
click_statsKliknięcia z identyfikatorem kliknięcia Google (GCLID), kampanią, grupą reklam, urządzeniem i siecią
criteria_basic_statsSkuteczność słów kluczowych dzień po dniu: wyświetlenia, kliknięcia, koszt, konwersje
campaign_statsSkuteczność kampanii dzień po dniu: wyświetlenia, kliknięcia, koszt, konwersje, Active View
campaign_conversion_statsKonwersje kampanii w podziale na akcje konwersji
shopping_statsSkuteczność kampanii produktowych w podziale na produkty
labelsEtykiety 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).

Pole Dane historyczne wypełnione wartością 365 dni

Harmonogram synchronizacji danych zostanie utworzony automatycznie. Więcej informacji znajdziesz tutaj.

Kliknij Utwórz, aby zakończyć konfigurację.

Ustawienia pobierania danych z przyciskiem Utwórz

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 NameModeType
ExternalCustomerIdNULLABLESTRING
AccountDescriptiveNameNULLABLESTRING
CampaignIdNULLABLESTRING
CampaignNameNULLABLESTRING
ConversionActionNULLABLESTRING
ConversionActionCategoryNULLABLESTRING
ConversionActionNameNULLABLESTRING
AdNetworkType1NULLABLESTRING
AdNetworkType2NULLABLESTRING
ConversionValueNULLABLEFLOAT
ConversionsNULLABLEFLOAT
AllConversionsNULLABLEFLOAT
AllConversionsValueNULLABLEFLOAT
DateNULLABLEDATE
DayOfWeekNULLABLESTRING
DeviceNULLABLESTRING
MonthNULLABLEDATE
MonthOfYearNULLABLESTRING
QuarterNULLABLEDATE
WeekNULLABLEDATE
YearNULLABLEINTEGER
CampaignStatusNULLABLESTRING
CurrencyNULLABLESTRING
Schemat danych tabeli gads_campaign_stats
Field NameModeType
ExternalCustomerIdNULLABLESTRING
AccountDescriptiveNameNULLABLESTRING
BaseCampaignIdNULLABLESTRING
CampaignGroupIdNULLABLESTRING
CampaignIdNULLABLESTRING
CampaignNameNULLABLESTRING
ActiveViewCpmNULLABLEFLOAT
ActiveViewCtrNULLABLEFLOAT
ActiveViewImpressionsNULLABLEINTEGER
ActiveViewMeasurabilityNULLABLEFLOAT
ActiveViewMeasurableCostNULLABLEFLOAT
ActiveViewMeasurableImpressionsNULLABLEINTEGER
ActiveViewViewabilityNULLABLEFLOAT
AdNetworkType1NULLABLESTRING
AdNetworkType2NULLABLESTRING
AverageCostNULLABLEFLOAT
AverageCpcNULLABLEFLOAT
AverageCpmNULLABLEFLOAT
AveragePositionNULLABLESTRING
ClickTypeNULLABLESTRING
ClicksNULLABLEINTEGER
ConversionRateNULLABLEFLOAT
ConversionValueNULLABLEFLOAT
ConversionsNULLABLEFLOAT
AllConversionsNULLABLEFLOAT
CostNULLABLEFLOAT
CostPerConversionNULLABLEFLOAT
CtrNULLABLEFLOAT
DateNULLABLEDATE
DayOfWeekNULLABLESTRING
DeviceNULLABLESTRING
ImpressionsNULLABLEINTEGER
InteractionRateNULLABLEFLOAT
InteractionTypesNULLABLESTRING
InteractionsNULLABLEINTEGER
MonthNULLABLEDATE
MonthOfYearNULLABLESTRING
QuarterNULLABLEDATE
SlotNULLABLESTRING
ValuePerConversionNULLABLEFLOAT
WeekNULLABLEDATE
YearNULLABLEINTEGER
CampaignStatusNULLABLESTRING
CurrencyNULLABLESTRING
Schemat danych tabeli gads_click_stats
Field NameModeType
ExternalCustomerIdNULLABLESTRING
AccountDescriptiveNameNULLABLESTRING
CampaignIdNULLABLESTRING
CampaignNameNULLABLESTRING
AdGroupIdNULLABLESTRING
AdGroupNameNULLABLESTRING
CreativeIdNULLABLESTRING
CriteriaIdNULLABLESTRING
GclIdNULLABLESTRING
UserListIdNULLABLESTRING
AdNetworkType1NULLABLESTRING
AdNetworkType2NULLABLESTRING
ClicksNULLABLEINTEGER
CriteriaParametersNULLABLESTRING
KeywordMatchTypeNULLABLESTRING
PageNULLABLEINTEGER
SlotNULLABLESTRING
DeviceNULLABLESTRING
CurrencyNULLABLESTRING
Schemat danych tabeli gads_criteria_basic_stats
Field NameModeType
ExternalCustomerIdNULLABLESTRING
AccountDescriptiveNameNULLABLESTRING
CampaignIdNULLABLESTRING
CampaignNameNULLABLESTRING
AdGroupIdNULLABLESTRING
AdGroupNameNULLABLESTRING
IdNULLABLESTRING
CriteriaNULLABLESTRING
ActiveViewImpressionsNULLABLEINTEGER
ActiveViewMeasurabilityNULLABLEFLOAT
ActiveViewMeasurableCostNULLABLEFLOAT
ActiveViewMeasurableImpressionsNULLABLEINTEGER
ActiveViewViewabilityNULLABLEFLOAT
AdNetworkType1NULLABLESTRING
AdNetworkType2NULLABLESTRING
AveragePositionNULLABLESTRING
ClicksNULLABLEINTEGER
ConversionValueNULLABLEFLOAT
ConversionsNULLABLEFLOAT
CostNULLABLEFLOAT
CrossDeviceConversionsNULLABLESTRING
DateNULLABLEDATE
DeviceNULLABLESTRING
ImpressionsNULLABLEINTEGER
InteractionTypesNULLABLESTRING
InteractionsNULLABLEINTEGER
ViewThroughConversionsNULLABLEINTEGER
CurrencyNULLABLESTRING
Schemat danych tabeli gads_labels
Field NameModeType
IdNULLABLESTRING
NameNULLABLESTRING
CustomerIdNULLABLESTRING
CampaignIdNULLABLESTRING
CampaignNameNULLABLESTRING
Schemat danych tabeli gads_shopping_stats
Field NameModeType
ExternalCustomerIdNULLABLESTRING
AccountDescriptiveNameNULLABLESTRING
CampaignIdNULLABLESTRING
CampaignNameNULLABLESTRING
AdGroupIdNULLABLESTRING
AdGroupNameNULLABLESTRING
AdNetworkTypeNULLABLESTRING
ClickTypeNULLABLESTRING
ConversionActionNULLABLESTRING
ConversionActionCategoryNULLABLESTRING
ConversionActionNameNULLABLESTRING
DateNULLABLEDATE
DayOfWeekNULLABLESTRING
DeviceNULLABLESTRING
ExternalConversionSourceNULLABLESTRING
MonthNULLABLESTRING
ProductAggregatorIdNULLABLESTRING
ProductBiddingCategoryLevel1NULLABLESTRING
ProductBiddingCategoryLevel2NULLABLESTRING
ProductBiddingCategoryLevel3NULLABLESTRING
ProductBiddingCategoryLevel4NULLABLESTRING
ProductBiddingCategoryLevel5NULLABLESTRING
ProductBrandNULLABLESTRING
ProductChannelNULLABLESTRING
ProductChannelExclusivityNULLABLESTRING
ProductConditionNULLABLESTRING
ProductCountryNULLABLESTRING
ProductCustomAttribute0NULLABLESTRING
ProductCustomAttribute1NULLABLESTRING
ProductCustomAttribute2NULLABLESTRING
ProductCustomAttribute3NULLABLESTRING
ProductCustomAttribute4NULLABLESTRING
ProductItemIdNULLABLESTRING
ProductLanguageNULLABLESTRING
ProductMerchantIdNULLABLESTRING
ProductStoreIdNULLABLESTRING
ProductTitleNULLABLESTRING
ProductTypeL1NULLABLESTRING
ProductTypeL2NULLABLESTRING
ProductTypeL3NULLABLESTRING
ProductTypeL4NULLABLESTRING
ProductTypeL5NULLABLESTRING
QuarterNULLABLEDATE
WeekNULLABLEDATE
YearNULLABLESTRING
AllConversionsNULLABLEFLOAT
AllConversionsFromInteractionsRateNULLABLEFLOAT
AllConversionsValueNULLABLEFLOAT
AverageCpcNULLABLEFLOAT
ClicksNULLABLEINTEGER
ConversionsNULLABLEFLOAT
ConversionsFromInteractionsRateNULLABLEFLOAT
ConversionsValueNULLABLEFLOAT
CostMicrosNULLABLEINTEGER
CostPerAllConversionsNULLABLEFLOAT
CostPerConversionNULLABLEFLOAT
CrossDeviceConversionsNULLABLEFLOAT
CtrNULLABLEFLOAT
ImpressionsNULLABLEINTEGER
SearchAbsoluteTopImpressionShareNULLABLEFLOAT
SearchClickShareNULLABLEFLOAT
SearchImpressionShareNULLABLEFLOAT
ValuePerAllConversionsNULLABLEFLOAT
ValuePerConversionNULLABLEFLOAT
CurrencyNULLABLESTRING