Bulk-Upload in ChatGPT Ads: die Vorlage, die Limits und sichere Massenbearbeitung

Was ist der Bulk-Upload im ChatGPT Ads Manager?

Der Bulk-Upload ist der Weg per Tabelle in den OpenAI Ads Manager Beta. Sie füllen eine Vorlage aus, die OpenAI Ad Schema Template nennt, laden sie hoch, und der Ads Manager erstellt oder aktualisiert jede Kampagne, Anzeigengruppe und Anzeige in der Datei.

Laut OpenAI unterstützt der Ads Manager Beta zwei Abläufe zum Erstellen von Kampagnen: die geführte Kampagnenerstellung, die Schritt für Schritt abläuft, und den Bulk-Upload. Beide erzeugen dieselbe Struktur mit drei Ebenen.

Die Vorlage finden Sie im Ads Manager. Der Leitfaden von OpenAI zum Kampagnenstart verweist auf Create und dann Upload bulk. Ist das Konto selbst noch nicht bereit, beginnen Sie mit unserem Leitfaden zur Einrichtung des Ads-Manager-Kontos.

Wann sollten Sie den Bulk-Upload statt der geführten Erstellung nutzen?

Nutzen Sie den Bulk-Upload, wenn Sie mehrere Kampagnen auf einmal starten oder viele Objekte in einem Durchgang ändern. OpenAI beschreibt ihn als am besten geeignet für größere Starts oder mehrere Kampagnen.

Der Grund liegt in der Menge der Werbemittel. OpenAI empfiehlt viele und vielfältige Anzeigen, mit mehreren Varianten von Titel und Text pro Angebot. Dutzende Varianten in ein Formular zu schreiben, ist langsam. In einer Tabelle geht es deutlich schneller.

Für Änderungen zieht OpenAI die Grenze so:

Eine Ausnahme: Der Bulk-Upload erstellt derzeit keine Produktfeed-Kampagnen. Sie werden im geführten Ablauf gebaut.

Nach unserer Einschätzung ist eine einzelne Kampagne mit einer Handvoll Anzeigen im geführten Ablauf schneller angelegt. Die Vorlage lohnt sich, sobald Sie darüber hinausgehen. Wenn Sie noch überlegen, wie Sie ein Konto strukturieren, lesen Sie zuerst ChatGPT Werbung schalten.

Was steht in der Vorlage für den Bulk-Upload?

Die Vorlage hat drei Tabs, und jede Zeile in einem Tab ist ein Objekt.

Einige dieser Felder brauchen eine Erklärung.

Budget beschreibt OpenAI als die maximalen Ausgaben pro Kampagne. Wie Budgets verteilt werden, erklärt unser Leitfaden Was kostet Werbung auf ChatGPT?.

Kampagnenziel ist entweder Views oder Clicks.

Max bid hängt von der Kampagne ab. Laut OpenAI tragen Sie für Reach-Kampagnen ein maximales CPM-Gebot ein und für Clicks-Kampagnen ein maximales CPC-Gebot. CPM ist der Preis pro tausend Impressionen, CPC der Preis pro Klick.

Die Tabs sind über Namen verknüpft. Ein Kampagnenname muss zwischen den Tabs campaigns und ad groups exakt übereinstimmen, ein Anzeigengruppenname zwischen den Tabs ad groups und ads. Ein Leerzeichen am Ende oder ein abweichender Großbuchstabe trennt die Verknüpfung.

Welche Limits gelten für den Bulk-Upload?

OpenAI veröffentlicht diese Limits in der Schema-Checkliste und im Leitfaden zum Kampagnenstart.

Daten werden im Format YYYY-MM-DD geschrieben.

Die Zahl 5.000 ist zugleich eine Obergrenze für das Konto. OpenAI weist darauf hin, dass jedes Werbekonto bis zu 5.000 Kampagnen, 5.000 Anzeigengruppen und 5.000 Anzeigen enthalten kann.

Die empfohlenen Längen sind viel kürzer als die Maxima. Auch die Prüfliste von OpenAI vor dem Einreichen nennt die empfohlenen Bereiche, nicht die Maxima. Deutsch gehört zu den Sprachen mit langen Wörtern: Schreiben Sie deshalb auf den empfohlenen Bereich hin und prüfen Sie die Vorschau. Um den Text selbst geht es in unserem Leitfaden zum Schreiben von ChatGPT-Anzeigen.

Wie formatieren Sie context hints und das Land in der Datei?

Beide Felder werden im JSON-Format geschrieben, nicht als einfacher Text, und beide führen zu abgelehnten Dateien.

Context hints sind eine JSON-Liste von Strings in der Form ["hint one", "hint two"]. Das heißt: gerade doppelte Anführungszeichen, ein Komma zwischen den Einträgen und eckige Klammern um die Liste. Die Einträge werden nicht durch senkrechte Striche oder Semikolons getrennt. Tabellenprogramme ersetzen gerade Anführungszeichen gern durch typografische; schalten Sie das vorher ab.

Country wird ebenfalls im JSON-Format ausgefüllt. Die Checkliste nennt für dieses Feld keinen Beispielwert. Übernehmen Sie das Format deshalb aus den Beispielzeilen der Vorlage selbst.

Ein context hint ist eine zusätzliche Angabe zu Ihrem Unternehmen, die den Systemen von OpenAI hilft zu verstehen, wann eine Anzeige relevant sein könnte. OpenAI verlangt einen klaren, natürlichen Satz mit einer einzigen Idee, keine Liste unzusammenhängender Keywords. Hints beeinflussen die Relevanz. Laut OpenAI sind sie keine Targeting-Regeln und können keine geografischen Grenzen, Zeitpläne oder Ausschlüsse erzwingen. Was hineingehört, erklärt unser Leitfaden zu context hints.

Welche Formatfehler führen zur Ablehnung einer Datei?

Laut OpenAI lehnt das System jedes Anzeigenschema ab, das den Anforderungen nicht exakt entspricht. Die Checkliste nennt diese Regeln:

• Behalten Sie in jedem Tab die Zeile mit den Spaltennamen.
• Benennen Sie die Tabs nicht um. Sie heißen weiterhin campaigns, ad groups und ads.
• Benennen Sie die Spaltenköpfe nicht um.
• Verbinden Sie keine Zellen.
• Jede Zeile muss ein eindeutiges Objekt sein. Keine doppelten Zeilen und keine doppelten Namen.
• Füllen Sie jedes Pflichtfeld aus.

Etwas Spielraum haben Sie. Sie dürfen Notizzeilen über der Kopfzeile einfügen, und Sie dürfen die Anleitungs- und Beispielzeilen der Vorlage entfernen oder verschieben. Der Ads Manager ignoriert Anleitungs- und Beispielzeilen bei der Validierung.

Was brauchen URLs von Bildern und Landingpages, um die Validierung zu bestehen?

Beide müssen für einen anonymen Besucher und für die Crawler von OpenAI laden.

Bilder. Die URL muss öffentlich erreichbar sein und sich im Browser direkt als Bild öffnen. OpenAI nennt als unterstütztes Hosting etwa Links von Google Drive, bei AWS gehostete Links wie S3 oder CloudFront und selbst gehostete Links auf Ihrer eigenen Domain oder Ihrem CDN. Die Validierung beim Upload oder die Prüfung kann scheitern, wenn das Bild eine Anmeldung verlangt, auf eine Vorschauseite weiterleitet, Crawler blockiert oder von einer Firewall- oder CDN-Regel blockiert wird.

Landingpages. Der Test von OpenAI lautet: Die URL lädt ohne Authentifizierung, liefert eine erfolgreiche Antwort und ist für die Crawler von OpenAI erreichbar.

Laut OpenAI halten sich die Crawler an robots.txt, und Dienste zum Schutz von Websites können sie irrtümlich blockieren, oft mit dem Fehler 403 Forbidden. OpenAI weist außerdem darauf hin, dass OAI-AdsBot bei Cloudflare offiziell verifiziert und auf der Allowlist ist.

Bulk-Uploads bringen ein eigenes Risiko mit. Ein großes Paket bedeutet viele Crawler-Besuche in kurzer Zeit, und das kann auf Ihrem eigenen Server ein Rate Limiting auslösen. OpenAI schlägt vor, Ihr Entwicklerteam nach Antworten mit 429 Too Many Requests suchen zu lassen und zu erwägen, Anzeigen über einen längeren Zeitraum in kleineren Paketen hochzuladen.

App-Store-Links, Deep Links und Seiten hinter einem Login liefern möglicherweise nicht genug crawlbaren Inhalt für die Prüfung. Nutzen Sie eine direkt erreichbare Webseite. Weitere Ursachen finden Sie in Warum ChatGPT-Anzeigen nicht ausgeliefert werden, und die Regeln für den Inhalt der Seite stehen in unserem Leitfaden zu den Anzeigenrichtlinien.

Wie laden Sie die Datei hoch und beheben Fehler?

Klicken Sie im Ads Manager auf Create und laden Sie dann die ausgefüllte Vorlage hoch. Schlägt bei der Verarbeitung etwas fehl, zeigt der Ads Manager eine konkrete Fehlermeldung.

Die Hinweise von OpenAI zur Behebung bestehen aus drei Teilen:

1. Korrigieren Sie die Vorlage. Die meisten Probleme entstehen durch Formatierung, Pflichtfelder, Links oder nicht übereinstimmende Namen.
2. Prüfen Sie das Ergebnis jeder Zeile, bevor Sie es erneut versuchen. Eine abgeschlossene Verarbeitung heißt nicht, dass jede Zeile erfolgreich war.
3. Wenden Sie sich an den Support, wenn Fehler bestehen bleiben. Senden Sie die Datei und die Fehlerdetails an ads-support@openai.com.

Schritt zwei verdient Aufmerksamkeit, denn ein unbedachter neuer Versuch erzeugt Duplikate. OpenAI warnt davor, Zeilen, die bereits erfolgreich waren, mit leerer ad_id erneut einzuspielen, weil dadurch doppelte Anzeigen entstehen können. Bevor Sie eine korrigierte Datei hochladen:

• Gleichen Sie die Anzeigen ab, die bereits erstellt wurden.
• Stellen Sie sicher, dass jede ad_group_id auf das beabsichtigte Ziel zeigt.
• Stellen Sie sicher, dass Bild-Links Bilddaten liefern und keine Vorschauseite.
• Laden Sie nur die Zeilen hoch, die Sie noch erstellen wollen.

Prüfen Sie nach dem Start, ob Kampagnen, Anzeigengruppen und Anzeigen aktiv sind. Laut OpenAI aktualisieren sich Impressionen, Klicks und CTR etwa alle 15 Minuten, während die Daten zu den Ausgaben 7 bis 8 Stunden verzögert sein können. Bei einer neuen Kampagne ohne erkennbares Hindernis bittet OpenAI darum, nach dem Start mindestens 24 Stunden zu warten, bevor Sie ein Problem mit fehlender Auslieferung melden. Wie Sie die Zahlen lesen, steht in Reporting und Datenschutz.

Wie bearbeiten Sie bestehende Kampagnen sicher in großer Zahl?

Starten Sie jedes Mal mit einem frischen Export. Der Ablauf, den OpenAI dokumentiert, hat fünf Schritte:

1. Wählen Sie die Kampagnen, Anzeigengruppen oder Anzeigen aus, die Sie ändern wollen.
2. Klicken Sie auf Export for edit.
3. Nehmen Sie die Änderungen in der exportierten Datei vor.
4. Klicken Sie im Ads Manager auf Create und dann auf Bulk upload.
5. Wählen Sie den Objekttyp, Campaign, Ad Group oder Ad, und laden Sie die Datei hoch.

IDs entscheiden, was mit jeder Zeile geschieht.

OpenAI erklärt, warum der Export wichtig ist: Er enthält die aktuellen IDs und Feldwerte. Das verringert versehentlich doppelte Zeilen, veraltete IDs und Überschreibungen. Am wichtigsten ist das, wenn andere Nutzer das Konto seit Ihrem letzten Download geändert haben könnten. Eine veraltete Datei trägt alte Werte und lädt sie über neuere Arbeit.

Fügt ein Upload mehr als einen Objekttyp hinzu, muss eine neue untergeordnete Zeile auf ein übergeordnetes Objekt verweisen, das bereits existiert oder bereits erstellt wurde.

Ersetzen hochgeladene context hints die alten?

Ja. Wenn Sie eine Anzeigengruppe per Bulk-Upload aktualisieren, werden die context hints in der Zeile zur vollständigen Liste dieser Anzeigengruppe. Laut OpenAI ist der hochgeladene Wert ein Ersatz, keine ergänzende Zusammenführung.

Dieser Fehler passiert am leichtesten. Ein Beispiel: Hat eine Anzeigengruppe zehn Hints und Sie laden eine Zeile mit zwei neuen hoch, hat die Anzeigengruppe danach zwei. Geben Sie immer die vollständige JSON-Liste an, die Sie behalten wollen.

Was kann eine Massenbearbeitung nicht ändern?

Manche Entscheidungen stehen mit dem Anlegen fest. OpenAI nennt das Kampagnenziel und den Budgettyp als Einstellungen, die nach dem Anlegen nicht mehr geändert werden sollen. Ist eines davon falsch, hilft nur eine neue Kampagne mit dem richtigen Setup, keine Bearbeitung.

Tabelle oder API: Welcher Weg passt für große Mengen?

Die Tabelle ist für Menschen gedacht, die im Ads Manager arbeiten. Die Advertiser API ist für Entwickler gedacht, die dieselbe Arbeit automatisieren wollen. OpenAI dokumentiert einen Bulk-Mutation-Job, der viele Kampagnen, Anzeigengruppen und Anzeigen asynchron erstellt oder aktualisiert.

Zwei Details der API sollten Sie kennen. Ist partial_failure auf true gesetzt, können nicht betroffene Operationen nach einem Fehler weiterlaufen, und laut OpenAI macht keiner der beiden Modi Operationen rückgängig, die bereits erfolgreich waren. Das Erstellen von Bulk-Jobs hat außerdem ein eigenes Rate Limit von 10 Anfragen pro 10 Sekunden für jedes Werbekonto.

Eine Checkliste vor dem Upload

Gehen Sie diese Liste vor jedem Upload durch. Sie folgt der Checkliste von OpenAI, in unserer Reihenfolge.

• Alle drei Tabs behalten ihre Namen und ihre Kopfzeilen.
• Kein Tab hat mehr als 5.000 Zeilen.
• Namen von Kampagnen und Anzeigengruppen sind eindeutig und stimmen über die Tabs hinweg exakt überein.
• Daten stehen im Format YYYY-MM-DD.
• Das Kampagnenziel ist Views oder Clicks.
• Country und context hints sind gültiges JSON mit geraden Anführungszeichen.
• Titel und Texte liegen innerhalb der Zeichenlimits.
• Jede Bild-URL öffnet in einem privaten Browserfenster das Bild selbst.
• Jede Landingpage lädt ohne Login und lässt OAI-AdsBot zu.
• Bei Bearbeitungen ist die Datei ein frischer Export, und jede Zeile, die aktualisiert werden soll, behält ihre ID.

Häufig gestellte Fragen

Funktioniert der Bulk-Upload für Produktfeed-Kampagnen?

Nein. Laut OpenAI unterstützt der Bulk-Upload das Erstellen von Produktfeed-Kampagnen derzeit nicht.

Wie viele Zeilen kann eine Datei enthalten?

Höchstens 5.000 Kampagnen, 5.000 Anzeigengruppen und 5.000 Anzeigen. Dieselben Zahlen sind die Obergrenze für ein Werbekonto.

Was trennt context hints innerhalb der Zelle?

Die JSON-Syntax. Die Zelle enthält eine Liste wie ["hint1", "hint2"], mit jedem Hint in geraden doppelten Anführungszeichen und einem Komma dazwischen.

Wird die ganze Datei abgelehnt, wenn eine Zeile scheitert?

Nicht unbedingt. Laut OpenAI kann die Verarbeitung abgeschlossen werden, auch wenn einzelne Zeilen scheitern. Prüfen Sie deshalb die Ergebnisse auf Zeilenebene, statt von alles oder nichts auszugehen.

Warum hat mein Upload doppelte Anzeigen erstellt?

Sehr wahrscheinlich wurde die Datei erneut hochgeladen, mit Zeilen, die bereits erfolgreich waren. Eine Zeile mit leerer ad_id erstellt bei jedem Upload eine neue Anzeige.

Kann ich Anzeigenbilder auf Google Drive hosten?

Ja, wenn der Link öffentlich verfügbar ist und das Bild direkt öffnet. Ein Link, der eine Vorschau- oder Anmeldeseite öffnet, scheitert.

Kann ich UTM-Parameter in die Spalte für die Landingpage-URL schreiben?

Ja. Laut OpenAI können Sie Tracking-Parameter direkt an Ziel-URLs anhängen, mit eigenen UTM-Parametern für jedes Werbemittel. Siehe unseren Leitfaden zu URL-Parametern für ChatGPT Ads.

Kann ich eine Kampagne per Massenbearbeitung von Views auf Clicks umstellen?

Nein. Das Kampagnenziel soll nach dem Anlegen nicht geändert werden. Legen Sie eine neue Kampagne an.

Kann der Support von OpenAI eine fehlgeschlagene Prüfung der Landingpage umgehen?

OpenAI sagt, Sie sollen sich nicht auf eine manuelle Umgehung verlassen. Beheben Sie den Crawler-Zugriff und laden Sie die betroffenen Anzeigen dann erneut hoch oder reichen Sie sie erneut ein, falls sich der Status nicht von selbst aktualisiert.

Wenn Sie die Vorlage lieber jemandem übergeben, der sie jede Woche ausfüllt, sehen Sie sich unsere Leistungen an.