ChatGPT-Ads-Tools
Über die OpenAI Ads API verbundene ChatGPT-Werbekonten: Kampagnenliste, Leistungsbericht, Budget- und Statusänderungen.
Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind Übersetzungen des Textes, den der Assistent sieht, Tool- und Parameternamen bleiben unverändert.
Lese-Tools11 Tools
list_openai_ads_accounts
Lesen1 CreditsVerbundene ChatGPT Ads-Konten (OpenAI Ads): ad_account_id, Name, Währung, Zeitzone, Konto- und Prüfstatus. Jedes Konto wird im Panel mit seinem eigenen Ads-API-Schlüssel verbunden. Nur lesend; connected=false, wenn keines vorhanden ist.
Dieses Tool hat keine Parameter.
list_openai_ads_campaigns
Lesen1 CreditsChatGPT Ads-Kampagnen aus der OpenAI Ads API: id (cmpn_…), Name, Status, Tages- oder Laufzeitbudget (Kontowährung), Gebotstyp, Zeitplan. Nur lesend; gibt connected=false zurück, wenn kein Konto verknüpft ist.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
statusOptional | active | paused | archived | — |
nameOptional | string | nach Kampagnenname filtern (mind. 3 Zeichen) |
openai_ads_performance_report
Lesen2 CreditsChatGPT Ads-Auslieferungsbericht (OpenAI Ads Insights): Impressionen, Klicks, Ausgaben, CTR, CPC, CPM pro Konto, Kampagne, Anzeigengruppe oder Anzeige für einen Zeitraum in der Zeitzone des Kontos, optional pro Tag. Nur lesend; erfindet nie Zahlen.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
levelOptional | ad_account | campaign | ad_group | ad | — |
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
dailyOptional | boolean | — |
campaign_idsOptional | array<string> | — |
chatgpt_ads_details
Lesen1 CreditsAlle Details einer ChatGPT Ads-Kampagne (mit ihren Anzeigengruppen), einer Anzeigengruppe (Gebote, Kontexthinweise, Anzeigen) oder einer Anzeige (Creative, Prüfung), einschließlich der von OpenAI gemeldeten Auslieferungsprobleme. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
idPflicht | string | cmpn_…, adgrp_… oder ad_… |
hints_limitOptional | integer (1–2000) | — |
hints_offsetOptional | integer (0–…) | — |
chatgpt_ads_geo_lookup
Lesen1 CreditsFindet ChatGPT Ads-Standort-IDs (Länder, Regionen, Märkte, Postleitzahlen) nach Namen für das Standort-Targeting von Kampagnen. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
queryPflicht | string | — |
limitOptional | integer (1–100) | — |
chatgpt_ads_insights
Lesen2 CreditsChatGPT Ads-Auslieferungsbericht mit den Optionen von OpenAI: stündliche/tägliche/monatliche Intervalle, Aufschlüsselung nach Land/Gerät/Plattform/Produkt, Zeilen ohne Impressionen und Conversion-Metriken, für das Konto oder eine Kampagne, Anzeigengruppe oder Anzeige. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
scope_idOptional | string | optionale cmpn_/adgrp_/ad_-ID zur Eingrenzung des Berichts |
levelOptional | ad_account | campaign | ad_group | ad | — |
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
granularityOptional | none | hourly | daily | monthly | — |
segmentOptional | none | country | device | platform | product | — |
include_zeroOptional | boolean | Zeilen ohne Impressionen hinzufügen (ohne Segment) |
conversionsOptional | boolean | Conversions, CPA, CVR, zugeordnete Umsätze und ROAS hinzufügen |
limitOptional | integer (1–2000) | — |
offsetOptional | integer (0–…) | — |
chatgpt_ads_spend_limits
Lesen1 CreditsAusgabenlimits des ChatGPT Ads-Kontos: Zeitraumfenster und wiederkehrende Tageslimits mit den bisherigen Ausgaben und dem, was bearbeitet werden kann. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
chatgpt_ads_conversion_setup
Lesen1 CreditsChatGPT Ads-Conversion-Tracking: Pixel (Quellen), Einstellungen für Conversion-Ereignisse und die Kampagnen, die sie nutzen, plus die in etwa den letzten 15 Minuten empfangenen Ereignisse. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
check_recent_eventsOptional | boolean | — |
chatgpt_ads_ad_preview
Lesen1 CreditsZeigt, wie eine bestehende ChatGPT Ads-Anzeige aussieht (temporäre 24-Stunden-Vorschau), zusammen mit ihrem Prüfstatus und den von OpenAI gemeldeten Auslieferungshindernissen. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
ad_idPflicht | string | — |
list_chatgpt_ads_custom_audiences
Lesen1 CreditsListet die benutzerdefinierten ChatGPT-Ads-Zielgruppen des Werbekontos auf: ID, Name, Status und Revision. Nur Lesezugriff.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
diagnose_chatgpt_ads_delivery
Lesen2 CreditsErklärt, warum ChatGPT Ads keine Impressionen erhalten: prüft Kontostatus und Überprüfungen, Ausgabenlimits sowie jede Kampagne, Anzeigengruppe und Anzeige auf von OpenAI gemeldete Auslieferungsprobleme (optional mit Crawls der Zielseiten) und liefert priorisierte Befunde mit Beleg, Lösung und dem Tool, das sie anwendet. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
campaign_idOptional | string | — |
check_landing_pagesOptional | boolean | — |
Schreib-Tools14 Tools
update_openai_ads_campaign_status
Schreiben2 CreditsPausiert oder aktiviert eine ChatGPT Ads-Kampagne. Gibt eine Vorschau und ein Freigabeelement zurück; wird erst nach der Freigabe bei OpenAI angewendet und ist rückgängig machbar. Die Aktivierung startet die Auslieferung nur, wenn die übrigen Anforderungen von OpenAI (Prüfungen, Budget) erfüllt sind.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
campaign_idPflicht | string | cmpn_… |
statusPflicht | pause | activate | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_openai_ads_campaign_budget
Schreiben2 CreditsLegt das Tagesbudget einer ChatGPT Ads-Kampagne fest. Durchläuft Vorschau und Freigabe; Erhöhungen über 50 % pro Änderung oder 2× innerhalb von 24 Stunden werden blockiert; Undo stellt das vorherige Budget wieder her. Kampagnen mit Laufzeitbudget werden nicht geändert.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
campaign_idPflicht | string | cmpn_… |
daily_budgetPflicht | number | neues Tagesbudget in der Kontowährung (nicht in Micros) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
connect_chatgpt_ads
Schreiben0 CreditsVerbindet ein ChatGPT Ads-Werbekonto (OpenAI Ads): ohne Schlüssel wird der Weg über das Panel erklärt; mit api_key und confirm=true wird der Schlüssel bei OpenAI geprüft und verschlüsselt gespeichert (nur Inhaber/Admin). Der Schlüssel wird nie wieder ausgegeben.
| Parameter | Typ | Beschreibung |
|---|---|---|
api_keyOptional | string | OpenAI Ads-API-Schlüssel eines Werbekontos |
confirmOptional | boolean | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_chatgpt_ads_accounts
Schreiben0 CreditsListet die verbundenen ChatGPT Ads-Konten, prüft eines erneut gegen OpenAI (Status, Prüfung, Währung), trennt es oder macht es zum Standard, der ohne ad_account_id verwendet wird. Trennen und Standard setzen erfordern confirm=true.
| Parameter | Typ | Beschreibung |
|---|---|---|
actionOptional | list | recheck | disconnect | set_default | — |
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
confirmOptional | boolean | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_chatgpt_ads_campaign
Schreiben8 CreditsErstellt eine ChatGPT Ads-Kampagne (immer pausiert) mit Tages- oder Laufzeitbudget in Kontowährung, Ziel, Standorten, Plattformen, Zielgruppen, Zeitplan und Conversion-Ziel. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
namePflicht | string | — |
daily_budgetOptional | number | — |
lifetime_budgetOptional | number | — |
objectiveOptional | impressions | clicks | conversions | — |
descriptionOptional | string | — |
include_locationsOptional | array<string> | Standort-IDs aus chatgpt_ads_geo_lookup |
exclude_locationsOptional | array<string> | Standort-IDs aus chatgpt_ads_geo_lookup |
platformsOptional | array<ios_app | android_app | web | desktop_web | ios_web | android_web> | — |
custom_audience_idsOptional | array<string> | — |
excluded_custom_audience_idsOptional | array<string> | — |
startOptional | string | ISO 8601 Datum und Uhrzeit (UTC ohne Offset) |
endOptional | string | ISO 8601 Datum und Uhrzeit (UTC ohne Offset) |
conversion_event_setting_idsOptional | array<string> | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_chatgpt_ads_campaign
Schreiben5 CreditsÄndert eine ChatGPT Ads-Kampagne: Name, Budget, Standorte (ersetzen / hinzufügen / entfernen), Plattformen, Zeitplan, Conversion-Ereignisse oder Status. Budgeterhöhungen über 50 % werden blockiert. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
campaign_idPflicht | string | — |
nameOptional | string | — |
daily_budgetOptional | number | — |
lifetime_budgetOptional | number | — |
statusOptional | active | paused | — |
include_locationsOptional | array<string> | Standort-IDs aus chatgpt_ads_geo_lookup |
exclude_locationsOptional | array<string> | Standort-IDs aus chatgpt_ads_geo_lookup |
locations_modeOptional | replace | add | remove | — |
platformsOptional | array<ios_app | android_app | web | desktop_web | ios_web | android_web> | — |
startOptional | string | ISO-8601-Datum/Uhrzeit (UTC, wenn kein Offset angegeben) |
endOptional | string | ISO-8601-Datum/Uhrzeit (UTC, wenn kein Offset angegeben) |
conversion_event_setting_idsOptional | array<string> | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_chatgpt_ads_ad_group
Schreiben5 CreditsErstellt unter einer ChatGPT Ads-Kampagne eine pausierte Anzeigengruppe mit Gebotsstrategie, Höchstgebot und Kontexthinweisen (wann die Anzeige nützlich wäre). Ungewöhnlich hohe Gebote erfordern allow_high_bid. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
campaign_idPflicht | string | — |
namePflicht | string | — |
max_bidOptional | number | Kontowährung: CPM bei Abrechnung nach Impressionen, CPC bei Klicks, CPA bei Conversion-Kampagnen |
billing_eventOptional | impression | click | — |
strategyOptional | fixed_bid | maximize_clicks | maximize_conversions | — |
allow_high_bidOptional | boolean | — |
context_hintsOptional | array<string> | — |
descriptionOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_chatgpt_ads_ad_group
Schreiben5 CreditsÄndert Name, Höchstgebot, Gebotsstrategie oder Kontexthinweise (ersetzen / hinzufügen / entfernen) einer ChatGPT Ads-Anzeigengruppe. Gebotssprünge über 50 % erfordern allow_high_bid. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
ad_group_idPflicht | string | — |
nameOptional | string | — |
max_bidOptional | number | — |
strategyOptional | fixed_bid | maximize_clicks | maximize_conversions | — |
allow_high_bidOptional | boolean | — |
context_hintsOptional | array<string> | — |
hints_modeOptional | replace | add | remove | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_chatgpt_ads_ad
Schreiben8 CreditsErstellt in einer Anzeigengruppe eine pausierte ChatGPT Ads-Chatkarten-Anzeige (Titel, Text, Ziel, Bild); OpenAI prüft sie. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
ad_group_idPflicht | string | — |
namePflicht | string | — |
titlePflicht | string | 3-50 Zeichen |
bodyPflicht | string | max. 100 Zeichen |
target_urlPflicht | string | — |
image_urlOptional | string | öffentliches https-Bild; OpenAI ruft es ab |
file_idOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_chatgpt_ads_ad
Schreiben5 CreditsÄndert Text, Ziel oder Bild einer ChatGPT Ads-Anzeige (der Rest des Creatives bleibt erhalten); ein geändertes Creative wird erneut geprüft. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
ad_idPflicht | string | — |
nameOptional | string | — |
titleOptional | string | — |
bodyOptional | string | — |
target_urlOptional | string | — |
image_urlOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
chatgpt_ads_status
SchreibenUnumkehrbar5 CreditsPausiert, aktiviert oder archiviert eine ChatGPT Ads-Kampagne, -Anzeigengruppe oder -Anzeige. Archivieren ist unumkehrbar und wartet immer auf ausdrückliche Freigabe. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
kindOptional | campaign | ad_group | ad | — |
idPflicht | string | — |
actionPflicht | pause | activate | archive | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_chatgpt_ads_event_setting
Schreiben5 CreditsErstellt für eine Pixelquelle eine ChatGPT Ads-Einstellung für Conversion-Ereignisse (welches erfasste Ereignis als Conversion zählt), nutzbar als Kampagnenziel. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
namePflicht | string | — |
event_typePflicht | page_viewed | contents_viewed | items_added | checkout_started | order_created | lead_created | registration_completed | subscription_created | trial_started | appointment_scheduled | plan_enrollment | app_installed | app_opened | custom | — |
source_idPflicht | string | Pixelquellen-ID (clidsrc_…) |
custom_event_nameOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_chatgpt_ads_custom_audience
SchreibenUnumkehrbar5 CreditsErstellt eine leere benutzerdefinierte ChatGPT-Ads-Zielgruppe, fügt Mitglieder hinzu oder entfernt sie, archiviert die Zielgruppe. Nur eigene Daten mit Nutzungsrecht; E-Mail und Telefon werden vor dem Senden gehasht. Nicht für Kampagnen im EWR und in der Schweiz.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — required only when several ChatGPT Ads accounts are connected |
actionPflicht | create | add | remove | archive | — |
audience_idOptional | string | caud_… (not for create) |
nameOptional | string | — |
descriptionOptional | string | — |
emailsOptional | array<string> | hashed before sending |
phonesOptional | array<string> | +country code; hashed before sending |
gaidsOptional | array<string> | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_chatgpt_ads_spend_limit
SchreibenUnumkehrbar5 CreditsErstellt, ändert oder entfernt ein Ausgabenlimit eines ChatGPT Ads-Kontos (Zeitraumfenster oder wiederkehrendes Tageslimit). Erhöhungen über 50 % werden blockiert; Entfernungen warten immer auf ausdrückliche Freigabe. Zuerst Vorschau und Freigabe.
| Parameter | Typ | Beschreibung |
|---|---|---|
ad_account_idOptional | string | adacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind |
actionPflicht | create | update | delete | set_daily | delete_daily | — |
window_idOptional | string | — |
start_dateOptional | string | YYYY-MM-DD, einschließlich |
end_dateOptional | string | YYYY-MM-DD, ausschließlich |
amountOptional | number | Kontowährung |
nameOptional | string | — |
io_idOptional | string | — |
no_end_dateOptional | boolean | Tageslimit ohne Enddatum |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.