Integracja Pinterest Ads z BigQuery

Połącz Pinterest Ads z Google BigQuery w WitCloud i pobieraj dzienne dane o skuteczności kont, kampanii, grup reklam i reklam.

Aktualizacja

Wprowadzenie

Ten moduł łączy się z Pinterest Ads API i pobiera dzienne raporty skuteczności (koszt, wyświetlenia, kliknięcia, zaangażowanie, konwersje i wyświetlenia wideo) na czterech poziomach: konto, kampania, grupa reklam i reklama. Dane trafiają do Google Cloud BigQuery, do datasetu Twojego projektu.

Przewodnik konfiguracji

Wykonaj poniższe kroki, aby połączyć Pinterest Ads z BigQuery. Po zakończeniu konfiguracji dane reklamowe są automatycznie przesyłane do Twojego projektu BigQuery.

Potrzebujesz konta Pinterest z dostępem do kont reklamowych, które chcesz połączyć. Na liście pojawią się tylko konta reklamowe widoczne dla Twojego loginu Pinterest.

Konfiguracja modułu

Przejdź do Integracje w menu i kliknij Dodaj integrację.

Lista integracji z przyciskiem Dodaj integrację

Wybierz Pinterest Ads z listy dostępnych integracji.

Katalog integracji zawężony do Pinterest Ads

W polu Nazwa źródła danych wpisz nazwę, np. Pinterest Ads PL. Dobra nazwa pomoże Ci później rozpoznać źródło danych.

Pole Nazwa źródła danych wypełnione przykładową nazwą Pinterest Ads PL

Autoryzacja

Jeśli masz już autoryzację Pinterest w tym projekcie, wybierz ją z listy Wybierz autoryzację Pinterest i pomiń krok autoryzacji.

Kliknij Autoryzuj.

Przycisk Autoryzuj obok pola Wybierz autoryzację Pinterest

Otworzy się okno Pinteresta. Zaloguj się i zezwól WitCloud na dostęp do konta. WitCloud prosi o dostęp tylko do odczytu: może odczytać dane reklamowe i listę Twoich kont reklamowych, ale niczego nie zmienia w Pinterest. Po zamknięciu okna nowa autoryzacja zostanie wybrana automatycznie. Jeśli wybierzesz istniejącą autoryzację, przycisk zmieni się na Autoryzuj ponownie.

Wybór kont

Otwórz pole Wybierz konta i wybierz jedno lub więcej kont reklamowych. Pole jest nieaktywne, dopóki nie wybierzesz autoryzacji.

Otwarta lista Wybierz konta z przykładowymi kontami reklamowymi Pinterest

Możesz wybrać kilka kont naraz. Każde wybrane konto staje się osobnym źródłem danych o nazwie "Twoja nazwa źródła danych - nazwa konta" i z tymi samymi ustawieniami.

Pole Wybierz konta z dwoma wybranymi przykładowymi kontami reklamowymi Pinterest

Ustawienia zaawansowane

Kliknij Pokaż ustawienia zaawansowane, aby otworzyć pole Tabele do pobrania. Domyślnie zaznaczone są wszystkie cztery tabele (account, campaigns, ad_groups, ads). Usuń te, których nie potrzebujesz, aby skrócić pobieranie danych. Co najmniej jedna tabela musi pozostać zaznaczona.

Otwarte ustawienia zaawansowane z polem Tabele do pobrania

Kliknij Dalej.

Dane historyczne i harmonogram

W polu Dane historyczne wpisz liczbę dni do pobrania, licząc wstecz od dziś. Maksymalnie możesz wpisać 365 dni.

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

Harmonogram synchronizacji danych jest tworzony automatycznie. Więcej informacji na ten temat znajdziesz tutaj.

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

Ustawienia pobierania danych z przyciskiem Utwórz

Gotowe! Dane z Pinterest Ads są teraz synchronizowane z BigQuery, po jednym źródle danych dla każdego wybranego konta.

Schemat danych

Każde uruchomienie pobiera raporty z jednego dnia. Poniższe tabele zawierają dane jednego konta reklamowego.

Schemat danych tabeli pinterest_account
Field NameModeType
dateNULLABLEDATE
account_idNULLABLESTRING
account_nameNULLABLESTRING
spend_in_dollarNULLABLEFLOAT
cpm_in_dollarNULLABLEFLOAT
ecpc_in_dollarNULLABLEFLOAT
total_impressionNULLABLEINTEGER
total_impression_userNULLABLEINTEGER
total_impression_frequencyNULLABLEFLOAT
total_clickthroughNULLABLEINTEGER
ctrNULLABLEFLOAT
outbound_clickNULLABLEINTEGER
outbound_click_rateNULLABLEFLOAT
cost_per_outbound_click_in_dollarNULLABLEFLOAT
outbound_click_1NULLABLEINTEGER
outbound_click_2NULLABLEINTEGER
total_engagementNULLABLEINTEGER
engagement_rateNULLABLEFLOAT
repin_1NULLABLEINTEGER
repin_2NULLABLEINTEGER
total_repin_rateNULLABLEFLOAT
total_page_visitNULLABLEINTEGER
total_signupNULLABLEINTEGER
total_checkoutNULLABLEINTEGER
total_leadNULLABLEINTEGER
total_conversionsNULLABLEINTEGER
total_conversions_value_in_dollarNULLABLEFLOAT
page_visit_roasNULLABLEFLOAT
checkout_roasNULLABLEFLOAT
custom_roasNULLABLEFLOAT
web_checkout_roasNULLABLEFLOAT
total_web_checkoutNULLABLEINTEGER
total_web_checkout_value_in_dollarNULLABLEFLOAT
video_spend_in_dollarNULLABLEFLOAT
total_video_3sec_viewsNULLABLEINTEGER
total_video_mrc_viewsNULLABLEINTEGER
total_video_p0_combinedNULLABLEINTEGER
total_video_p25_combinedNULLABLEINTEGER
total_video_p50_combinedNULLABLEINTEGER
total_video_p75_combinedNULLABLEINTEGER
total_video_p100_completeNULLABLEINTEGER
total_video_avg_watchtime_in_secondNULLABLEFLOAT
video_lengthNULLABLEINTEGER
cpv_in_dollarNULLABLEFLOAT
cpcv_in_dollarNULLABLEFLOAT
ecpv_in_dollarNULLABLEFLOAT
ecpcv_in_dollarNULLABLEFLOAT
Schemat danych tabeli pinterest_campaigns
Field NameModeType
dateNULLABLEDATE
campaign_idNULLABLESTRING
campaign_nameNULLABLESTRING
campaign_objective_typeNULLABLESTRING
campaign_entity_statusNULLABLESTRING
campaign_budget_optimizationNULLABLESTRING
spend_in_dollarNULLABLEFLOAT
cpm_in_dollarNULLABLEFLOAT
ecpc_in_dollarNULLABLEFLOAT
total_impressionNULLABLEINTEGER
total_impression_userNULLABLEINTEGER
total_impression_frequencyNULLABLEFLOAT
total_clickthroughNULLABLEINTEGER
ctrNULLABLEFLOAT
outbound_clickNULLABLEINTEGER
outbound_click_rateNULLABLEFLOAT
cost_per_outbound_click_in_dollarNULLABLEFLOAT
outbound_click_1NULLABLEINTEGER
outbound_click_2NULLABLEINTEGER
total_engagementNULLABLEINTEGER
engagement_rateNULLABLEFLOAT
repin_1NULLABLEINTEGER
repin_2NULLABLEINTEGER
total_repin_rateNULLABLEFLOAT
total_page_visitNULLABLEINTEGER
total_signupNULLABLEINTEGER
total_checkoutNULLABLEINTEGER
total_leadNULLABLEINTEGER
total_conversionsNULLABLEINTEGER
total_conversions_value_in_dollarNULLABLEFLOAT
page_visit_roasNULLABLEFLOAT
checkout_roasNULLABLEFLOAT
custom_roasNULLABLEFLOAT
web_checkout_roasNULLABLEFLOAT
total_web_checkoutNULLABLEINTEGER
total_web_checkout_value_in_dollarNULLABLEFLOAT
video_spend_in_dollarNULLABLEFLOAT
total_video_3sec_viewsNULLABLEINTEGER
total_video_mrc_viewsNULLABLEINTEGER
total_video_p0_combinedNULLABLEINTEGER
total_video_p25_combinedNULLABLEINTEGER
total_video_p50_combinedNULLABLEINTEGER
total_video_p75_combinedNULLABLEINTEGER
total_video_p100_completeNULLABLEINTEGER
total_video_avg_watchtime_in_secondNULLABLEFLOAT
video_lengthNULLABLEINTEGER
cpv_in_dollarNULLABLEFLOAT
cpcv_in_dollarNULLABLEFLOAT
ecpv_in_dollarNULLABLEFLOAT
ecpcv_in_dollarNULLABLEFLOAT
Schemat danych tabeli pinterest_ad_groups
Field NameModeType
dateNULLABLEDATE
ad_group_idNULLABLESTRING
ad_group_nameNULLABLESTRING
campaign_idNULLABLESTRING
campaign_nameNULLABLESTRING
campaign_objective_typeNULLABLESTRING
campaign_entity_statusNULLABLESTRING
campaign_budget_optimizationNULLABLESTRING
spend_in_dollarNULLABLEFLOAT
cpm_in_dollarNULLABLEFLOAT
ecpc_in_dollarNULLABLEFLOAT
total_impressionNULLABLEINTEGER
total_impression_userNULLABLEINTEGER
total_impression_frequencyNULLABLEFLOAT
total_clickthroughNULLABLEINTEGER
ctrNULLABLEFLOAT
outbound_clickNULLABLEINTEGER
outbound_click_rateNULLABLEFLOAT
cost_per_outbound_click_in_dollarNULLABLEFLOAT
outbound_click_1NULLABLEINTEGER
outbound_click_2NULLABLEINTEGER
total_engagementNULLABLEINTEGER
engagement_rateNULLABLEFLOAT
repin_1NULLABLEINTEGER
repin_2NULLABLEINTEGER
total_repin_rateNULLABLEFLOAT
total_page_visitNULLABLEINTEGER
total_signupNULLABLEINTEGER
total_checkoutNULLABLEINTEGER
total_leadNULLABLEINTEGER
total_conversionsNULLABLEINTEGER
total_conversions_value_in_dollarNULLABLEFLOAT
page_visit_roasNULLABLEFLOAT
checkout_roasNULLABLEFLOAT
custom_roasNULLABLEFLOAT
web_checkout_roasNULLABLEFLOAT
total_web_checkoutNULLABLEINTEGER
total_web_checkout_value_in_dollarNULLABLEFLOAT
video_spend_in_dollarNULLABLEFLOAT
total_video_3sec_viewsNULLABLEINTEGER
total_video_mrc_viewsNULLABLEINTEGER
total_video_p0_combinedNULLABLEINTEGER
total_video_p25_combinedNULLABLEINTEGER
total_video_p50_combinedNULLABLEINTEGER
total_video_p75_combinedNULLABLEINTEGER
total_video_p100_completeNULLABLEINTEGER
total_video_avg_watchtime_in_secondNULLABLEFLOAT
video_lengthNULLABLEINTEGER
cpv_in_dollarNULLABLEFLOAT
cpcv_in_dollarNULLABLEFLOAT
ecpv_in_dollarNULLABLEFLOAT
ecpcv_in_dollarNULLABLEFLOAT
Schemat danych tabeli pinterest_ads
Field NameModeType
dateNULLABLEDATE
ad_idNULLABLESTRING
ad_nameNULLABLESTRING
pin_idNULLABLESTRING
pin_promotion_idNULLABLESTRING
ad_group_idNULLABLESTRING
ad_group_nameNULLABLESTRING
campaign_idNULLABLESTRING
campaign_nameNULLABLESTRING
campaign_objective_typeNULLABLESTRING
campaign_entity_statusNULLABLESTRING
campaign_budget_optimizationNULLABLESTRING
spend_in_dollarNULLABLEFLOAT
cpm_in_dollarNULLABLEFLOAT
ecpc_in_dollarNULLABLEFLOAT
total_impressionNULLABLEINTEGER
total_impression_userNULLABLEINTEGER
total_impression_frequencyNULLABLEFLOAT
total_clickthroughNULLABLEINTEGER
ctrNULLABLEFLOAT
outbound_clickNULLABLEINTEGER
outbound_click_rateNULLABLEFLOAT
cost_per_outbound_click_in_dollarNULLABLEFLOAT
outbound_click_1NULLABLEINTEGER
outbound_click_2NULLABLEINTEGER
total_engagementNULLABLEINTEGER
engagement_rateNULLABLEFLOAT
repin_1NULLABLEINTEGER
repin_2NULLABLEINTEGER
total_repin_rateNULLABLEFLOAT
total_page_visitNULLABLEINTEGER
total_signupNULLABLEINTEGER
total_checkoutNULLABLEINTEGER
total_leadNULLABLEINTEGER
total_conversionsNULLABLEINTEGER
total_conversions_value_in_dollarNULLABLEFLOAT
page_visit_roasNULLABLEFLOAT
checkout_roasNULLABLEFLOAT
custom_roasNULLABLEFLOAT
web_checkout_roasNULLABLEFLOAT
total_web_checkoutNULLABLEINTEGER
total_web_checkout_value_in_dollarNULLABLEFLOAT
video_spend_in_dollarNULLABLEFLOAT
total_video_3sec_viewsNULLABLEINTEGER
total_video_mrc_viewsNULLABLEINTEGER
total_video_p0_combinedNULLABLEINTEGER
total_video_p25_combinedNULLABLEINTEGER
total_video_p50_combinedNULLABLEINTEGER
total_video_p75_combinedNULLABLEINTEGER
total_video_p100_completeNULLABLEINTEGER
total_video_avg_watchtime_in_secondNULLABLEFLOAT
video_lengthNULLABLEINTEGER
cpv_in_dollarNULLABLEFLOAT
cpcv_in_dollarNULLABLEFLOAT
ecpv_in_dollarNULLABLEFLOAT
ecpcv_in_dollarNULLABLEFLOAT