Hirdetések

Hirdetési statisztikák lekérdezése

Kifejezett dátumokkal, időzónával, pénznemmel, attribúciós időablakkal és konverziós művelettel kérj le korlátozott hivatalos fizetett hirdetési eredményeket. A hiányzó mérőszámok hiányzók maradnak.

POST /advertising-api/insights/query

Szerződés ellenőrizve: 2026-11-03 · sha256:9aedef8d43dd4514

Olvasás Markdown formátumban Nyilvános szerződés letöltése OpenAPI letöltése

Áttekintés

A sikeres HTTP-válasz jelentheti a kérés elfogadását, nem a befejezését. Háttérmunkánál mentsd a visszakapott azonosítót, és ugyanazt a műveletet ellenőrizd a befejezésig. Az időzített vagy elfogadott bejegyzés csak platformmegerősítés után közzétett; a kliens időtúllépése nem igazolja az eredményt.

Hitelesítés és engedélyek

Elfogadott hitelesítőadat-osztályok: user_session, delegated_oauth, personal_access_token
Delegált képesség: agent:advertising_read
Minimális munkaterületi szerepkör: viewer
Hozzáférési hatókör: A felhasználó számára engedélyezett erőforrások
Minden munkaterületre kiterjedő hozzájárulás szükséges: Nem
Állapotot módosít: Nem
A művelet befejezésekor: synchronous_http_response

A token csak a tulajdonosa jogait használhatja. Minden kérés ellenőrzi a munkaterületi tagságot, erőforrás-tulajdonjogot, kiválasztott munkaterületeket és megadott képességeket. A core és full profil a megjelenített eszközöket változtatja; hozzáférést nem ad.

Kérésmezők

A kötelező jelölés a szülőobjektumon és a kiválasztott ágon belül érvényes. A kötelező gyermek nem teszi kötelezővé az opcionális szülőt. Az alábbi szabályok és mezőnevek a szerződésből származnak.

Kérésmezők
Mező / ág	Típus / kötelező	Korlátok
`$`	`object`A szülőn belül kötelező	`additionalProperties: false`
`workspace_id`	`string`A szülőn belül kötelező	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`advertising_account_id`	`string`A szülőn belül kötelező	`format: "uuid"` `pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$"`
`level`	`string`A szülőn belül kötelező	`enum: ["campaign","adset","ad"]`
`start_date`	`string`A szülőn belül kötelező	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`end_date`	`string`A szülőn belül kötelező	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`action_attribution_windows`	`array`A szülőn belül kötelező	`minItems: 1` `maxItems: 1`
`action_attribution_windows[]`	`string`Opcionális / elem	`enum: ["1d_click","7d_click","1d_view"]`
`action_report_time`	`string`A szülőn belül kötelező	`enum: ["impression","conversion"]`
`conversion_action_type`	`string`A szülőn belül kötelező	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`revenue_action_type`	`string`A szülőn belül kötelező	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`after`	`string`Opcionális / elem	`maxLength: 2048`
`limit`	`integer`Opcionális / elem	`minimum: 1` `maximum: 50` `default: 25`

Teljes JSON Schema

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

Válasz és befejezés

Sikeres HTTP-állapotok: 200. A művelet befejezésekor: synchronous_http_response.

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

Teljes JSON Schema

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

Hibák és biztonságos újrapróbálás

Ellenőrizd a HTTP-állapotot és a válasz törzsét. A 400 ellenőrzési hiba ZodError értéket tartalmazhat; a kezelőhibák az error, message és code mezőket használják. Őrizd meg a request_id vagy x-request-id értéket a diagnózishoz, hitelesítő adatok nélkül. Újrapróbálás előtt javítsd a 401/403 hozzáférési hibákat; 429 esetén kövesd a Retry-After értékét. Bizonytalan írás vagy 5xx válasz esetén előbb olvasd el a meglévő eredményt. Csak támogatott műveletnél használj újra idempotenciakulcsot; az újrapróbálás műveletenként eltér, és nem garantál pontosan egyszeri kézbesítést.

Hibaelhárítási útmutató

Példák

A példák sémákkal ellenőrzött képzeletbeli értékeket használnak. Az azonosítókat engedélyezettekre, a médiát kész tartalomelemekre, a dátumokat megerősített közzétételi időpontra cseréld. Írás beküldése előtt ellenőrizd a fiók jogosultságát. Ez az oldal nem küld API-kérést.

A szervereden állítsd a SOSOAPI_ACCESS_TOKEN értékét a művelet által elfogadott hitelesítő adatra, és tartsd távol a böngészőkódtól. AI-ügynökhöz a sosoapi auth login paranccsal jelentkezz be böngészőben, és hagyd, hogy a CLI frissítse a hitelesítő adatokat.

request.json

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

cURL

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

JavaScript

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

CLI

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

Szintetikus válaszpélda

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

MCP: sosoapi_ads_insights_query

Minden API-művelet Hitelesítés és engedélyek

Adatvédelmi beállítások

Szükséges funkciók

Landing-diagnosztika és elfedett visszajátszás

Opcionális használati analitika

Munkamenet-visszajátszás engedélyezése ezen a nyilvános webhelyen is

Hirdetési statisztikák lekérdezése

Áttekintés

Hitelesítés és engedélyek

Kérésmezők

Válasz és befejezés

Hibák és biztonságos újrapróbálás

Példák

request.json

cURL

JavaScript

CLI

Szintetikus válaszpélda

Hirdetési statisztikák lekérdezése

Áttekintés

Hitelesítés és engedélyek

Kérésmezők

Válasz és befejezés

Hibák és biztonságos újrapróbálás

Példák

request.json

cURL

JavaScript

CLI

Szintetikus válaszpélda

Kapcsolódó eszközök és útmutatók