Zum Inhalt springen
Tecrübetecrube.com
Assistenten-Tools · Einrichtung und Kampagnen

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 Credits

Verbundene 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 Credits

ChatGPT 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
statusOptionalactive | paused | archived—
nameOptionalstringnach Kampagnenname filtern (mind. 3 Zeichen)

openai_ads_performance_report

Lesen2 Credits

ChatGPT 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
levelOptionalad_account | campaign | ad_group | ad—
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
dailyOptionalboolean—
campaign_idsOptionalarray<string>—

chatgpt_ads_details

Lesen1 Credits

Alle 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
idPflichtstringcmpn_…, adgrp_… oder ad_…
hints_limitOptionalinteger (1–2000)—
hints_offsetOptionalinteger (0–…)—

chatgpt_ads_geo_lookup

Lesen1 Credits

Findet ChatGPT Ads-Standort-IDs (Länder, Regionen, Märkte, Postleitzahlen) nach Namen für das Standort-Targeting von Kampagnen. Nur lesend.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
queryPflichtstring—
limitOptionalinteger (1–100)—

chatgpt_ads_insights

Lesen2 Credits

ChatGPT 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
scope_idOptionalstringoptionale cmpn_/adgrp_/ad_-ID zur Eingrenzung des Berichts
levelOptionalad_account | campaign | ad_group | ad—
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
granularityOptionalnone | hourly | daily | monthly—
segmentOptionalnone | country | device | platform | product—
include_zeroOptionalbooleanZeilen ohne Impressionen hinzufügen (ohne Segment)
conversionsOptionalbooleanConversions, CPA, CVR, zugeordnete Umsätze und ROAS hinzufügen
limitOptionalinteger (1–2000)—
offsetOptionalinteger (0–…)—

chatgpt_ads_spend_limits

Lesen1 Credits

Ausgabenlimits des ChatGPT Ads-Kontos: Zeitraumfenster und wiederkehrende Tageslimits mit den bisherigen Ausgaben und dem, was bearbeitet werden kann. Nur lesend.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind

chatgpt_ads_conversion_setup

Lesen1 Credits

ChatGPT 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
check_recent_eventsOptionalboolean—

chatgpt_ads_ad_preview

Lesen1 Credits

Zeigt, 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
ad_idPflichtstring—

list_chatgpt_ads_custom_audiences

Lesen1 Credits

Listet die benutzerdefinierten ChatGPT-Ads-Zielgruppen des Werbekontos auf: ID, Name, Status und Revision. Nur Lesezugriff.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected

diagnose_chatgpt_ads_delivery

Lesen2 Credits

Erklä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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
campaign_idOptionalstring—
check_landing_pagesOptionalboolean—

Schreib-Tools14 Tools

update_openai_ads_campaign_status

Schreiben2 Credits

Pausiert 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
campaign_idPflichtstringcmpn_…
statusPflichtpause | activate—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_openai_ads_campaign_budget

Schreiben2 Credits

Legt 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
campaign_idPflichtstringcmpn_…
daily_budgetPflichtnumberneues 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 Credits

Verbindet 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.

ParameterTypBeschreibung
api_keyOptionalstringOpenAI Ads-API-Schlüssel eines Werbekontos
confirmOptionalboolean—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_chatgpt_ads_accounts

Schreiben0 Credits

Listet 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.

ParameterTypBeschreibung
actionOptionallist | recheck | disconnect | set_default—
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
confirmOptionalboolean—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_chatgpt_ads_campaign

Schreiben8 Credits

Erstellt 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
namePflichtstring—
daily_budgetOptionalnumber—
lifetime_budgetOptionalnumber—
objectiveOptionalimpressions | clicks | conversions—
descriptionOptionalstring—
include_locationsOptionalarray<string>Standort-IDs aus chatgpt_ads_geo_lookup
exclude_locationsOptionalarray<string>Standort-IDs aus chatgpt_ads_geo_lookup
platformsOptionalarray<ios_app | android_app | web | desktop_web | ios_web | android_web>—
custom_audience_idsOptionalarray<string>—
excluded_custom_audience_idsOptionalarray<string>—
startOptionalstringISO 8601 Datum und Uhrzeit (UTC ohne Offset)
endOptionalstringISO 8601 Datum und Uhrzeit (UTC ohne Offset)
conversion_event_setting_idsOptionalarray<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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
campaign_idPflichtstring—
nameOptionalstring—
daily_budgetOptionalnumber—
lifetime_budgetOptionalnumber—
statusOptionalactive | paused—
include_locationsOptionalarray<string>Standort-IDs aus chatgpt_ads_geo_lookup
exclude_locationsOptionalarray<string>Standort-IDs aus chatgpt_ads_geo_lookup
locations_modeOptionalreplace | add | remove—
platformsOptionalarray<ios_app | android_app | web | desktop_web | ios_web | android_web>—
startOptionalstringISO-8601-Datum/Uhrzeit (UTC, wenn kein Offset angegeben)
endOptionalstringISO-8601-Datum/Uhrzeit (UTC, wenn kein Offset angegeben)
conversion_event_setting_idsOptionalarray<string>—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_chatgpt_ads_ad_group

Schreiben5 Credits

Erstellt 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
campaign_idPflichtstring—
namePflichtstring—
max_bidOptionalnumberKontowährung: CPM bei Abrechnung nach Impressionen, CPC bei Klicks, CPA bei Conversion-Kampagnen
billing_eventOptionalimpression | click—
strategyOptionalfixed_bid | maximize_clicks | maximize_conversions—
allow_high_bidOptionalboolean—
context_hintsOptionalarray<string>—
descriptionOptionalstring—

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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
ad_group_idPflichtstring—
nameOptionalstring—
max_bidOptionalnumber—
strategyOptionalfixed_bid | maximize_clicks | maximize_conversions—
allow_high_bidOptionalboolean—
context_hintsOptionalarray<string>—
hints_modeOptionalreplace | add | remove—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_chatgpt_ads_ad

Schreiben8 Credits

Erstellt in einer Anzeigengruppe eine pausierte ChatGPT Ads-Chatkarten-Anzeige (Titel, Text, Ziel, Bild); OpenAI prüft sie. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
ad_group_idPflichtstring—
namePflichtstring—
titlePflichtstring3-50 Zeichen
bodyPflichtstringmax. 100 Zeichen
target_urlPflichtstring—
image_urlOptionalstringöffentliches https-Bild; OpenAI ruft es ab
file_idOptionalstring—

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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
ad_idPflichtstring—
nameOptionalstring—
titleOptionalstring—
bodyOptionalstring—
target_urlOptionalstring—
image_urlOptionalstring—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

chatgpt_ads_status

SchreibenUnumkehrbar5 Credits

Pausiert, aktiviert oder archiviert eine ChatGPT Ads-Kampagne, -Anzeigengruppe oder -Anzeige. Archivieren ist unumkehrbar und wartet immer auf ausdrückliche Freigabe. Zuerst Vorschau und Freigabe.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
kindOptionalcampaign | ad_group | ad—
idPflichtstring—
actionPflichtpause | 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 Credits

Erstellt 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
namePflichtstring—
event_typePflichtpage_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_idPflichtstringPixelquellen-ID (clidsrc_…)
custom_event_nameOptionalstring—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_chatgpt_ads_custom_audience

SchreibenUnumkehrbar5 Credits

Erstellt 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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — required only when several ChatGPT Ads accounts are connected
actionPflichtcreate | add | remove | archive—
audience_idOptionalstringcaud_… (not for create)
nameOptionalstring—
descriptionOptionalstring—
emailsOptionalarray<string>hashed before sending
phonesOptionalarray<string>+country code; hashed before sending
gaidsOptionalarray<string>—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_chatgpt_ads_spend_limit

SchreibenUnumkehrbar5 Credits

Erstellt, ä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.

ParameterTypBeschreibung
ad_account_idOptionalstringadacct_… — nur erforderlich, wenn mehrere ChatGPT Ads-Konten verbunden sind
actionPflichtcreate | update | delete | set_daily | delete_daily—
window_idOptionalstring—
start_dateOptionalstringYYYY-MM-DD, einschließlich
end_dateOptionalstringYYYY-MM-DD, ausschließlich
amountOptionalnumberKontowährung
nameOptionalstring—
io_idOptionalstring—
no_end_dateOptionalbooleanTageslimit ohne Enddatum

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.