Integracja ChatGPT Ads z BigQuery
📢 Wprowadzenie
Moduł integruje się z ChatGPT Ads API (OpenAI Advertiser API), umożliwiając pobieranie danych o wynikach i kosztach kampanii oraz zapisywanie ich w Google Cloud BigQuery. Zyskaj pełniejszy wgląd w swoje dane reklamowe i optymalizuj wyniki kampanii dzięki automatycznej i bieżącej synchronizacji.
📝 Instrukcja konfiguracji
Wykonaj poniższe kroki, aby połączyć ChatGPT Ads z BigQuery. Po zakończeniu konfiguracji dane reklamowe będą przesyłane automatycznie do Twojego projektu BigQuery.
💡 Wskazówka: 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 sekcji Integrations w menu > Kliknij Add integration.
Z listy dostępnych integracji wybierz ChatGPT Ads.
Wprowadź Collect Name, np. "ChatGPT Ads Collect".
🔑 Autoryzacja
💡 Wskazówka: Jeśli masz już utworzoną autoryzację ChatGPT Ads, po prostu wybierz ją z listy i przejdź od razu do wyboru konta.
ChatGPT Ads nie korzysta z okna zgody Google — autoryzacja odbywa się przy użyciu klucza API wygenerowanego w ChatGPT Ads Manager.
Kliknij Authorize.
W oknie autoryzacji wklej API Key skopiowany z ChatGPT Ads Manager → Settings.
Kliknij Create, aby zapisać autoryzację.
Zapisana autoryzacja pojawi się na liście Select ChatGPT Ads authorization. Wybierz tę, której chcesz użyć — jest opisana nazwą konta reklamowego i zamaskowanym fragmentem klucza, dzięki czemu łatwo odróżnisz od siebie kilka kluczy.
Następnie w WitCloud wybierz konto ChatGPT Ads, z którego chcesz pobierać dane.
💡 Wskazówka: Klucz API wydawany jest na jedno konto reklamowe, więc dla każdej autoryzacji dostępne jest dokładnie jedno konto. Aby pobierać dane z kilku kont, dodaj osobną autoryzację i osobny collect dla każdego klucza.
Opcjonalnie rozwiń Advanced settings, aby zawęzić listę Tables to collect, jeśli nie potrzebujesz wszystkich tabel. Domyślnie pobierane są wszystkie.
Kliknij Next, aby przejść do ustawień pobierania danych.
⏳ Import historyczny i harmonogram synchronizacji
Podaj liczbę dni, z których chcesz pobrać dane historyczne.
Podczas początkowej konfiguracji możesz pobrać dane z okresu do 365 dni wstecz, z opcją importu starszych danych.
Harmonogram synchronizacji danych zostanie utworzony automatycznie i uruchamia się raz dziennie — każde uruchomienie nadpisuje partycję danego dnia danymi zaraportowanymi dla tego dnia. Więcej szczegółów znajdziesz tutaj.
Kliknij Create, aby zakończyć konfigurację.
🎉 Gotowe! Dane z ChatGPT Ads będą teraz automatycznie synchronizowane z BigQuery, umożliwiając analizę wyników kampanii, raportowanie i budowanie dashboardów.
📊 Schemat danych
Poniżej znajdziesz szczegółowy schemat danych pobieranych z ChatGPT Ads.