Dieselben Zahlen wie im Anzeigenmanager kommen als JSON hinter einem Bearer-Token zurück
Der Anzeigenmanager unter ads.openai.com ist die Oberfläche, in der du Kampagnen anlegst und ihre Zahlen abliest. Daneben steht die Advertiser-API, also eine Schnittstelle: der Weg, auf dem ein Programm dieselben Daten abholt, die ein Mensch sonst auf dem Bildschirm sieht. OpenAI beschreibt sie in der Übersicht der Advertiser-API in zwei Sätzen:
The Advertiser API lets you manage ad campaigns, ad groups, ads, files, and reporting from one API. It supports CRUD-like functions with standard JSON content types.
Die Adresse dafür steht auf der Seite zur Authentifizierung und lautet https://api.ads.openai.com/v1. Jede Anfrage trägt im Kopf einen Bearer-Token, also einen langen Schlüssel, der für sich allein den Zugang öffnet und deshalb wie ein Passwort behandelt gehört. Auf den Referenzseiten der Advertiser-API steht jedes Beispiel als Aufruf mit dem Kommandozeilenwerkzeug curl, und die Seitenkarte der Ads-Doku führt zu keinem fertigen Programmpaket für eine Programmiersprache. Die Antwort kommt als JSON zurück, also als maschinenlesbarer Text mit benannten Feldern.
Darauf beruht der Unterschied zwischen einem Menschen, der ab und zu nachsieht, und einem Prüflauf, der sich meldet, sobald sich etwas ändert. Was im Anzeigenmanager als Punkt, Fahne oder Tabellenzeile erscheint, liegt in der Schnittstelle als benanntes Feld, und benannte Felder lassen sich zwischen zwei Läufen vergleichen. Die Übersichtsseite zählt dafür zehn Bereiche auf, darunter das Werbekonto, die Kampagnen, die Anzeigengruppen, die Anzeigen, die Auswertungen und die Konversionsmessung.
Der Schlüssel kommt aus den Einstellungen des Anzeigenmanagers und gilt für genau ein Werbekonto
Zwei Sätze auf der Übersichtsseite regeln, woher der Zugang kommt und wie weit er reicht:
Issue an API key in the Settings tab of Ads Manager. Each key is scoped to one ad account.
Der Schlüssel wird also im Anzeigenmanager selbst ausgestellt, im Reiter mit den Einstellungen. Weil er an genau ein Werbekonto gebunden ist, braucht kein Aufruf eine Kontokennung als Parameter: die steckt schon im Schlüssel. Wer mehrere Werbekonten betreut, braucht folglich mehrere Schlüssel; für Agenturen und Dienstleister beschreibt OpenAI das getrennt unter API Partner Setup, wo ein Partner den Schlüssel des jeweiligen Kundenkontos verwendet.
Wohin der Schlüssel gehört, sagt OpenAI an der Stelle deutlich, an der es um den zweiten Schlüssel dieses Kanals geht, den für die serverseitige Konversionsmessung, also für das Zählen der Abschlüsse, die aus einer Anzeige entstanden sind. Auf der Referenzseite zur Konversionsmessung steht dazu:
Store the returned key in a server-side secret manager. Never place it in browser code, client-visible environment variables, logs, or source control.
Für den Schlüssel der Advertiser-API gilt derselbe Gedanke, denn er öffnet dasselbe Werbekonto und dazu die schreibenden Aufrufe. Eine Ablage außerhalb des Projektordners, die ein Programm zur Laufzeit liest, hält ihn aus jeder Versionsverwaltung heraus.
Ein einziger Aufruf beantwortet, ob das Konto überhaupt ausliefern darf
Der Einstieg ist GET /ad_account. Die Referenzseite zum Werbekonto nennt dafür acht Felder in der Antwort: die Kennung, den Anzeigenamen, die hinterlegte Zieladresse, die Vorschauadresse des Favicons, den Status, die Zeitrechnung des Kontos, das Währungskürzel und review, den Stand der Markenprüfung. Das Favicon ist dabei das kleine Symbol, das der Browser im Reiter neben dem Seitennamen zeigt.
Dieses eine Feld entscheidet über alles Weitere. Auf derselben Seite steht im Abschnitt über die Markenangaben der Satz, der aus einer Statusabfrage eine Torwächterfrage macht:
Poll
GET /ad_accountuntilreview.statusisapproved. An account with any other review status cannot serve ads.
Welche Werte dort stehen können, legt das OpenAPI-Dokument fest, also die maschinenlesbare Beschreibung der ganzen Schnittstelle, die OpenAI unter openapi.json zum Herunterladen anbietet. Für jede Prüfung kennt es genau drei Zustände: in_review, rejected und approved. Kommt rejected zurück, kann daneben ein Feld reason stehen. Zwanzig Gründe zählt das Dokument dafür namentlich auf, darunter robots_txt, crawler_bot_blocked, crawler_403 und missing_favicon, und es lässt an derselben Stelle jede andere Zeichenkette zu. Ein Prüflauf bekommt den Grund damit als Wort in die Antwort geliefert, an derselben Stelle wie den Status.
Die zweite Prüfung steht im OpenAPI-Dokument und fehlt auf der Referenzseite zum Konto
Vor der ersten Auslieferung laufen bei OpenAI zwei getrennte Prüfungen, die wir in Dein Konto wird vorbereitet auseinandergenommen haben: die Prüfung des Werbetreibenden und eine zweite Kontoprüfung mit eigenem Stand. Auf der Referenzseite zum Werbekonto taucht nur die erste auf, als Feld review.
Die Antwort selbst führt mehr. Am 04.09.2026 kamen aus GET /ad_account neun Feldnamen zurück, also die acht dokumentierten und dazu account_integrity_review. Beschrieben ist dieses Feld allein im OpenAPI-Dokument: es enthält ein review mit demselben Statuswert wie oben und ein details mit den Feldern decision, reason und status_updated_at. Der letzte davon ist für eine Wache der interessanteste, weil er sagt, wann sich der Stand zuletzt bewegt hat.
Für ein Prüfprogramm hat das eine unangenehme Folge. Wer sich beim Bauen an die Referenzseite hält und nur review.status liest, bekommt ein Konto mit grünem Haken gemeldet, das trotzdem nichts ausspielt, weil die zweite Prüfung noch offen ist. Sichtbar wird der Unterschied erst, wenn beide Felder nebeneinander im Bericht stehen.
Die Anzeigenprüfung war durch, während die Kontoprüfung noch lief
Wie schnell die eine Prüfung gegenüber der anderen ist, sagt die Übersichtsseite für die Anzeigen selbst:
For an ad to show to users, the ad and its parent ad group and campaign all have to be enabled. The ad also has to be reviewed. Reviews typically take only a few minutes. Monitor the status with the
review_statusfield.
Genau diesen Abstand haben wir am 04.09.2026 in einer einzigen Leserunde gesehen. Die Anzeige im Konto trug review_status auf approved, war also inhaltlich geprüft und freigegeben. Im selben Durchgang stand account_integrity_review auf in_review, und als Zeitpunkt der letzten Änderung nannte das Feld weiterhin den 01.09.2026 um 07:41 UTC. Die Anzeigenprüfung war zu diesem Zeitpunkt fertig, die Kontoprüfung lief noch.
Über die Oberfläche wäre derselbe Befund zwei Klicks an zwei verschiedenen Stellen gewesen, und beide hätte jemand von Hand ansehen müssen. Aus der Schnittstelle kommen beide Stände in derselben Antwort, der zweite davon mit dem Zeitpunkt seiner letzten Änderung, und ein täglich laufendes Programm sieht einen Wechsel damit noch am selben Tag. Seit dem 04.09.2026 um 05:03 UTC steht die Kontoprüfung dieses Kontos auf freigegeben, das Konto selbst auf aktiv und die Markenprüfung ebenfalls auf freigegeben.
Warum eine Anzeige nicht ausliefert, gibt die Schnittstelle als Liste von Codes heraus
Im Anzeigenmanager steht neben einer stillstehenden Anzeige die Zeile "Nicht bereitgestellt", und den Grund bekommt man erst, wenn man mit dem Mauszeiger darüberfährt, nachgelesen in Dein Konto wird vorbereitet. Dieselbe Auskunft gibt es maschinenlesbar. GET /ads und GET /ad_groups nehmen einen Parameter include[]=serving_issues entgegen, und die Antwort trägt dann zu jedem Objekt eine Liste von Codes.
Am 04.09.2026 haben wir das ausprobiert. Die pausierte Anzeige kam mit zwei Codes zurück, ad_not_active und campaign_not_active, die Anzeigengruppe darüber mit campaign_not_active. Damit steht die vollständige Begründung für den Stillstand als Datenfeld in der Antwort, und ein Programm kann sie ablegen und mit dem Stand von gestern vergleichen.
Der Vorrat an möglichen Codes ist größer, als die Oberfläche vermuten lässt: das OpenAPI-Dokument führt für Anzeigen 28 Werte und für Anzeigengruppen 23. Darunter sind die Fälle, die ein Werbetreibender wirklich mitbekommen will, etwa ad_account_payment_method_missing_or_unauthorized, ad_account_threshold_payment_failed, campaign_budget_exhausted, landing_page_crawl_issue und ad_account_persona_verification_not_approved. Was hinter dem Zielseitenfall steckt, haben wir in ChatGPT Ads für Shopify-Shops beschrieben, wo das Prüfprogramm OAI-AdsBot die Seite abrufen können muss. Zu finden ist der Parameter include allein im OpenAPI-Dokument; die Parametertabelle der Referenzseite zu den Anzeigen führt ad_group_id, limit, after, before und order.
Listen kommen seitenweise, und ohne den Zeiger auf die nächste Seite bleibt es bei zwanzig Einträgen
Kampagnen, Anzeigengruppen, Anzeigen und Ereignisdefinitionen kommen als Liste zurück, und zwar seitenweise. Die Referenzseiten nennen dafür überall dieselbe Mechanik: verlangen lassen sich zwischen einem und fünfhundert Einträgen je Seite, ohne Angabe kommen bei Kampagnen, Anzeigengruppen und Anzeigen zwanzig, und für die Ereignisdefinitionen nennt die Doku keinen Standardwert. Jede Antwort sagt dazu, ob hinter der gelieferten Seite noch etwas liegt, und nennt die Kennung ihres ersten und ihres letzten Eintrags.
Wer diese Angaben ignoriert, liest zwanzig Einträge und hält sie für alle. Für ein Konto mit einer Handvoll Kampagnen fällt das nie auf; für ein gewachsenes Konto meldet der Prüflauf dann einen Ausschnitt und sieht dabei vollständig aus. Ein Programm nimmt deshalb die Kennung des letzten Eintrags und fordert damit die nächste Seite an, bis die Schnittstelle keine weitere mehr meldet.
Bei den Auswertungen gilt eine eigene Grenze. Die Referenzseite zu den Auswertungen erlaubt dort bis zu zweitausend Einträge je Seite und liefert ohne Angabe ebenfalls zwanzig. Zwei Eigenheiten kommen dazu. Mehrere Werte auf einmal, etwa Einblendungen und Klicks, will die Schnittstelle in Klammerschreibweise angehängt haben, also als fields[]=impressions&fields[]=clicks; denselben Namen zweimal ohne Klammern lehnt sie ab und nennt die Klammern in der Fehlermeldung selbst, nachgemessen am 04.09.2026. Und wer gar keine Werte nennt, bekommt laut Referenzseite die Einblendungen, dazu bei Ergebnissen, die sie in Zeitabschnitte gruppiert, den lesbaren Zeitpunkt und den Standardnamen der Zeile; Klicks und Ausgaben muss man ausdrücklich anfordern.
Eine Auswertung ohne Daten kommt als leere Liste zurück
Die Abfrage der Zahlen über die letzten 30 Tage hat am 04.09.2026 mit einer Erfolgsmeldung geantwortet, mit einer Zählung von null und einem leeren Datenfeld. Die Antwort enthielt damit überhaupt keine Zeile, auch keine mit Nullen darin.
Wer daraus einen Bericht baut, muss diesen Fall eigens abfangen. Eine leere Antwort der Schnittstelle und eine echt gemessene Null sehen im fertigen Bericht gleich aus, sobald ein fehlendes Feld unterwegs als Null gelesen wird: es steht dann "0 Einblendungen, 0 Klicks" da, obwohl die Schnittstelle in Wahrheit keine Auskunft gegeben hat.
Ein Konto, das ausliefert und heute null Klicks hat, ein Konto, das seit Tagen pausiert ist, und ein Aufruf, der gescheitert ist, dürfen im Bericht nicht dieselbe Zeile erzeugen. Für dieses Konto gibt dieselbe Abfrage seit dem 05.09.2026 Zahlen heraus: zwei Kampagnen brachten 11.789 Einblendungen und 90 Klicks, ohne eine einzige Anfrage, nachzulesen in 150 Euro ChatGPT Ads Test.
Der Ereignisstrom zeigt, ob das Messpixel in den letzten fünfzehn Minuten etwas gemeldet hat
Zur Konversionsmessung gehören drei Objekte, die alle drei lesbar sind: das Messpixel unter GET /conversions/pixels, die Ereignisdefinitionen unter GET /conversions/event_settings und der Ereignisstrom unter GET /conversions/events. Das Messpixel ist das Stück Code auf der eigenen Seite, das ein Ereignis an OpenAI meldet, und die Ereignisdefinitionen tragen ein Feld archived, mit dem sich prüfen lässt, ob eine Definition noch aktiv ist.
Der Ereignisstrom ist die schnellste Antwort auf die Frage, ob der Einbau auf der Seite noch tut. Die Referenzseite beschreibt ihn so:
It returns up to 50 conversion events received from the Pixel SDK during the previous 15 minutes.
Sie setzt zugleich die Grenze seiner Aussagekraft:
Use this endpoint to confirm that recent browser events reached OpenAI, not for attribution or reporting.
Verfügbar ist er nicht überall. OpenAI schreibt dazu, der Strom stehe nur freigeschalteten Konten offen und antworte sonst mit einem 404. Am 04.09.2026 hat der Aufruf mit der Pixel-Kennung mit einer leeren Liste geantwortet, der Strom stand für dieses Konto also offen, und in den fünfzehn Minuten davor war kein Ereignis eingegangen. Warum eine leere Liste in Europa der Normalfall ist, solange niemand der Messung zugestimmt hat, und wie Pixel und Server dasselbe Ereignis nur einmal zählen, steht in Conversion-Tracking für ChatGPT Ads einrichten.
Ein falscher Schlüssel bringt eine 401 und schickt dich auf die falsche Seite
Am 04.09.2026 haben wir einen erfundenen Schlüssel gegen die Kontoabfrage geschickt, um zu sehen, was in diesem Fall zurückkommt. Die Antwort war eine 401, und im Text stand:
Incorrect API key provided: sk-falsc*******0000. You can find your API key at https://platform.openai.com/account/api-keys.
Die genannte Adresse ist die Schlüsselseite der OpenAI-Plattform, auf der die Schlüssel für die Sprachmodelle liegen. Der Schlüssel für die Advertiser-API wird laut Übersichtsseite dagegen im Anzeigenmanager ausgestellt, unter einer anderen Adresse und in einem anderen Konto. Wer die Fehlermeldung wörtlich nimmt, sucht an der falschen Stelle und findet dort ein Konto ohne Werbezugang.
Die abgelehnte Anfrage kommt dabei in derselben Form zurück wie eine beantwortete, als sauber aufgebautes JSON mit benannten Feldern. Wer allein die Form prüft, verbucht die Absage als Ergebnis; erkennbar ist sie am Statuscode. Dieselbe Absage steht außerdem für mehrere verschiedene Ursachen: ein vertauschter Schlüssel, ein leer gebliebener Umgebungswert und eine abgelaufene Berechtigung sind an der Antwort nicht zu unterscheiden.
Acht Aufrufe lesen ein kleines Konto vollständig, die Grenze liegt bei 600 je Minute und Endpunkt
Ein Lauf, der ein Konto einmal ganz ansieht, ist kein großer Vorgang. Am 04.09.2026 gezählt: acht Aufrufe in 3,8 Sekunden, verteilt auf ad_account, campaigns, ad_groups, ads, ad_account/insights, conversions/pixels, conversions/event_settings und custom_audiences. Die Zahl wächst mit dem Konto, weil je Kampagne ein Aufruf für die Gruppen und je Gruppe einer für die Anzeigen dazukommt.
Dagegen stehen die Grenzen, die OpenAI auf der Übersichtsseite nennt: 600 Anfragen je Minute und Endpunkt, also je Adresse der Schnittstelle, 1.200 Anfragen je Minute insgesamt, jeweils sowohl je Werbekonto als auch je IP-Adresse. Für die Anlage von Sammelaufträgen gilt eine eigene Grenze von zehn Anfragen je zehn Sekunden.
Wie viel vom Kontingent noch übrig ist, verrät die Antwort selbst nicht. Am 04.09.2026 haben wir die Kopfzeilen einer erfolgreichen Antwort aufgelistet; ein Feld mit "ratelimit" im Namen war nicht darunter. Enthalten sind dagegen openai-processing-ms und x-request-id, und die zweite lohnt sich zu protokollieren: OpenAI empfiehlt in der allgemeinen API-Referenz, Anfrage-Kennungen im Produktivbetrieb mitzuschreiben, weil sich eine einzelne Anfrage damit später gegenüber dem Support benennen lässt.
Eine Wache vergleicht den heutigen Stand mit dem von gestern
Aus den Feldern dieses Berichts wird eine Wache, sobald der Lauf seinen letzten Stand aufhebt und den neuen dagegen hält. Sechs Angaben lohnen den Vergleich, weil ihr Wechsel etwas bedeutet: der Stand der Markenprüfung, der Stand der zweiten Kontoprüfung mitsamt dem Zeitpunkt seiner letzten Änderung, ob eine Anzeige läuft und ob sie geprüft ist, die Gründe für einen Stillstand an Anzeigen und Gruppen, die Zahl der noch aktiven Ereignisdefinitionen und die Zahlen der letzten 30 Tage.
Zwei Eigenheiten des Kanals sind dabei einzuplanen. Eine Erfolgsmeldung bestätigt allein, dass der Aufruf angekommen ist; wie der Zustand im Konto danach aussieht, zeigt erst das Nachlesen. Und die Kopfzeile, die einen versehentlich zweimal geschickten Anlegeauftrag als denselben ausweisen soll, der Idempotency-Key, trägt hier nicht: am 02.09.2026 hat derselbe Schlüssel mit demselben Körper eine zweite Ereignisdefinition angelegt statt die erste zurückzugeben, nachzulesen in Conversion-Tracking für ChatGPT Ads einrichten.
Was ein solcher Lauf nicht leisten kann, gehört dazu. Er verkürzt keine Prüfung, denn beschleunigen lässt sich die laut OpenAI ohnehin nicht. Er ersetzt auch die Rechnung nicht, ob der Kanal für einen Shop trägt: dafür braucht es Klickpreise und Deckungsbeiträge. Was 150 Euro auf diesem Platz gebracht haben, steht in 150 Euro ChatGPT Ads Test, die veröffentlichten Klickpreise aus acht Feldtests in ChatGPT Ads Erfahrungen aus über 63.000 Dollar Werbebudget.
Was in diesem Fall gilt
Die Advertiser-API von OpenAI gibt den Stand eines ChatGPT-Ads-Kontos vollständig als JSON heraus, hinter einem Bearer-Token aus den Einstellungen des Anzeigenmanagers, der für genau ein Werbekonto gilt. Am 04.09.2026 haben acht Aufrufe in 3,8 Sekunden gereicht, um Konto, beide Prüfstände, Kampagne, Anzeigengruppe, Anzeige, die Zahlen der letzten 30 Tage, das Pixel und seine vier Ereignisdefinitionen zu lesen. In derselben Runde war die Anzeigenprüfung freigegeben, während die Kontoprüfung seit dem 01.09.2026 um 07:41 UTC noch lief; seit dem 04.09.2026 um 05:03 UTC steht auch sie auf freigegeben und das Konto auf aktiv. Zwei Angaben, die dabei den Ausschlag geben, stehen nur im OpenAPI-Dokument: die zweite Kontoprüfung und der Zusatz, der zu Anzeigen und Gruppen die Gründe für einen Stillstand mitliefert, am selben Tag ad_not_active und campaign_not_active. Drei Stellen haben beim Bauen Aufmerksamkeit gekostet: eine Liste endet erst, wenn die Antwort keine weitere Seite mehr meldet, eine Auswertung ohne Daten kommt ohne jede Zeile zurück, und ein falscher Schlüssel bringt eine 401 mit einem Verweis auf die Schlüsselseite der Plattform, auf der der Ads-Schlüssel nicht liegt.
