Schnittstellen

Insights API

Die Insights API liest aggregierte Performance-Daten aus OpenAI Ads – für eigene Dashboards, Tracking-Apps und Agenturreporting.

Was die Insights API liefert

Ein sicherer Server-Job holt die Werte regelmäßig ab und speichert Tageswerte lokal – zusammen mit Kampagnen-, Ad-Group- und Ad-IDs als Stammdaten. Das Frontend liest danach nur noch aus der eigenen Datenbank.

Importiere Spend, Impressions, Clicks und Conversions.
time_granularity und aggregation_level bestimmen die Granularität.
Historie lokal halten, damit Reports unabhängig von API-Limits funktionieren.

curl

curl -sS -G "https://api.ads.openai.com/v1/ad_account/insights" \
  -H "Authorization: Bearer <OPENAI_ADS_API_KEY>" \
  --data-urlencode 'time_granularity=daily' \
  --data-urlencode 'aggregation_level=campaign' \
  --data-urlencode 'fields[]=metadata.readable_time' \
  --data-urlencode 'fields[]=campaign.id' \
  --data-urlencode 'fields[]=campaign.name' \
  --data-urlencode 'fields[]=campaign.impressions' \
  --data-urlencode 'fields[]=campaign.clicks' \
  --data-urlencode 'fields[]=campaign.spend'

<OPENAI_ADS_API_KEY> nur serverseitig speichern (Secrets/Env). Niemals im Browser-Code oder im Tag Manager ablegen.

Typischer Job

Server-Cron ruft täglich die Kennzahlen ab, speichert Tageswerte lokal und hält Kampagnen-IDs als Stammdaten.