Datenschutzeinstellungen

Notwendige Funktionen

Für Sicherheit und grundlegende Website-Funktionen erforderlich.

Immer aktiv

Landing-Diagnose und maskierte Aufzeichnungen

Misst öffentliche Besuche, Absprünge und Interaktionen mit Registrierungslinks mit einer anonymen ID nur für diesen Tab, ohne Kontoverknüpfung. Alle Texte werden maskiert und Formulare ausgeschlossen.

Optionale Nutzungsanalyse

PostHog-Nutzungsanalyse erlauben? Du kannst deine Wahl jederzeit in der Fußzeile ändern.

Auch Sitzungsaufzeichnungen auf dieser öffentlichen Website erlauben

Aufzeichnungen im optionalen websiteübergreifenden Modus zeigen öffentliche Seiten und Interaktionen; Eingaben und private Inhalte werden maskiert. App-Aufzeichnungen sind eine separate Auswahl.

Erfordert optionale Analysen; Aufzeichnungen in diesem websiteübergreifenden Modus sind standardmäßig deaktiviert. Der Landing-Modus oben läuft separat.

Wie wir Daten verwenden

Der standardmäßige Landing-Modus speichert eine anonyme ID nur im sessionStorage dieses Tabs, ohne Verknüpfung mit der App, Konten oder der optionalen websiteübergreifenden ID. Wenn du optionale Analysen erlaubst, wird auf eine separate ID gewechselt, ohne frühere Landing-Aufzeichnungen zu verknüpfen.

Wenn du optionale Analysen erlaubst, kann PostHog ein anonymes Cookie auf dieser Website und in unserer App gemeinsam verwenden, mit lokalem Browserspeicher auf jeder Website. Mit deiner Einwilligung kann ein verifizierter Besuch im selben Tab nach bestätigter Registrierung mit deinem neuen Konto verknüpft werden.

Aufzeichnungen im optionalen websiteübergreifenden Modus sind standardmäßig deaktiviert. Entferne das Häkchen bei dessen Aufzeichnungsoption und speichere, um neue Aufzeichnungen in diesem Modus zu stoppen; Landing-Diagnose und maskierte Aufzeichnungen kannst du oben separat deaktivieren. Diese Auswahl ändert keine Kontoeinstellungen.

Datenschutzhinweis und separate aggregierte Cloudflare-Messung.

Browser-Analysen aktivieren keine Kontoanalysen.

SosoAPI
Kostenlos starten
DE
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
Kostenlos starten

Die Suche lädt erst bei Nutzung. Durchsuche unten alle Kategorien.

MCP-Tool

Werbeleistung analysieren

sosoapi_ads_performance_analyze

Analysiere einen begrenzten, vom Kunden bereitgestellten Werbebericht mit ausdrücklicher Attribution und genauem Quellhash. Kein Plattformzugriff und keine Behauptung kausal nachgewiesener Rentabilität.

Als Markdown lesen

Profile und Transporte

Profile: full · Transporte: stdio, http

Wähle core oder full für die sichtbaren Tools deines Clients; dies ändert keine Berechtigungen. Lokaler Dateiupload benötigt stdio und ist über HTTP nicht verfügbar. Setze SOSOAPI_OUTPUT_SCHEMAS=1 für Ausgabeschemas in der Erkennung. Tools liefern unabhängig davon strukturierte Ergebnisse.

Berechtigungen und Nebeneffekte

Annotationen helfen Clients, Tools zu beschreiben. Jeder Aufruf prüft weiterhin Authentifizierung, Rolle, Ressourcenzugriff und erteilte Funktionen des Nutzers.

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

Eingabefelder

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.

Eingabefelder
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich
  • additionalProperties: false
workspace_idstringIm Elternobjekt erforderlich
  • format: "uuid"
source_kindstringIm Elternobjekt erforderlich
  • enum: ["customer_import","official_meta_api"]
source_idstringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 100
provider_api_versionstringIm Elternobjekt erforderlich
  • enum: ["v26.0"]
provider_account_idstringIm Elternobjekt erforderlich
  • pattern: "^[1-9]\\d{1,24}$"
currencystringIm Elternobjekt erforderlich
  • pattern: "^[A-Z]{3}$"
timezonestringIm Elternobjekt erforderlich
  • minLength: 1
  • maxLength: 100
levelstringIm Elternobjekt erforderlich
  • enum: ["campaign","adset","ad"]
start_datestringIm Elternobjekt erforderlich
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
end_datestringIm Elternobjekt erforderlich
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
action_attribution_windowsarrayIm Elternobjekt erforderlich
  • minItems: 1
  • maxItems: 1
action_attribution_windows[]stringOptional / Element
  • enum: ["1d_click","7d_click","1d_view"]
action_report_timestringIm Elternobjekt erforderlich
  • enum: ["impression","conversion"]
conversion_action_typestringIm Elternobjekt erforderlich
  • pattern: "^[a-z][a-z0-9_.]{0,99}$"
revenue_action_typestringIm Elternobjekt erforderlich
  • pattern: "^[a-z][a-z0-9_.]{0,99}$"
completebooleanIm Elternobjekt erforderlich—
rowsarrayIm Elternobjekt erforderlich
  • maxItems: 500
rows[]objectOptional / Element
  • additionalProperties: false
rows[].account_idstringIm Elternobjekt erforderlich
  • pattern: "^[1-9]\\d{1,24}$"
rows[].account_currencystringIm Elternobjekt erforderlich
  • pattern: "^[A-Z]{3}$"
rows[].campaign_idstringIm Elternobjekt erforderlich
  • pattern: "^[1-9]\\d{1,24}$"
rows[].campaign_namestringOptional / Element
  • maxLength: 200
rows[].adset_idstringOptional / Element
  • pattern: "^[1-9]\\d{1,24}$"
rows[].ad_idstringOptional / Element
  • pattern: "^[1-9]\\d{1,24}$"
rows[].date_startstringIm Elternobjekt erforderlich
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
rows[].date_stopstringIm Elternobjekt erforderlich
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
rows[].spendstringOptional / Element
  • pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"
rows[].clicksstringOptional / Element
  • pattern: "^\\d{1,15}$"
rows[].actionsarrayOptional / Element
  • maxItems: 100
rows[].actions[]objectOptional / Element
  • additionalProperties: false
rows[].actions[].action_typestringIm Elternobjekt erforderlich
  • pattern: "^[a-z][a-z0-9_.]{0,99}$"
rows[].actions[].valuestringOptional / Element
  • pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"
rows[].actions[].1d_clickstringOptional / Element
  • pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"
rows[].actions[].7d_clickstringOptional / Element
  • pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"
rows[].actions[].1d_viewstringOptional / Element
  • pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"
rows[].action_valuesarrayOptional / Element
  • maxItems: 100
rows[].action_values[]objectOptional / Element
  • additionalProperties: false
rows[].action_values[].action_typestringIm Elternobjekt erforderlich
  • pattern: "^[a-z][a-z0-9_.]{0,99}$"
rows[].action_values[].valuestringOptional / Element
  • pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"
rows[].action_values[].1d_clickstringOptional / Element
  • pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"
rows[].action_values[].7d_clickstringOptional / Element
  • pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"
rows[].action_values[].1d_viewstringOptional / Element
  • pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"
Vollständiges JSON Schema
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "source_kind": {
      "type": "string",
      "enum": [
        "customer_import",
        "official_meta_api"
      ]
    },
    "source_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "provider_api_version": {
      "type": "string",
      "enum": [
        "v26.0"
      ]
    },
    "provider_account_id": {
      "$ref": "#/$defs/s1"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "timezone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "level": {
      "type": "string",
      "enum": [
        "campaign",
        "adset",
        "ad"
      ]
    },
    "start_date": {
      "$ref": "#/$defs/s2"
    },
    "end_date": {
      "$ref": "#/$defs/s2"
    },
    "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": {
      "$ref": "#/$defs/s3"
    },
    "revenue_action_type": {
      "$ref": "#/$defs/s3"
    },
    "complete": {
      "type": "boolean"
    },
    "rows": {
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "account_id": {
            "$ref": "#/$defs/s1"
          },
          "account_currency": {
            "type": "string",
            "pattern": "^[A-Z]{3}$"
          },
          "campaign_id": {
            "$ref": "#/$defs/s1"
          },
          "campaign_name": {
            "type": "string",
            "maxLength": 200
          },
          "adset_id": {
            "$ref": "#/$defs/s1"
          },
          "ad_id": {
            "$ref": "#/$defs/s1"
          },
          "date_start": {
            "$ref": "#/$defs/s2"
          },
          "date_stop": {
            "$ref": "#/$defs/s2"
          },
          "spend": {
            "type": "string",
            "pattern": "^\\d{1,12}(?:\\.\\d{1,6})?$"
          },
          "clicks": {
            "type": "string",
            "pattern": "^\\d{1,15}$"
          },
          "actions": {
            "$ref": "#/$defs/s0"
          },
          "action_values": {
            "$ref": "#/$defs/s0"
          }
        },
        "required": [
          "account_id",
          "account_currency",
          "campaign_id",
          "date_start",
          "date_stop"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "workspace_id",
    "source_kind",
    "source_id",
    "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",
    "rows"
  ],
  "additionalProperties": false,
  "$defs": {
    "s0": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "action_type": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_.]{0,99}$"
          },
          "value": {
            "type": "string",
            "pattern": "^\\d{1,12}(?:\\.\\d{1,6})?$"
          },
          "1d_click": {
            "type": "string",
            "pattern": "^\\d{1,12}(?:\\.\\d{1,6})?$"
          },
          "7d_click": {
            "type": "string",
            "pattern": "^\\d{1,12}(?:\\.\\d{1,6})?$"
          },
          "1d_view": {
            "type": "string",
            "pattern": "^\\d{1,12}(?:\\.\\d{1,6})?$"
          }
        },
        "required": [
          "action_type"
        ],
        "additionalProperties": false
      }
    },
    "s1": {
      "type": "string",
      "pattern": "^[1-9]\\d{1,24}$"
    },
    "s2": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "s3": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_.]{0,99}$"
    }
  }
}

Strukturierte Ausgabe

Dieses Schema beschreibt structuredContent in einem erfolgreichen Tool-Ergebnis. Die MCP-Antwort enthält auch content und kann bei fehlgeschlagenem Aufruf isError setzen. Lies bei Veröffentlichungen das endgültige Beitragsergebnis, statt eine angenommene Anfrage oder Textantwort als Bestätigung zu werten. Die verknüpfte API-Operation erklärt Berechtigungen und Wiederholungsregeln.

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.

Strukturierte Ausgabe
Feld / VarianteTyp / erforderlichEinschränkungen
$objectIm Elternobjekt erforderlich
  • additionalProperties: false
contract_versionstringIm Elternobjekt erforderlich
  • const: "ad-performance/v1"
source_idstringIm Elternobjekt erforderlich
  • maxLength: 100
source_sha256stringIm Elternobjekt erforderlich
  • pattern: "^[a-f0-9]{64}$"
identity_verificationstringIm Elternobjekt erforderlich
  • enum: ["customer_supplied","accepted_provider_grant"]
currencystringIm Elternobjekt erforderlich
  • pattern: "^[A-Z]{3}$"
timezonestringIm Elternobjekt erforderlich
  • maxLength: 100
selectionobjectIm Elternobjekt erforderlich
  • additionalProperties: false
selection.provider_api_versionstringIm Elternobjekt erforderlich
  • const: "v26.0"
selection.provider_account_idstringIm Elternobjekt erforderlich
  • pattern: "^[1-9]\\d{1,24}$"
selection.currencystringIm Elternobjekt erforderlich
  • pattern: "^[A-Z]{3}$"
selection.timezonestringIm Elternobjekt erforderlich
  • maxLength: 100
selection.levelstringIm Elternobjekt erforderlich
  • enum: ["campaign","adset","ad"]
selection.start_datestringIm Elternobjekt erforderlich
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
selection.end_datestringIm Elternobjekt erforderlich
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
selection.action_attribution_windowsarrayIm Elternobjekt erforderlich
  • minItems: 1
  • maxItems: 1
selection.action_attribution_windows[]stringOptional / Element
  • enum: ["1d_click","7d_click","1d_view"]
selection.action_report_timestringIm Elternobjekt erforderlich
  • enum: ["impression","conversion"]
selection.conversion_action_typestringIm Elternobjekt erforderlich
  • maxLength: 100
selection.revenue_action_typestringIm Elternobjekt erforderlich
  • maxLength: 100
completebooleanIm Elternobjekt erforderlich—
rowsarrayIm Elternobjekt erforderlich
  • maxItems: 500
rows[]objectOptional / Element
  • additionalProperties: false
rows[].row_idstringIm Elternobjekt erforderlich
  • maxLength: 100
rows[].metricsobjectIm Elternobjekt erforderlich
  • additionalProperties: false
rows[].metrics.spendobjectIm Elternobjekt erforderlich
  • additionalProperties: false
rows[].metrics.spend.valuestring | nullIm Elternobjekt erforderlich—
rows[].metrics.spend.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.spend.valueanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.spend.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.spend.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.spend.reasonstring | nullIm Elternobjekt erforderlich—
rows[].metrics.spend.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
rows[].metrics.spend.reasonanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.spend.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
rows[].metrics.spend.input_refs[]stringOptional / Element
  • maxLength: 300
rows[].metrics.clicksobjectIm Elternobjekt erforderlich
  • additionalProperties: false
rows[].metrics.clicks.valuestring | nullIm Elternobjekt erforderlich—
rows[].metrics.clicks.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.clicks.valueanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.clicks.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.clicks.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.clicks.reasonstring | nullIm Elternobjekt erforderlich—
rows[].metrics.clicks.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
rows[].metrics.clicks.reasonanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.clicks.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
rows[].metrics.clicks.input_refs[]stringOptional / Element
  • maxLength: 300
rows[].metrics.conversionsobjectIm Elternobjekt erforderlich
  • additionalProperties: false
rows[].metrics.conversions.valuestring | nullIm Elternobjekt erforderlich—
rows[].metrics.conversions.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.conversions.valueanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.conversions.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.conversions.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.conversions.reasonstring | nullIm Elternobjekt erforderlich—
rows[].metrics.conversions.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
rows[].metrics.conversions.reasonanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.conversions.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
rows[].metrics.conversions.input_refs[]stringOptional / Element
  • maxLength: 300
rows[].metrics.attributed_revenueobjectIm Elternobjekt erforderlich
  • additionalProperties: false
rows[].metrics.attributed_revenue.valuestring | nullIm Elternobjekt erforderlich—
rows[].metrics.attributed_revenue.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.attributed_revenue.valueanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.attributed_revenue.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.attributed_revenue.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.attributed_revenue.reasonstring | nullIm Elternobjekt erforderlich—
rows[].metrics.attributed_revenue.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
rows[].metrics.attributed_revenue.reasonanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.attributed_revenue.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
rows[].metrics.attributed_revenue.input_refs[]stringOptional / Element
  • maxLength: 300
rows[].metrics.cpcobjectIm Elternobjekt erforderlich
  • additionalProperties: false
rows[].metrics.cpc.valuestring | nullIm Elternobjekt erforderlich—
rows[].metrics.cpc.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.cpc.valueanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.cpc.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.cpc.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.cpc.reasonstring | nullIm Elternobjekt erforderlich—
rows[].metrics.cpc.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
rows[].metrics.cpc.reasonanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.cpc.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
rows[].metrics.cpc.input_refs[]stringOptional / Element
  • maxLength: 300
rows[].metrics.cpaobjectIm Elternobjekt erforderlich
  • additionalProperties: false
rows[].metrics.cpa.valuestring | nullIm Elternobjekt erforderlich—
rows[].metrics.cpa.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.cpa.valueanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.cpa.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.cpa.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.cpa.reasonstring | nullIm Elternobjekt erforderlich—
rows[].metrics.cpa.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
rows[].metrics.cpa.reasonanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.cpa.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
rows[].metrics.cpa.input_refs[]stringOptional / Element
  • maxLength: 300
rows[].metrics.attributed_roasobjectIm Elternobjekt erforderlich
  • additionalProperties: false
rows[].metrics.attributed_roas.valuestring | nullIm Elternobjekt erforderlich—
rows[].metrics.attributed_roas.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.attributed_roas.valueanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.attributed_roas.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.attributed_roas.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.attributed_roas.reasonstring | nullIm Elternobjekt erforderlich—
rows[].metrics.attributed_roas.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
rows[].metrics.attributed_roas.reasonanyOf 2nullIm Elternobjekt erforderlich—
rows[].metrics.attributed_roas.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
rows[].metrics.attributed_roas.input_refs[]stringOptional / Element
  • maxLength: 300
totalsobjectIm Elternobjekt erforderlich
  • additionalProperties: false
totals.spendobjectIm Elternobjekt erforderlich
  • additionalProperties: false
totals.spend.valuestring | nullIm Elternobjekt erforderlich—
totals.spend.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.spend.valueanyOf 2nullIm Elternobjekt erforderlich—
totals.spend.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.spend.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.spend.reasonstring | nullIm Elternobjekt erforderlich—
totals.spend.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
totals.spend.reasonanyOf 2nullIm Elternobjekt erforderlich—
totals.spend.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
totals.spend.input_refs[]stringOptional / Element
  • maxLength: 300
totals.clicksobjectIm Elternobjekt erforderlich
  • additionalProperties: false
totals.clicks.valuestring | nullIm Elternobjekt erforderlich—
totals.clicks.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.clicks.valueanyOf 2nullIm Elternobjekt erforderlich—
totals.clicks.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.clicks.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.clicks.reasonstring | nullIm Elternobjekt erforderlich—
totals.clicks.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
totals.clicks.reasonanyOf 2nullIm Elternobjekt erforderlich—
totals.clicks.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
totals.clicks.input_refs[]stringOptional / Element
  • maxLength: 300
totals.conversionsobjectIm Elternobjekt erforderlich
  • additionalProperties: false
totals.conversions.valuestring | nullIm Elternobjekt erforderlich—
totals.conversions.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.conversions.valueanyOf 2nullIm Elternobjekt erforderlich—
totals.conversions.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.conversions.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.conversions.reasonstring | nullIm Elternobjekt erforderlich—
totals.conversions.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
totals.conversions.reasonanyOf 2nullIm Elternobjekt erforderlich—
totals.conversions.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
totals.conversions.input_refs[]stringOptional / Element
  • maxLength: 300
totals.attributed_revenueobjectIm Elternobjekt erforderlich
  • additionalProperties: false
totals.attributed_revenue.valuestring | nullIm Elternobjekt erforderlich—
totals.attributed_revenue.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.attributed_revenue.valueanyOf 2nullIm Elternobjekt erforderlich—
totals.attributed_revenue.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.attributed_revenue.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.attributed_revenue.reasonstring | nullIm Elternobjekt erforderlich—
totals.attributed_revenue.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
totals.attributed_revenue.reasonanyOf 2nullIm Elternobjekt erforderlich—
totals.attributed_revenue.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
totals.attributed_revenue.input_refs[]stringOptional / Element
  • maxLength: 300
totals.cpcobjectIm Elternobjekt erforderlich
  • additionalProperties: false
totals.cpc.valuestring | nullIm Elternobjekt erforderlich—
totals.cpc.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.cpc.valueanyOf 2nullIm Elternobjekt erforderlich—
totals.cpc.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.cpc.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.cpc.reasonstring | nullIm Elternobjekt erforderlich—
totals.cpc.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
totals.cpc.reasonanyOf 2nullIm Elternobjekt erforderlich—
totals.cpc.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
totals.cpc.input_refs[]stringOptional / Element
  • maxLength: 300
totals.cpaobjectIm Elternobjekt erforderlich
  • additionalProperties: false
totals.cpa.valuestring | nullIm Elternobjekt erforderlich—
totals.cpa.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.cpa.valueanyOf 2nullIm Elternobjekt erforderlich—
totals.cpa.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.cpa.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.cpa.reasonstring | nullIm Elternobjekt erforderlich—
totals.cpa.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
totals.cpa.reasonanyOf 2nullIm Elternobjekt erforderlich—
totals.cpa.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
totals.cpa.input_refs[]stringOptional / Element
  • maxLength: 300
totals.attributed_roasobjectIm Elternobjekt erforderlich
  • additionalProperties: false
totals.attributed_roas.valuestring | nullIm Elternobjekt erforderlich—
totals.attributed_roas.valueanyOf 1stringIm Elternobjekt erforderlich
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.attributed_roas.valueanyOf 2nullIm Elternobjekt erforderlich—
totals.attributed_roas.unitstringIm Elternobjekt erforderlich
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.attributed_roas.availabilitystringIm Elternobjekt erforderlich
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.attributed_roas.reasonstring | nullIm Elternobjekt erforderlich—
totals.attributed_roas.reasonanyOf 1stringIm Elternobjekt erforderlich
  • maxLength: 300
totals.attributed_roas.reasonanyOf 2nullIm Elternobjekt erforderlich—
totals.attributed_roas.input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
totals.attributed_roas.input_refs[]stringOptional / Element
  • maxLength: 300
gapsarrayIm Elternobjekt erforderlich
  • maxItems: 1000
gaps[]stringOptional / Element
  • maxLength: 300
suggestionsarrayIm Elternobjekt erforderlich
  • maxItems: 3
suggestions[]objectOptional / Element
  • additionalProperties: false
suggestions[].rule_idstringIm Elternobjekt erforderlich
  • enum: ["supply_revenue","review_comparable_creative_test","complete_coverage"]
suggestions[].rule_versionnumberIm Elternobjekt erforderlich
  • const: 1
suggestions[].proposalstringIm Elternobjekt erforderlich
  • maxLength: 600
suggestions[].input_refsarrayIm Elternobjekt erforderlich
  • maxItems: 2000
suggestions[].input_refs[]stringOptional / Element
  • maxLength: 300
suggestions[].limitationsstringIm Elternobjekt erforderlich
  • const: "Observational comparison only; no causal uplift or profitability claim. Human review required."
Vollständiges JSON 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"
      ],
      "additionalProperties": false
    },
    "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"
                ],
                "additionalProperties": false
              },
              "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"
                ],
                "additionalProperties": false
              },
              "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"
                ],
                "additionalProperties": false
              },
              "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"
                ],
                "additionalProperties": false
              },
              "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"
                ],
                "additionalProperties": false
              },
              "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"
                ],
                "additionalProperties": false
              },
              "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"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "spend",
              "clicks",
              "conversions",
              "attributed_revenue",
              "cpc",
              "cpa",
              "attributed_roas"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "row_id",
          "metrics"
        ],
        "additionalProperties": false
      }
    },
    "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"
          ],
          "additionalProperties": false
        },
        "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"
          ],
          "additionalProperties": false
        },
        "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"
          ],
          "additionalProperties": false
        },
        "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"
          ],
          "additionalProperties": false
        },
        "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"
          ],
          "additionalProperties": false
        },
        "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"
          ],
          "additionalProperties": false
        },
        "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"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "spend",
        "clicks",
        "conversions",
        "attributed_revenue",
        "cpc",
        "cpa",
        "attributed_roas"
      ],
      "additionalProperties": false
    },
    "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"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "contract_version",
    "source_id",
    "source_sha256",
    "identity_verification",
    "currency",
    "timezone",
    "selection",
    "complete",
    "rows",
    "totals",
    "gaps",
    "suggestions"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Beispiel eines Tool-Aufrufs

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.

{
  "name": "sosoapi_ads_performance_analyze",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "source_kind": "customer_import",
    "source_id": "example",
    "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": []
  }
}

structuredContent

{
  "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": []
}
MCP installieren oder verbinden