Integracja ChatGPT Ads z BigQuery

Podłącz ChatGPT Ads (OpenAI Ads) do Google BigQuery w WitCloud. Autoryzuj się kluczem API, wybierz konto reklamowe, pobierz do 365 dni danych historycznych o wynikach i kosztach kampanii i synchronizuj je automatycznie.

Aktualizacja

Wprowadzenie

Ta integracja łączy się z ChatGPT Ads API (OpenAI Advertiser API), dzięki czemu możesz pobierać dane o wynikach i kosztach kampanii oraz zapisywać je w Google Cloud BigQuery. Lepiej poznaj swoje dane i optymalizuj skuteczność kampanii reklamowych.

Instrukcja konfiguracji

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

Upewnij się, że masz dostęp do ChatGPT Ads Manager. Przed rozpoczęciem konfiguracji musisz utworzyć klucz API — każdy klucz daje dostęp do jednego konta reklamowego.

Konfiguracja modułu

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

Lista integracji z przyciskiem Dodaj integrację

Wybierz ChatGPT Ads z listy dostępnych integracji.

Katalog integracji z wybraną integracją ChatGPT Ads

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

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

Autoryzacja

Jeśli masz już utworzoną autoryzację ChatGPT Ads, wybierz ją z listy i przejdź od razu do wyboru konta.

Autoryzujesz się kluczem API wygenerowanym w ChatGPT Ads Manager.

Kliknij Autoryzuj.

Przycisk Autoryzuj obok pola z autoryzacją

W oknie Autoryzuj wklej Klucz API skopiowany z ChatGPT Ads Manager → Settings.

Okno Autoryzuj z polem Klucz API wypełnionym przykładową wartością

Kliknij Utwórz, aby zapisać autoryzację.

Przycisk Utwórz w oknie autoryzacji

Zapisana autoryzacja pojawi się na liście Wybierz autoryzację ChatGPT Ads. Wybierz tę, której chcesz użyć — jest opisana nazwą konta reklamowego i zamaskowanym fragmentem klucza, dzięki czemu łatwo odróżnisz kilka kluczy.

Lista Wybierz autoryzację ChatGPT Ads z zapisaną autoryzacją

Po powrocie do WitCloud wybierz z listy Wybierz konto konto ChatGPT Ads, które chcesz eksportować.

Pole Wybierz konto z wybranym przykładowym kontem reklamowym

Klucz API jest wydawany dla jednego konta reklamowego, więc każda autoryzacja daje dostęp do dokładnie jednego konta. Aby pobierać dane z kilku kont, dodaj osobną autoryzację i osobny konektor dla każdego klucza.

Opcjonalnie kliknij Pokaż ustawienia zaawansowane, aby zawęzić Tabele do pobrania, jeśli nie potrzebujesz wszystkich. Domyślnie pobierane są wszystkie, a wymagana jest co najmniej jedna tabela.

Otwarte ustawienia zaawansowane z polem Tabele do pobrania

Kliknij Dalej, aby przejść do ustawień pobierania danych.

Przycisk Dalej pod formularzem integracji

Dane historyczne i harmonogram

W polu Dane historyczne wpisz liczbę dni, z których chcesz pobrać dane historyczne. Podczas pierwszej konfiguracji możesz pobrać dane z maksymalnie 365 dni wstecz.

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

Harmonogram synchronizacji danych zostanie utworzony automatycznie; każde uruchomienie nadpisuje partycję danego dnia danymi zgłoszonymi za ten dzień. 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 ChatGPT Ads będą teraz synchronizowane z BigQuery, dzięki czemu dokładnie przeanalizujesz skuteczność swoich kampanii reklamowych.

Schemat danych

Rozwiń poniższe tabele, aby zobaczyć pełny schemat danych pobieranych z ChatGPT Ads.

Schemat danych tabeli chatgpt_ads_account
Nazwa polaTrybTyp
dateNULLABLEDATE
account_idNULLABLESTRING
account_nameNULLABLESTRING
currency_codeNULLABLESTRING
timezoneNULLABLESTRING
idNULLABLESTRING
start_timeNULLABLEINTEGER
end_timeNULLABLEINTEGER
impressionsNULLABLEINTEGER
clicksNULLABLEINTEGER
spendNULLABLEFLOAT
ctrNULLABLEFLOAT
cpcNULLABLEFLOAT
cpmNULLABLEFLOAT
readable_timeNULLABLESTRING
ad_account_idNULLABLESTRING
ad_account_nameNULLABLESTRING
Schemat danych tabeli chatgpt_ads_campaigns
Nazwa polaTrybTyp
dateNULLABLEDATE
account_idNULLABLESTRING
account_nameNULLABLESTRING
currency_codeNULLABLESTRING
timezoneNULLABLESTRING
idNULLABLESTRING
start_timeNULLABLEINTEGER
end_timeNULLABLEINTEGER
impressionsNULLABLEINTEGER
clicksNULLABLEINTEGER
spendNULLABLEFLOAT
ctrNULLABLEFLOAT
cpcNULLABLEFLOAT
cpmNULLABLEFLOAT
readable_timeNULLABLESTRING
ad_account_idNULLABLESTRING
ad_account_nameNULLABLESTRING
campaign_idNULLABLESTRING
campaign_nameNULLABLESTRING
campaign_statusNULLABLESTRING
Schemat danych tabeli chatgpt_ads_ad_groups
Nazwa polaTrybTyp
dateNULLABLEDATE
account_idNULLABLESTRING
account_nameNULLABLESTRING
currency_codeNULLABLESTRING
timezoneNULLABLESTRING
idNULLABLESTRING
start_timeNULLABLEINTEGER
end_timeNULLABLEINTEGER
impressionsNULLABLEINTEGER
clicksNULLABLEINTEGER
spendNULLABLEFLOAT
ctrNULLABLEFLOAT
cpcNULLABLEFLOAT
cpmNULLABLEFLOAT
readable_timeNULLABLESTRING
ad_account_idNULLABLESTRING
ad_account_nameNULLABLESTRING
campaign_idNULLABLESTRING
campaign_nameNULLABLESTRING
campaign_statusNULLABLESTRING
ad_group_idNULLABLESTRING
ad_group_nameNULLABLESTRING
ad_group_statusNULLABLESTRING
Schemat danych tabeli chatgpt_ads_performance
Nazwa polaTrybTyp
dateNULLABLEDATE
account_idNULLABLESTRING
account_nameNULLABLESTRING
currency_codeNULLABLESTRING
timezoneNULLABLESTRING
idNULLABLESTRING
start_timeNULLABLEINTEGER
end_timeNULLABLEINTEGER
impressionsNULLABLEINTEGER
clicksNULLABLEINTEGER
spendNULLABLEFLOAT
ctrNULLABLEFLOAT
cpcNULLABLEFLOAT
cpmNULLABLEFLOAT
readable_timeNULLABLESTRING
ad_account_idNULLABLESTRING
ad_account_nameNULLABLESTRING
campaign_idNULLABLESTRING
campaign_nameNULLABLESTRING
campaign_statusNULLABLESTRING
ad_group_idNULLABLESTRING
ad_group_nameNULLABLESTRING
ad_group_statusNULLABLESTRING
ad_idNULLABLESTRING
ad_nameNULLABLESTRING
ad_statusNULLABLESTRING
Schemat danych tabeli chatgpt_ads_conversions
Nazwa polaTrybTyp
dateNULLABLEDATE
account_idNULLABLESTRING
account_nameNULLABLESTRING
currency_codeNULLABLESTRING
timezoneNULLABLESTRING
aggregation_levelNULLABLESTRING
entity_idNULLABLESTRING
conversionsNULLABLEINTEGER
click_through_conversionsNULLABLEINTEGER
view_through_conversionsNULLABLEINTEGER