Werbe-Insights abfragen

Rufe begrenzte offizielle Ergebnisse bezahlter Werbung mit ausdrücklichen Datumsangaben, Zeitzone, Währung, Attributionsfenster und Conversion-Aktion ab. Fehlende Kennzahlen bleiben fehlend.

POST /advertising-api/insights/query

Vertrag geprüft: 2026-11-03 · sha256:9aedef8d43dd4514

Als Markdown lesen Öffentlichen Vertrag herunterladen OpenAPI herunterladen

Überblick

Rufe begrenzte offizielle Ergebnisse bezahlter Werbung mit ausdrücklichen Datumsangaben, Zeitzone, Währung, Attributionsfenster und Conversion-Aktion ab. Fehlende Kennzahlen bleiben fehlend.

Eine erfolgreiche HTTP-Antwort kann Annahme statt Abschluss bedeuten. Speichere bei Hintergrundarbeit die ID und prüfe dieselbe Operation bis zum Abschluss. Geplante oder angenommene Beiträge gelten erst nach Plattformbestätigung als veröffentlicht; ein Client-Timeout klärt das Ergebnis nicht.

Authentifizierung und Berechtigungen

Akzeptierte Zugangsdatenklassen: user_session, delegated_oauth, personal_access_token
Delegierte Funktion: agent:advertising_read
Minimale Workspace-Rolle: viewer
Zugriffsumfang: Ressourcen, auf die dieser Nutzer zugreifen darf
Zustimmung für alle Workspaces erforderlich: Nein
Ändert Zustand: Nein
Nach Abschluss der Operation: synchronous_http_response

Ein Token nutzt nur Eigentümerrechte. Jede Anfrage prüft Workspace-Mitgliedschaft, Ressourceneigentum, gewählte Workspaces und Funktionen. core und full ändern sichtbare Tools; sie erteilen keinen Zugriff.

Anfragefelder

Erforderlich bedeutet innerhalb des übergeordneten Objekts und gewählten Zweigs erforderlich. Ein erforderliches Kind macht kein optionales Elternobjekt erforderlich. Regeln und Feldnamen unten stammen aus dem Vertrag.

Anfragefelder
Feld / Variante	Typ / erforderlich	Einschränkungen
`$`	`object`Im Elternobjekt erforderlich	`additionalProperties: false`
`workspace_id`	`string`Im Elternobjekt erforderlich	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`advertising_account_id`	`string`Im Elternobjekt erforderlich	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`level`	`string`Im Elternobjekt erforderlich	`enum: ["campaign","adset","ad"]`
`start_date`	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`end_date`	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`action_attribution_windows`	`array`Im Elternobjekt erforderlich	`minItems: 1` `maxItems: 1`
`action_attribution_windows[]`	`string`Optional / Element	`enum: ["1d_click","7d_click","1d_view"]`
`action_report_time`	`string`Im Elternobjekt erforderlich	`enum: ["impression","conversion"]`
`conversion_action_type`	`string`Im Elternobjekt erforderlich	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`revenue_action_type`	`string`Im Elternobjekt erforderlich	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`after`	`string`Optional / Element	`maxLength: 2048`
`limit`	`integer`Optional / Element	`minimum: 1` `maximum: 50` `default: 25`

Vollständiges JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "advertising_account_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "level": {
      "type": "string",
      "enum": [
        "campaign",
        "adset",
        "ad"
      ]
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "action_attribution_windows": {
      "minItems": 1,
      "maxItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "1d_click",
          "7d_click",
          "1d_view"
        ]
      }
    },
    "action_report_time": {
      "type": "string",
      "enum": [
        "impression",
        "conversion"
      ]
    },
    "conversion_action_type": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_.]{0,99}$"
    },
    "revenue_action_type": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_.]{0,99}$"
    },
    "after": {
      "type": "string",
      "maxLength": 2048
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "workspace_id",
    "advertising_account_id",
    "level",
    "start_date",
    "end_date",
    "action_attribution_windows",
    "action_report_time",
    "conversion_action_type",
    "revenue_action_type"
  ],
  "additionalProperties": false
}

Antwort und Abschluss

HTTP-Erfolgsstatus: 200. Wenn die Operation abgeschlossen ist: synchronous_http_response.

Antwort und Abschluss
Feld / Variante	Typ / erforderlich	Einschränkungen
`$`	`object`Im Elternobjekt erforderlich	—
`contract_version`	`string`Im Elternobjekt erforderlich	`const: "ad-performance/v1"`
`source_id`	`string`Im Elternobjekt erforderlich	`maxLength: 100`
`source_sha256`	`string`Im Elternobjekt erforderlich	`pattern: "^[a-f0-9]{64}$"`
`identity_verification`	`string`Im Elternobjekt erforderlich	`enum: ["customer_supplied","accepted_provider_grant"]`
`currency`	`string`Im Elternobjekt erforderlich	`pattern: "^[A-Z]{3}$"`
`timezone`	`string`Im Elternobjekt erforderlich	`maxLength: 100`
`selection`	`object`Im Elternobjekt erforderlich	—
`selection.provider_api_version`	`string`Im Elternobjekt erforderlich	`const: "v26.0"`
`selection.provider_account_id`	`string`Im Elternobjekt erforderlich	`pattern: "^[1-9]\\d{1,24}$"`
`selection.currency`	`string`Im Elternobjekt erforderlich	`pattern: "^[A-Z]{3}$"`
`selection.timezone`	`string`Im Elternobjekt erforderlich	`maxLength: 100`
`selection.level`	`string`Im Elternobjekt erforderlich	`enum: ["campaign","adset","ad"]`
`selection.start_date`	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`selection.end_date`	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`selection.action_attribution_windows`	`array`Im Elternobjekt erforderlich	`minItems: 1` `maxItems: 1`
`selection.action_attribution_windows[]`	`string`Optional / Element	`enum: ["1d_click","7d_click","1d_view"]`
`selection.action_report_time`	`string`Im Elternobjekt erforderlich	`enum: ["impression","conversion"]`
`selection.conversion_action_type`	`string`Im Elternobjekt erforderlich	`maxLength: 100`
`selection.revenue_action_type`	`string`Im Elternobjekt erforderlich	`maxLength: 100`
`complete`	`boolean`Im Elternobjekt erforderlich	—
`rows`	`array`Im Elternobjekt erforderlich	`maxItems: 500`
`rows[]`	`object`Optional / Element	—
`rows[].row_id`	`string`Im Elternobjekt erforderlich	`maxLength: 100`
`rows[].metrics`	`object`Im Elternobjekt erforderlich	—
`rows[].metrics.spend`	`object`Im Elternobjekt erforderlich	—
`rows[].metrics.spend.value`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.spend.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.spend.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.spend.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.spend.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.spend.reason`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.spend.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`rows[].metrics.spend.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.spend.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`rows[].metrics.spend.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`rows[].metrics.clicks`	`object`Im Elternobjekt erforderlich	—
`rows[].metrics.clicks.value`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.clicks.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.clicks.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.clicks.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.clicks.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.clicks.reason`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.clicks.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`rows[].metrics.clicks.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.clicks.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`rows[].metrics.clicks.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`rows[].metrics.conversions`	`object`Im Elternobjekt erforderlich	—
`rows[].metrics.conversions.value`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.conversions.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.conversions.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.conversions.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.conversions.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.conversions.reason`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.conversions.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`rows[].metrics.conversions.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.conversions.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`rows[].metrics.conversions.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`rows[].metrics.attributed_revenue`	`object`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_revenue.value`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_revenue.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.attributed_revenue.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_revenue.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.attributed_revenue.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.attributed_revenue.reason`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_revenue.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`rows[].metrics.attributed_revenue.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_revenue.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`rows[].metrics.attributed_revenue.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`rows[].metrics.cpc`	`object`Im Elternobjekt erforderlich	—
`rows[].metrics.cpc.value`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.cpc.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.cpc.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.cpc.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.cpc.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.cpc.reason`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.cpc.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`rows[].metrics.cpc.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.cpc.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`rows[].metrics.cpc.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`rows[].metrics.cpa`	`object`Im Elternobjekt erforderlich	—
`rows[].metrics.cpa.value`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.cpa.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.cpa.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.cpa.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.cpa.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.cpa.reason`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.cpa.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`rows[].metrics.cpa.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.cpa.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`rows[].metrics.cpa.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`rows[].metrics.attributed_roas`	`object`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_roas.value`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_roas.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.attributed_roas.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_roas.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.attributed_roas.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.attributed_roas.reason`	`string \| null`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_roas.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`rows[].metrics.attributed_roas.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`rows[].metrics.attributed_roas.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`rows[].metrics.attributed_roas.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`totals`	`object`Im Elternobjekt erforderlich	—
`totals.spend`	`object`Im Elternobjekt erforderlich	—
`totals.spend.value`	`string \| null`Im Elternobjekt erforderlich	—
`totals.spend.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.spend.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.spend.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.spend.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.spend.reason`	`string \| null`Im Elternobjekt erforderlich	—
`totals.spend.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`totals.spend.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.spend.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`totals.spend.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`totals.clicks`	`object`Im Elternobjekt erforderlich	—
`totals.clicks.value`	`string \| null`Im Elternobjekt erforderlich	—
`totals.clicks.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.clicks.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.clicks.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.clicks.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.clicks.reason`	`string \| null`Im Elternobjekt erforderlich	—
`totals.clicks.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`totals.clicks.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.clicks.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`totals.clicks.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`totals.conversions`	`object`Im Elternobjekt erforderlich	—
`totals.conversions.value`	`string \| null`Im Elternobjekt erforderlich	—
`totals.conversions.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.conversions.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.conversions.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.conversions.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.conversions.reason`	`string \| null`Im Elternobjekt erforderlich	—
`totals.conversions.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`totals.conversions.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.conversions.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`totals.conversions.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`totals.attributed_revenue`	`object`Im Elternobjekt erforderlich	—
`totals.attributed_revenue.value`	`string \| null`Im Elternobjekt erforderlich	—
`totals.attributed_revenue.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.attributed_revenue.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.attributed_revenue.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.attributed_revenue.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.attributed_revenue.reason`	`string \| null`Im Elternobjekt erforderlich	—
`totals.attributed_revenue.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`totals.attributed_revenue.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.attributed_revenue.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`totals.attributed_revenue.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`totals.cpc`	`object`Im Elternobjekt erforderlich	—
`totals.cpc.value`	`string \| null`Im Elternobjekt erforderlich	—
`totals.cpc.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.cpc.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.cpc.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.cpc.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.cpc.reason`	`string \| null`Im Elternobjekt erforderlich	—
`totals.cpc.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`totals.cpc.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.cpc.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`totals.cpc.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`totals.cpa`	`object`Im Elternobjekt erforderlich	—
`totals.cpa.value`	`string \| null`Im Elternobjekt erforderlich	—
`totals.cpa.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.cpa.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.cpa.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.cpa.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.cpa.reason`	`string \| null`Im Elternobjekt erforderlich	—
`totals.cpa.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`totals.cpa.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.cpa.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`totals.cpa.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`totals.attributed_roas`	`object`Im Elternobjekt erforderlich	—
`totals.attributed_roas.value`	`string \| null`Im Elternobjekt erforderlich	—
`totals.attributed_roas.value`anyOf 1	`string`Im Elternobjekt erforderlich	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.attributed_roas.value`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.attributed_roas.unit`	`string`Im Elternobjekt erforderlich	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.attributed_roas.availability`	`string`Im Elternobjekt erforderlich	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.attributed_roas.reason`	`string \| null`Im Elternobjekt erforderlich	—
`totals.attributed_roas.reason`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 300`
`totals.attributed_roas.reason`anyOf 2	`null`Im Elternobjekt erforderlich	—
`totals.attributed_roas.input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`totals.attributed_roas.input_refs[]`	`string`Optional / Element	`maxLength: 300`
`gaps`	`array`Im Elternobjekt erforderlich	`maxItems: 1000`
`gaps[]`	`string`Optional / Element	`maxLength: 300`
`suggestions`	`array`Im Elternobjekt erforderlich	`maxItems: 3`
`suggestions[]`	`object`Optional / Element	—
`suggestions[].rule_id`	`string`Im Elternobjekt erforderlich	`enum: ["supply_revenue","review_comparable_creative_test","complete_coverage"]`
`suggestions[].rule_version`	`number`Im Elternobjekt erforderlich	`const: 1`
`suggestions[].proposal`	`string`Im Elternobjekt erforderlich	`maxLength: 600`
`suggestions[].input_refs`	`array`Im Elternobjekt erforderlich	`maxItems: 2000`
`suggestions[].input_refs[]`	`string`Optional / Element	`maxLength: 300`
`suggestions[].limitations`	`string`Im Elternobjekt erforderlich	`const: "Observational comparison only; no causal uplift or profitability claim. Human review required."`
`advertising_account_id`	`string`Im Elternobjekt erforderlich	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`next_cursor`	`string \| null`Im Elternobjekt erforderlich	—
`next_cursor`anyOf 1	`string`Im Elternobjekt erforderlich	`maxLength: 2048`
`next_cursor`anyOf 2	`null`Im Elternobjekt erforderlich	—

Vollständiges JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "ad-performance/v1"
    },
    "source_id": {
      "type": "string",
      "maxLength": 100
    },
    "source_sha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "identity_verification": {
      "type": "string",
      "enum": [
        "customer_supplied",
        "accepted_provider_grant"
      ]
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "timezone": {
      "type": "string",
      "maxLength": 100
    },
    "selection": {
      "type": "object",
      "properties": {
        "provider_api_version": {
          "type": "string",
          "const": "v26.0"
        },
        "provider_account_id": {
          "type": "string",
          "pattern": "^[1-9]\\d{1,24}$"
        },
        "currency": {
          "type": "string",
          "pattern": "^[A-Z]{3}$"
        },
        "timezone": {
          "type": "string",
          "maxLength": 100
        },
        "level": {
          "type": "string",
          "enum": [
            "campaign",
            "adset",
            "ad"
          ]
        },
        "start_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "end_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "action_attribution_windows": {
          "minItems": 1,
          "maxItems": 1,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "1d_click",
              "7d_click",
              "1d_view"
            ]
          }
        },
        "action_report_time": {
          "type": "string",
          "enum": [
            "impression",
            "conversion"
          ]
        },
        "conversion_action_type": {
          "type": "string",
          "maxLength": 100
        },
        "revenue_action_type": {
          "type": "string",
          "maxLength": 100
        }
      },
      "required": [
        "provider_api_version",
        "provider_account_id",
        "currency",
        "timezone",
        "level",
        "start_date",
        "end_date",
        "action_attribution_windows",
        "action_report_time",
        "conversion_action_type",
        "revenue_action_type"
      ]
    },
    "complete": {
      "type": "boolean"
    },
    "rows": {
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "row_id": {
            "type": "string",
            "maxLength": 100
          },
          "metrics": {
            "type": "object",
            "properties": {
              "spend": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "clicks": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "conversions": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "attributed_revenue": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "cpc": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "cpa": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              },
              "attributed_roas": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ]
              }
            },
            "required": [
              "spend",
              "clicks",
              "conversions",
              "attributed_revenue",
              "cpc",
              "cpa",
              "attributed_roas"
            ]
          }
        },
        "required": [
          "row_id",
          "metrics"
        ]
      }
    },
    "totals": {
      "type": "object",
      "properties": {
        "spend": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "clicks": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "conversions": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "attributed_revenue": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "cpc": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "cpa": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        },
        "attributed_roas": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ]
        }
      },
      "required": [
        "spend",
        "clicks",
        "conversions",
        "attributed_revenue",
        "cpc",
        "cpa",
        "attributed_roas"
      ]
    },
    "gaps": {
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 300
      }
    },
    "suggestions": {
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rule_id": {
            "type": "string",
            "enum": [
              "supply_revenue",
              "review_comparable_creative_test",
              "complete_coverage"
            ]
          },
          "rule_version": {
            "type": "number",
            "const": 1
          },
          "proposal": {
            "type": "string",
            "maxLength": 600
          },
          "input_refs": {
            "maxItems": 2000,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 300
            }
          },
          "limitations": {
            "type": "string",
            "const": "Observational comparison only; no causal uplift or profitability claim. Human review required."
          }
        },
        "required": [
          "rule_id",
          "rule_version",
          "proposal",
          "input_refs",
          "limitations"
        ]
      }
    },
    "advertising_account_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2048
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "contract_version",
    "source_id",
    "source_sha256",
    "identity_verification",
    "currency",
    "timezone",
    "selection",
    "complete",
    "rows",
    "totals",
    "gaps",
    "suggestions",
    "advertising_account_id",
    "next_cursor"
  ]
}

Fehler und sichere Wiederholungen

Prüfe HTTP-Status und Antwortinhalt. Ein 400-Validierungsfehler kann einen ZodError enthalten; Handler-Fehler verwenden die Felder error, message und code. Bewahre request_id oder x-request-id zur Diagnose ohne Zugangsdaten auf. Behebe 401/403-Zugriffsfehler vor einem erneuten Versuch und beachte Retry-After bei 429. Ist ein Schreibvorgang ungewiss oder liefert 5xx, lies zuerst das bestehende Ergebnis. Verwende einen Idempotenzschlüssel nur wieder, wo dies unterstützt wird; Wiederholungen unterscheiden sich je nach Operation und garantieren keine genau einmalige Zustellung.

Anleitung zur Fehlerbehebung

Beispiele

Diese Beispiele nutzen anhand der Schemas geprüfte fiktive Werte. Ersetze IDs durch autorisierte IDs, Medien durch bereite Assets und Daten durch bestätigte Veröffentlichungszeiten. Prüfe Kontoeignung vor Schreibvorgängen. Diese Seite sendet keine API-Anfragen.

Setze SOSOAPI_ACCESS_TOKEN auf deinem Server auf akzeptierte Zugangsdaten dieser Operation und halte es aus Browsercode heraus. Für KI-Agenten nutze sosoapi auth login zur Browseranmeldung und lass die CLI Zugangsdaten erneuern.

request.json

{
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "advertising_account_id": "11111111-1111-4111-8111-111111111111",
  "level": "campaign",
  "start_date": "2099-01-15",
  "end_date": "2099-01-15",
  "action_attribution_windows": [
    "1d_click"
  ],
  "action_report_time": "impression",
  "conversion_action_type": "example",
  "revenue_action_type": "example"
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/advertising-api/insights/query" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/advertising-api/insights/query", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "advertising_account_id": "11111111-1111-4111-8111-111111111111",
  "level": "campaign",
  "start_date": "2099-01-15",
  "end_date": "2099-01-15",
  "action_attribution_windows": [
    "1d_click"
  ],
  "action_report_time": "impression",
  "conversion_action_type": "example",
  "revenue_action_type": "example"
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /advertising-api/insights/query < request.json

Synthetisches Antwortbeispiel

{
  "contract_version": "ad-performance/v1",
  "source_id": "example",
  "source_sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "identity_verification": "customer_supplied",
  "currency": "USD",
  "timezone": "UTC",
  "selection": {
    "provider_api_version": "v26.0",
    "provider_account_id": "12345",
    "currency": "USD",
    "timezone": "UTC",
    "level": "campaign",
    "start_date": "2099-01-15",
    "end_date": "2099-01-15",
    "action_attribution_windows": [
      "1d_click"
    ],
    "action_report_time": "impression",
    "conversion_action_type": "example",
    "revenue_action_type": "example"
  },
  "complete": false,
  "rows": [],
  "totals": {
    "spend": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "clicks": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "conversions": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "attributed_revenue": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "cpc": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "cpa": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    },
    "attributed_roas": {
      "value": null,
      "unit": "currency",
      "availability": "available",
      "reason": null,
      "input_refs": []
    }
  },
  "gaps": [],
  "suggestions": [],
  "advertising_account_id": "11111111-1111-4111-8111-111111111111",
  "next_cursor": null
}

MCP: sosoapi_ads_insights_query

Alle API-Operationen Authentifizierung und Berechtigungen

Datenschutzeinstellungen

Notwendige Funktionen

Landing-Diagnose und maskierte Aufzeichnungen

Optionale Nutzungsanalyse

Auch Sitzungsaufzeichnungen auf dieser öffentlichen Website erlauben

Werbe-Insights abfragen

Überblick

Authentifizierung und Berechtigungen

Anfragefelder

Antwort und Abschluss

Fehler und sichere Wiederholungen

Beispiele

request.json

cURL

JavaScript

CLI

Synthetisches Antwortbeispiel

Werbe-Insights abfragen

Überblick

Authentifizierung und Berechtigungen

Anfragefelder

Antwort und Abschluss

Fehler und sichere Wiederholungen

Beispiele

request.json

cURL

JavaScript

CLI

Synthetisches Antwortbeispiel

Verwandte Tools und Anleitungen