Outil MCP

Analyser les performances publicitaires

sosoapi_ads_performance_analyze

Analyser un rapport publicitaire payant limité fourni par le client, avec attribution explicite et empreinte exacte de la source. Aucun accès à la plateforme ni affirmation de rentabilité causale.

Lire en Markdown

Profils et transports

Profils : full · Transports : stdio, http

Choisissez core ou full pour définir les outils visibles du client ; cela ne change pas ses autorisations. Le téléversement local nécessite stdio et n’est pas disponible sur HTTP. Définissez SOSOAPI_OUTPUT_SCHEMAS=1 pour inclure les schémas de sortie à la découverte. Les outils renvoient des résultats structurés avec ou sans ce réglage.

Autorisations et effets de bord

Les annotations aident les clients à décrire un outil. Chaque appel vérifie toujours l’authentification, le rôle, l’accès aux ressources et les capacités accordées de l’utilisateur.

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

/advertising-api/performance/analyze: agent:advertising_read · synchronous_http_response

Champs d’entrée

Requis signifie requis dans l’objet parent et la branche sélectionnée. Un enfant requis ne rend pas obligatoire un parent facultatif. Les règles et noms de champs ci-dessous proviennent du contrat.

Champs d’entrée
Champ / branche	Type / requis	Contraintes
`$`	`object`Requis dans le parent	`additionalProperties: false`
`workspace_id`	`string`Requis dans le parent	`format: "uuid"`
`source_kind`	`string`Requis dans le parent	`enum: ["customer_import","official_meta_api"]`
`source_id`	`string`Requis dans le parent	`minLength: 1` `maxLength: 100`
`provider_api_version`	`string`Requis dans le parent	`enum: ["v26.0"]`
`provider_account_id`	`string`Requis dans le parent	`pattern: "^[1-9]\\d{1,24}$"`
`currency`	`string`Requis dans le parent	`pattern: "^[A-Z]{3}$"`
`timezone`	`string`Requis dans le parent	`minLength: 1` `maxLength: 100`
`level`	`string`Requis dans le parent	`enum: ["campaign","adset","ad"]`
`start_date`	`string`Requis dans le parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`end_date`	`string`Requis dans le parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`action_attribution_windows`	`array`Requis dans le parent	`minItems: 1` `maxItems: 1`
`action_attribution_windows[]`	`string`Facultatif / élément	`enum: ["1d_click","7d_click","1d_view"]`
`action_report_time`	`string`Requis dans le parent	`enum: ["impression","conversion"]`
`conversion_action_type`	`string`Requis dans le parent	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`revenue_action_type`	`string`Requis dans le parent	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`complete`	`boolean`Requis dans le parent	—
`rows`	`array`Requis dans le parent	`maxItems: 500`
`rows[]`	`object`Facultatif / élément	`additionalProperties: false`
`rows[].account_id`	`string`Requis dans le parent	`pattern: "^[1-9]\\d{1,24}$"`
`rows[].account_currency`	`string`Requis dans le parent	`pattern: "^[A-Z]{3}$"`
`rows[].campaign_id`	`string`Requis dans le parent	`pattern: "^[1-9]\\d{1,24}$"`
`rows[].campaign_name`	`string`Facultatif / élément	`maxLength: 200`
`rows[].adset_id`	`string`Facultatif / élément	`pattern: "^[1-9]\\d{1,24}$"`
`rows[].ad_id`	`string`Facultatif / élément	`pattern: "^[1-9]\\d{1,24}$"`
`rows[].date_start`	`string`Requis dans le parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`rows[].date_stop`	`string`Requis dans le parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`rows[].spend`	`string`Facultatif / élément	`pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"`
`rows[].clicks`	`string`Facultatif / élément	`pattern: "^\\d{1,15}$"`
`rows[].actions`	`array`Facultatif / élément	`maxItems: 100`
`rows[].actions[]`	`object`Facultatif / élément	`additionalProperties: false`
`rows[].actions[].action_type`	`string`Requis dans le parent	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`rows[].actions[].value`	`string`Facultatif / élément	`pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"`
`rows[].actions[].1d_click`	`string`Facultatif / élément	`pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"`
`rows[].actions[].7d_click`	`string`Facultatif / élément	`pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"`
`rows[].actions[].1d_view`	`string`Facultatif / élément	`pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"`
`rows[].action_values`	`array`Facultatif / élément	`maxItems: 100`
`rows[].action_values[]`	`object`Facultatif / élément	`additionalProperties: false`
`rows[].action_values[].action_type`	`string`Requis dans le parent	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`rows[].action_values[].value`	`string`Facultatif / élément	`pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"`
`rows[].action_values[].1d_click`	`string`Facultatif / élément	`pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"`
`rows[].action_values[].7d_click`	`string`Facultatif / élément	`pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"`
`rows[].action_values[].1d_view`	`string`Facultatif / élément	`pattern: "^\\d{1,12}(?:\\.\\d{1,6})?$"`

JSON Schema complet

{
  "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}$"
    }
  }
}

Sortie structurée

Ce schéma décrit structuredContent dans un résultat d’outil réussi. La réponse MCP contient aussi content et peut définir isError en cas d’échec. Pour publier, lisez le résultat final de la publication plutôt que de considérer une requête acceptée ou une réponse texte comme une confirmation. L’opération API liée explique les autorisations et règles de nouvelle tentative.

Sortie structurée
Champ / branche	Type / requis	Contraintes
`$`	`object`Requis dans le parent	`additionalProperties: false`
`contract_version`	`string`Requis dans le parent	`const: "ad-performance/v1"`
`source_id`	`string`Requis dans le parent	`maxLength: 100`
`source_sha256`	`string`Requis dans le parent	`pattern: "^[a-f0-9]{64}$"`
`identity_verification`	`string`Requis dans le parent	`enum: ["customer_supplied","accepted_provider_grant"]`
`currency`	`string`Requis dans le parent	`pattern: "^[A-Z]{3}$"`
`timezone`	`string`Requis dans le parent	`maxLength: 100`
`selection`	`object`Requis dans le parent	`additionalProperties: false`
`selection.provider_api_version`	`string`Requis dans le parent	`const: "v26.0"`
`selection.provider_account_id`	`string`Requis dans le parent	`pattern: "^[1-9]\\d{1,24}$"`
`selection.currency`	`string`Requis dans le parent	`pattern: "^[A-Z]{3}$"`
`selection.timezone`	`string`Requis dans le parent	`maxLength: 100`
`selection.level`	`string`Requis dans le parent	`enum: ["campaign","adset","ad"]`
`selection.start_date`	`string`Requis dans le parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`selection.end_date`	`string`Requis dans le parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`selection.action_attribution_windows`	`array`Requis dans le parent	`minItems: 1` `maxItems: 1`
`selection.action_attribution_windows[]`	`string`Facultatif / élément	`enum: ["1d_click","7d_click","1d_view"]`
`selection.action_report_time`	`string`Requis dans le parent	`enum: ["impression","conversion"]`
`selection.conversion_action_type`	`string`Requis dans le parent	`maxLength: 100`
`selection.revenue_action_type`	`string`Requis dans le parent	`maxLength: 100`
`complete`	`boolean`Requis dans le parent	—
`rows`	`array`Requis dans le parent	`maxItems: 500`
`rows[]`	`object`Facultatif / élément	`additionalProperties: false`
`rows[].row_id`	`string`Requis dans le parent	`maxLength: 100`
`rows[].metrics`	`object`Requis dans le parent	`additionalProperties: false`
`rows[].metrics.spend`	`object`Requis dans le parent	`additionalProperties: false`
`rows[].metrics.spend.value`	`string \| null`Requis dans le parent	—
`rows[].metrics.spend.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.spend.value`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.spend.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.spend.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.spend.reason`	`string \| null`Requis dans le parent	—
`rows[].metrics.spend.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`rows[].metrics.spend.reason`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.spend.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`rows[].metrics.spend.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`rows[].metrics.clicks`	`object`Requis dans le parent	`additionalProperties: false`
`rows[].metrics.clicks.value`	`string \| null`Requis dans le parent	—
`rows[].metrics.clicks.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.clicks.value`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.clicks.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.clicks.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.clicks.reason`	`string \| null`Requis dans le parent	—
`rows[].metrics.clicks.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`rows[].metrics.clicks.reason`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.clicks.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`rows[].metrics.clicks.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`rows[].metrics.conversions`	`object`Requis dans le parent	`additionalProperties: false`
`rows[].metrics.conversions.value`	`string \| null`Requis dans le parent	—
`rows[].metrics.conversions.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.conversions.value`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.conversions.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.conversions.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.conversions.reason`	`string \| null`Requis dans le parent	—
`rows[].metrics.conversions.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`rows[].metrics.conversions.reason`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.conversions.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`rows[].metrics.conversions.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`rows[].metrics.attributed_revenue`	`object`Requis dans le parent	`additionalProperties: false`
`rows[].metrics.attributed_revenue.value`	`string \| null`Requis dans le parent	—
`rows[].metrics.attributed_revenue.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.attributed_revenue.value`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.attributed_revenue.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.attributed_revenue.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.attributed_revenue.reason`	`string \| null`Requis dans le parent	—
`rows[].metrics.attributed_revenue.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`rows[].metrics.attributed_revenue.reason`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.attributed_revenue.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`rows[].metrics.attributed_revenue.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`rows[].metrics.cpc`	`object`Requis dans le parent	`additionalProperties: false`
`rows[].metrics.cpc.value`	`string \| null`Requis dans le parent	—
`rows[].metrics.cpc.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.cpc.value`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.cpc.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.cpc.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.cpc.reason`	`string \| null`Requis dans le parent	—
`rows[].metrics.cpc.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`rows[].metrics.cpc.reason`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.cpc.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`rows[].metrics.cpc.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`rows[].metrics.cpa`	`object`Requis dans le parent	`additionalProperties: false`
`rows[].metrics.cpa.value`	`string \| null`Requis dans le parent	—
`rows[].metrics.cpa.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.cpa.value`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.cpa.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.cpa.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.cpa.reason`	`string \| null`Requis dans le parent	—
`rows[].metrics.cpa.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`rows[].metrics.cpa.reason`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.cpa.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`rows[].metrics.cpa.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`rows[].metrics.attributed_roas`	`object`Requis dans le parent	`additionalProperties: false`
`rows[].metrics.attributed_roas.value`	`string \| null`Requis dans le parent	—
`rows[].metrics.attributed_roas.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.attributed_roas.value`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.attributed_roas.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.attributed_roas.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.attributed_roas.reason`	`string \| null`Requis dans le parent	—
`rows[].metrics.attributed_roas.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`rows[].metrics.attributed_roas.reason`anyOf 2	`null`Requis dans le parent	—
`rows[].metrics.attributed_roas.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`rows[].metrics.attributed_roas.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`totals`	`object`Requis dans le parent	`additionalProperties: false`
`totals.spend`	`object`Requis dans le parent	`additionalProperties: false`
`totals.spend.value`	`string \| null`Requis dans le parent	—
`totals.spend.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.spend.value`anyOf 2	`null`Requis dans le parent	—
`totals.spend.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.spend.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.spend.reason`	`string \| null`Requis dans le parent	—
`totals.spend.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`totals.spend.reason`anyOf 2	`null`Requis dans le parent	—
`totals.spend.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`totals.spend.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`totals.clicks`	`object`Requis dans le parent	`additionalProperties: false`
`totals.clicks.value`	`string \| null`Requis dans le parent	—
`totals.clicks.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.clicks.value`anyOf 2	`null`Requis dans le parent	—
`totals.clicks.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.clicks.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.clicks.reason`	`string \| null`Requis dans le parent	—
`totals.clicks.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`totals.clicks.reason`anyOf 2	`null`Requis dans le parent	—
`totals.clicks.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`totals.clicks.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`totals.conversions`	`object`Requis dans le parent	`additionalProperties: false`
`totals.conversions.value`	`string \| null`Requis dans le parent	—
`totals.conversions.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.conversions.value`anyOf 2	`null`Requis dans le parent	—
`totals.conversions.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.conversions.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.conversions.reason`	`string \| null`Requis dans le parent	—
`totals.conversions.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`totals.conversions.reason`anyOf 2	`null`Requis dans le parent	—
`totals.conversions.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`totals.conversions.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`totals.attributed_revenue`	`object`Requis dans le parent	`additionalProperties: false`
`totals.attributed_revenue.value`	`string \| null`Requis dans le parent	—
`totals.attributed_revenue.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.attributed_revenue.value`anyOf 2	`null`Requis dans le parent	—
`totals.attributed_revenue.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.attributed_revenue.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.attributed_revenue.reason`	`string \| null`Requis dans le parent	—
`totals.attributed_revenue.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`totals.attributed_revenue.reason`anyOf 2	`null`Requis dans le parent	—
`totals.attributed_revenue.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`totals.attributed_revenue.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`totals.cpc`	`object`Requis dans le parent	`additionalProperties: false`
`totals.cpc.value`	`string \| null`Requis dans le parent	—
`totals.cpc.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.cpc.value`anyOf 2	`null`Requis dans le parent	—
`totals.cpc.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.cpc.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.cpc.reason`	`string \| null`Requis dans le parent	—
`totals.cpc.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`totals.cpc.reason`anyOf 2	`null`Requis dans le parent	—
`totals.cpc.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`totals.cpc.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`totals.cpa`	`object`Requis dans le parent	`additionalProperties: false`
`totals.cpa.value`	`string \| null`Requis dans le parent	—
`totals.cpa.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.cpa.value`anyOf 2	`null`Requis dans le parent	—
`totals.cpa.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.cpa.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.cpa.reason`	`string \| null`Requis dans le parent	—
`totals.cpa.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`totals.cpa.reason`anyOf 2	`null`Requis dans le parent	—
`totals.cpa.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`totals.cpa.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`totals.attributed_roas`	`object`Requis dans le parent	`additionalProperties: false`
`totals.attributed_roas.value`	`string \| null`Requis dans le parent	—
`totals.attributed_roas.value`anyOf 1	`string`Requis dans le parent	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.attributed_roas.value`anyOf 2	`null`Requis dans le parent	—
`totals.attributed_roas.unit`	`string`Requis dans le parent	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.attributed_roas.availability`	`string`Requis dans le parent	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.attributed_roas.reason`	`string \| null`Requis dans le parent	—
`totals.attributed_roas.reason`anyOf 1	`string`Requis dans le parent	`maxLength: 300`
`totals.attributed_roas.reason`anyOf 2	`null`Requis dans le parent	—
`totals.attributed_roas.input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`totals.attributed_roas.input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`gaps`	`array`Requis dans le parent	`maxItems: 1000`
`gaps[]`	`string`Facultatif / élément	`maxLength: 300`
`suggestions`	`array`Requis dans le parent	`maxItems: 3`
`suggestions[]`	`object`Facultatif / élément	`additionalProperties: false`
`suggestions[].rule_id`	`string`Requis dans le parent	`enum: ["supply_revenue","review_comparable_creative_test","complete_coverage"]`
`suggestions[].rule_version`	`number`Requis dans le parent	`const: 1`
`suggestions[].proposal`	`string`Requis dans le parent	`maxLength: 600`
`suggestions[].input_refs`	`array`Requis dans le parent	`maxItems: 2000`
`suggestions[].input_refs[]`	`string`Facultatif / élément	`maxLength: 300`
`suggestions[].limitations`	`string`Requis dans le parent	`const: "Observational comparison only; no causal uplift or profitability claim. Human review required."`

JSON Schema complet

{
  "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
}

Exemple d’appel d’outil

Ces exemples utilisent des valeurs fictives vérifiées contre les schémas. Remplacez les identifiants par ceux que vous êtes autorisé à utiliser, les médias par des ressources prêtes et les dates par l’heure confirmée. Vérifiez l’éligibilité du compte avant toute écriture. Cette page n’envoie aucune requête API.

{
  "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": []
}

/advertising-api/performance/analyze

Installer ou connecter MCP

Préférences de confidentialité

Fonctions nécessaires

Diagnostics Landing et enregistrement avec masquage

Statistiques d’utilisation facultatives

Autoriser aussi l’enregistrement des sessions sur ce site public

Analyser les performances publicitaires

Profils et transports

Autorisations et effets de bord

Champs d’entrée

Sortie structurée

Exemple d’appel d’outil

structuredContent

Analyser les performances publicitaires

Profils et transports

Autorisations et effets de bord

Champs d’entrée

Sortie structurée

Exemple d’appel d’outil

structuredContent

Opérations API sous-jacentes