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

Wybierz ChatGPT Ads z listy dostępnych integracji.

Wpisz Nazwę źródła danych, np. „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.

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

Kliknij Utwórz, aby zapisać autoryzację.

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.

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

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.

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

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.

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

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 pola | Tryb | Typ |
|---|---|---|
| date | NULLABLE | DATE |
| account_id | NULLABLE | STRING |
| account_name | NULLABLE | STRING |
| currency_code | NULLABLE | STRING |
| timezone | NULLABLE | STRING |
| id | NULLABLE | STRING |
| start_time | NULLABLE | INTEGER |
| end_time | NULLABLE | INTEGER |
| impressions | NULLABLE | INTEGER |
| clicks | NULLABLE | INTEGER |
| spend | NULLABLE | FLOAT |
| ctr | NULLABLE | FLOAT |
| cpc | NULLABLE | FLOAT |
| cpm | NULLABLE | FLOAT |
| readable_time | NULLABLE | STRING |
| ad_account_id | NULLABLE | STRING |
| ad_account_name | NULLABLE | STRING |
Schemat danych tabeli chatgpt_ads_campaigns
| Nazwa pola | Tryb | Typ |
|---|---|---|
| date | NULLABLE | DATE |
| account_id | NULLABLE | STRING |
| account_name | NULLABLE | STRING |
| currency_code | NULLABLE | STRING |
| timezone | NULLABLE | STRING |
| id | NULLABLE | STRING |
| start_time | NULLABLE | INTEGER |
| end_time | NULLABLE | INTEGER |
| impressions | NULLABLE | INTEGER |
| clicks | NULLABLE | INTEGER |
| spend | NULLABLE | FLOAT |
| ctr | NULLABLE | FLOAT |
| cpc | NULLABLE | FLOAT |
| cpm | NULLABLE | FLOAT |
| readable_time | NULLABLE | STRING |
| ad_account_id | NULLABLE | STRING |
| ad_account_name | NULLABLE | STRING |
| campaign_id | NULLABLE | STRING |
| campaign_name | NULLABLE | STRING |
| campaign_status | NULLABLE | STRING |
Schemat danych tabeli chatgpt_ads_ad_groups
| Nazwa pola | Tryb | Typ |
|---|---|---|
| date | NULLABLE | DATE |
| account_id | NULLABLE | STRING |
| account_name | NULLABLE | STRING |
| currency_code | NULLABLE | STRING |
| timezone | NULLABLE | STRING |
| id | NULLABLE | STRING |
| start_time | NULLABLE | INTEGER |
| end_time | NULLABLE | INTEGER |
| impressions | NULLABLE | INTEGER |
| clicks | NULLABLE | INTEGER |
| spend | NULLABLE | FLOAT |
| ctr | NULLABLE | FLOAT |
| cpc | NULLABLE | FLOAT |
| cpm | NULLABLE | FLOAT |
| readable_time | NULLABLE | STRING |
| ad_account_id | NULLABLE | STRING |
| ad_account_name | NULLABLE | STRING |
| campaign_id | NULLABLE | STRING |
| campaign_name | NULLABLE | STRING |
| campaign_status | NULLABLE | STRING |
| ad_group_id | NULLABLE | STRING |
| ad_group_name | NULLABLE | STRING |
| ad_group_status | NULLABLE | STRING |
Schemat danych tabeli chatgpt_ads_performance
| Nazwa pola | Tryb | Typ |
|---|---|---|
| date | NULLABLE | DATE |
| account_id | NULLABLE | STRING |
| account_name | NULLABLE | STRING |
| currency_code | NULLABLE | STRING |
| timezone | NULLABLE | STRING |
| id | NULLABLE | STRING |
| start_time | NULLABLE | INTEGER |
| end_time | NULLABLE | INTEGER |
| impressions | NULLABLE | INTEGER |
| clicks | NULLABLE | INTEGER |
| spend | NULLABLE | FLOAT |
| ctr | NULLABLE | FLOAT |
| cpc | NULLABLE | FLOAT |
| cpm | NULLABLE | FLOAT |
| readable_time | NULLABLE | STRING |
| ad_account_id | NULLABLE | STRING |
| ad_account_name | NULLABLE | STRING |
| campaign_id | NULLABLE | STRING |
| campaign_name | NULLABLE | STRING |
| campaign_status | NULLABLE | STRING |
| ad_group_id | NULLABLE | STRING |
| ad_group_name | NULLABLE | STRING |
| ad_group_status | NULLABLE | STRING |
| ad_id | NULLABLE | STRING |
| ad_name | NULLABLE | STRING |
| ad_status | NULLABLE | STRING |
Schemat danych tabeli chatgpt_ads_conversions
| Nazwa pola | Tryb | Typ |
|---|---|---|
| date | NULLABLE | DATE |
| account_id | NULLABLE | STRING |
| account_name | NULLABLE | STRING |
| currency_code | NULLABLE | STRING |
| timezone | NULLABLE | STRING |
| aggregation_level | NULLABLE | STRING |
| entity_id | NULLABLE | STRING |
| conversions | NULLABLE | INTEGER |
| click_through_conversions | NULLABLE | INTEGER |
| view_through_conversions | NULLABLE | INTEGER |
