OpenAI Ads (Beta): Insights
openai_ads_insightsBETA — Leistungszahlen der OpenAI-Ads-Anzeigen (ChatGPT) je Kampagne, Anzeigengruppe oder Anzeige, plus Summe (total). Je Zeile: id, name, impressions, clicks, spend (Kontowährung), ctr_pct, cpc, conversions (Ziel-Conversions: Klick 30 Tage + View 1 Tag; nur mit verknüpftem Conversion-Ereignis, sonst 0). total rechnet ctr_pct, cpc und cost_per_conversion aus den Summen. level: campaign (Standard), ad_group oder ad. days: die letzten N vollen Tage bis gestern; date_from/date_to ('YYYY-MM-DD', inklusiv, Tage in der Zeitzone des Werbekontos) gehen vor, max. 365 Tage. date_to = heute ist möglich, aber die Kosten des laufenden Tages verbucht OpenAI verzögert (oft 0) — CPC und Kosten je Conversion sind dann zu niedrig. daily: true = eine Zeile je Tag (Feld date). campaign_ids: optional nur diese Kampagnen. workspace: Slug des Kunden-Workspace (optional bei nur einem Workspace).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "openai_ads_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| daily | No | ||
| level | No | campaign | |
| date_to | No | ||
| date_from | No | ||
| workspace | No | ||
| campaign_ids | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||