Schnittstellen

Conversions API

Die Conversions API sendet Ereignisse aus deinem Backend an OpenAI – parallel zum Pixel und mit Deduplizierung über eine stabile Event-ID.

Was die Conversions API macht

Serverseitige Events aus Backend, Shop, CRM, Formular-Handler oder Server-Tagging. Nutze dieselben Eventtypen wie im Pixel und übergib für jedes Ereignis eine stabile ID: Pixel und API liefern dasselbe Ereignis, die identische event_id bzw. id sorgt für die Deduplizierung.

Beträge in der kleinsten Währungseinheit (12999 = 129,99 EUR).
timestamp_ms in Millisekunden seit Epoch.
validate_only: true zum Testen ohne Speicherung.

curl

curl -X POST "https://bzr.openai.com/v1/events?pid=<PIXEL_ID>" \
  -H "Authorization: Bearer <CONVERSIONS_API_KEY>" \
  -H "Content-Type: application/json" \
  --data '{
    "validate_only": false,
    "events": [{
      "id": "<EVENT_ID>",
      "type": "order_created",
      "timestamp_ms": <EVENT_TIMESTAMP_MS>,
      "source_url": "https://example.com/checkout/confirmation",
      "action_source": "web",
      "data": { "type": "contents", "amount": 12999, "currency": "EUR" }
    }]
  }'

API-Keys gehören ausschließlich in eine serverseitige Umgebung (Secrets, Env-Variablen). Niemals im Frontend-Code, in Repositories oder in Tag-Manager-Containern speichern.

Richtung merken

Conversions API = senden (Events raus).

Insights API = lesen (Kennzahlen rein).