Ads API od zera: konto, kampania i reklama z kodu

Cała praca w ChatGPT Ads da się wykonać z kodu: od sprawdzenia konta, przez tworzenie kampanii i grup reklam, po wgrywanie kreacji i pobieranie wyników. Dla agencji prowadzącej wiele kont to różnica między klikaniem a automatyzacją.

Poniżej struktura, uwierzytelnianie, limity i kilka szczegółów, które zaskakują przy pierwszym wywołaniu.

Grzegorz Wysocki
CEO emedia

Komentarz autora: Pierwsza rzecz, która mnie zaskoczyła, to budżety podawane w milionowych częściach jednostki waluty. Dwadzieścia pięć euro to dwadzieścia pięć milionów w polu budżetu. Łatwo o pomyłkę rzędu wielkości, a system przyjmie taką wartość bez mrugnięcia. Druga rzecz to dwa różne klucze, o czym pisaliśmy przy pomiarze serwerowym.

Klucz i uwierzytelnianie

Klucz tworzy się w ustawieniach Menedżera reklam i przekazuje w nagłówku każdego żądania jako token. Adres bazowy interfejsu jest jeden dla wszystkich operacji.

Kluczowe ograniczenie: jeden klucz obsługuje jedno konto reklamowe. Agencja prowadząca wiele kont potrzebuje klucza dla każdego z nich, a partnerzy korzystają z klucza powiązanego z kontem klienta.

Pamiętaj o rozróżnieniu, które łatwo pomylić: klucz Menedżera reklam służy do zarządzania kampaniami, a do wysyłania zdarzeń konwersji potrzebny jest osobny klucz konwersji.

Struktura konta

Hierarchia jest prosta i znajoma z innych systemów: konto zawiera kampanie, kampania zawiera grupy reklam, a grupa zawiera reklamy.

Podział obowiązków też jest czytelny. Kampania trzyma cel, budżet, daty i kierowanie. Grupa reklam odpowiada za podpowiedzi kontekstowe i stawki. Reklama to tytuł, opis, obraz i adres docelowy.

Żeby reklama się pokazała, muszą być jednocześnie włączone: ona sama, jej grupa i kampania. Do tego reklama musi przejść przegląd, który zwykle trwa kilka minut. Stan śledzi się polem statusu przeglądu.

Budżety w milionowych częściach jednostki

Kwoty w interfejsie podaje się w mikrojednostkach, czyli milionowych częściach jednostki waluty. Dwadzieścia pięć euro to dwadzieścia pięć milionów, a nie dwadzieścia pięć.

Do wyboru są dwa rodzaje budżetu: całkowity dla kampanii oraz dzienny. Dzienny jest średnią z siedmiu dni, więc w pojedynczym dniu wydatek może sięgnąć dwukrotności ustawionej kwoty. Zmiana rodzaju budżetu bywa nieodwracalna, o czym warto pamiętać przy projektowaniu automatyzacji.

Kierowanie i wgrywanie kreacji

Lokalizacje wskazuje się identyfikatorami, które znajduje się przez osobną wyszukiwarkę lokalizacji albo pobiera z katalogu w postaci pliku. Przy tworzeniu kampanii wystarczy podać sam identyfikator, resztę danych system uzupełnia.

Obrazy wgrywa się jednym punktem końcowym, który przyjmuje albo adres obrazu, albo plik binarny. W odpowiedzi dostajesz identyfikator pliku używany potem przy tworzeniu reklamy.

Tym samym punktem wgrywa się ikonę marki konta, wskazując odpowiednie przeznaczenie. Bez zatwierdzonej ikony konto nie wyemituje żadnej reklamy, więc warto to zrobić na samym początku automatyzacji.

Limity zapytań i idempotencja

Interfejs ogranicza tempo zapytań na dwa sposoby: sześćset zapytań na minutę na pojedynczy punkt końcowy oraz tysiąc dwieście łącznie. Limity liczone są zarówno dla konta, jak i dla adresu, z którego przychodzą żądania.

Operacje zbiorcze mają osobny limit dziesięciu żądań na dziesięć sekund dla konta. Przy większych zmianach warto korzystać z trybu zbiorczego zamiast pojedynczych wywołań.

Dla operacji zmieniających stan można przekazać klucz idempotencji, dzięki któremu ponowienie żądania po błędzie sieci nie utworzy drugiej kampanii ani drugiej reklamy. Warto go stosować konsekwentnie.

Role w zespole

Dostęp do konta nadaje się mailem, z jedną z trzech ról: administrator z pełnym dostępem, członek tworzący i prowadzący kampanie oraz przeglądający z samym podglądem.

Przy współpracy z agencją warto ustalić role świadomie. Prowadzenie kampanii nie wymaga uprawnień administratora, a te ostatnie dają dostęp także do rozliczeń i kluczy.

Jak emedia może w tym pomóc?

Automatyzacja ma sens przy większej liczbie kont albo przy katalogu, który zmienia się codziennie.

• Budujemy automatyzację tworzenia i aktualizacji kampanii dla klientów z dużym asortymentem.
• Podpinamy raportowanie do własnych narzędzi i zestawiamy je z Google Ads oraz Meta Ads.
• Konfigurujemy role i klucze tak, żeby dostęp był rozdzielony zgodnie z odpowiedzialnością.
• Obsługa kampanii ChatGPT Ads: 850 zł netto miesięcznie.

Podsumowanie

Zanim napiszesz pierwszą linijkę, zapamiętaj trzy rzeczy: kwoty podaje się w milionowych częściach jednostki waluty, jeden klucz obsługuje jedno konto, a reklama pokaże się dopiero, gdy włączone są wszystkie trzy poziomy i przegląd się zakończy. Reszta jest przewidywalna.

Przeczytaj także

• Pomiar po stronie serwera w ChatGPT Ads
• Raportowanie przez API: podział na produkty i kraje
• Pierwsza kampania w ChatGPT Ads krok po kroku
• Obsługa ChatGPT Ads: nasza oferta prowadzenia kampanii, cennik i zakres prac

Najczęstsze pytania

Jak to powstaje?

Ten wpis napisał człowiek, a model przygotował pierwszą wersję roboczą. Obie strony są niżej wymienione z nazwy, razem ze źródłami, na których stoją twierdzenia.

• Tematy, opinie i ostatnia decyzja: Grzegorz Wysocki, właściciel emedia, agencji marketingowej z Lublina prowadzącej kampanie płatne i SEO dla klientów.
• Wersja robocza, kod i testy: Claude Opus 5 od Anthropic, w narzędziu Claude Code. Nic nie trafia na stronę bez przeczytania i poprawienia przez człowieka.
• Grafiki: sceny powstają z wykorzystaniem AI na bazie zdjęcia autora, a napisy składamy sami.

Źródła: centrum pomocy OpenAI i dokumentacja dla deweloperów, warunki oraz zasady reklamowe OpenAI, a także ustawienia i zrzuty z naszego własnego konta reklamowego. Liczby pochodzą z dokumentacji producenta albo z realnych kampanii. Jeśli czegoś nie wiemy, piszemy o tym wprost.

Źródła: OpenAI, dokumentacja interfejsu reklamowego dla deweloperów, w tym przewodnik startowy, kierowanie kampanii i konfiguracja partnerska, stan na 1 września 2026. Zrzuty z konta reklamowego emedia.

Realizacja: artykuł zrealizowany przez człowieka we współpracy z systemami AI. Redakcję i publikację firmuje autor. Wykorzystane systemy: Anthropic oraz OpenAI.