פרסום

שאילתת נתוני פרסום

אחזור מוגבל של ביצועי פרסום ממומן ממקור רשמי, עם תאריכים, אזור זמן, מטבע, חלון ייחוס ופעולת המרה מפורשים. מדדים חסרים נשארים חסרים.

POST /advertising-api/insights/query

החוזה נבדק: 2026-11-03 · sha256:9aedef8d43dd4514

קריאה בפורמט Markdown הורדת החוזה הציבורי הורדת OpenAPI

סקירה

תגובת HTTP מוצלחת עשויה לציין שבקשה התקבלה, ולא שהושלמה. בעבודת רקע, שמרו את המזהה שהוחזר ובדקו את אותה פעולה עד שתסתיים. פוסט שתוזמן או התקבל נחשב שפורסם רק כשהפלטפורמה מאשרת זאת; חריגה מזמן ההמתנה אצל הלקוח אינה קובעת מה התוצאה.

אימות והרשאות

סוגי אמצעי גישה מתקבלים: user_session, delegated_oauth, personal_access_token
יכולת מואצלת: agent:advertising_read
תפקיד מינימלי בסביבת העבודה: viewer
היקף הגישה: משאבים שהמשתמש הזה מורשה לגשת אליהם
נדרשת הסכמה לכל סביבות העבודה: לא
משנה מצב: לא
מתי הפעולה הושלמה: synchronous_http_response

אסימון יכול להשתמש רק בזכויות שיש לבעליו. כל בקשה בודקת חברות בסביבת העבודה, בעלות על משאבים, סביבות עבודה נבחרות ויכולות שהוענקו. הפרופילים core ו-full משנים אילו כלים מוצגים; הם אינם מעניקים גישה.

שדות הבקשה

שדה חובה נדרש בתוך אובייקט האב והענף הנבחר שלו. צאצא נדרש אינו הופך אב אופציונלי לנדרש. הכללים ושמות השדות שלהלן מועתקים מהחוזה.

שדות הבקשה
שדה / ענף	סוג / חובה	אילוצים
`$`	`object`חובה באובייקט האב	`additionalProperties: false`
`workspace_id`	`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`	`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`	`string`חובה באובייקט האב	`enum: ["campaign","adset","ad"]`
`start_date`	`string`חובה באובייקט האב	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`end_date`	`string`חובה באובייקט האב	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`action_attribution_windows`	`array`חובה באובייקט האב	`minItems: 1` `maxItems: 1`
`action_attribution_windows[]`	`string`רשות / פריט	`enum: ["1d_click","7d_click","1d_view"]`
`action_report_time`	`string`חובה באובייקט האב	`enum: ["impression","conversion"]`
`conversion_action_type`	`string`חובה באובייקט האב	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`revenue_action_type`	`string`חובה באובייקט האב	`pattern: "^[a-z][a-z0-9_.]{0,99}$"`
`after`	`string`רשות / פריט	`maxLength: 2048`
`limit`	`integer`רשות / פריט	`minimum: 1` `maximum: 50` `default: 25`

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
}

תגובה והשלמה

סטטוסי HTTP להצלחה: 200. מתי הפעולה הושלמה: synchronous_http_response.

תגובה והשלמה
שדה / ענף	סוג / חובה	אילוצים
`$`	`object`חובה באובייקט האב	—
`contract_version`	`string`חובה באובייקט האב	`const: "ad-performance/v1"`
`source_id`	`string`חובה באובייקט האב	`maxLength: 100`
`source_sha256`	`string`חובה באובייקט האב	`pattern: "^[a-f0-9]{64}$"`
`identity_verification`	`string`חובה באובייקט האב	`enum: ["customer_supplied","accepted_provider_grant"]`
`currency`	`string`חובה באובייקט האב	`pattern: "^[A-Z]{3}$"`
`timezone`	`string`חובה באובייקט האב	`maxLength: 100`
`selection`	`object`חובה באובייקט האב	—
`selection.provider_api_version`	`string`חובה באובייקט האב	`const: "v26.0"`
`selection.provider_account_id`	`string`חובה באובייקט האב	`pattern: "^[1-9]\\d{1,24}$"`
`selection.currency`	`string`חובה באובייקט האב	`pattern: "^[A-Z]{3}$"`
`selection.timezone`	`string`חובה באובייקט האב	`maxLength: 100`
`selection.level`	`string`חובה באובייקט האב	`enum: ["campaign","adset","ad"]`
`selection.start_date`	`string`חובה באובייקט האב	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`selection.end_date`	`string`חובה באובייקט האב	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`selection.action_attribution_windows`	`array`חובה באובייקט האב	`minItems: 1` `maxItems: 1`
`selection.action_attribution_windows[]`	`string`רשות / פריט	`enum: ["1d_click","7d_click","1d_view"]`
`selection.action_report_time`	`string`חובה באובייקט האב	`enum: ["impression","conversion"]`
`selection.conversion_action_type`	`string`חובה באובייקט האב	`maxLength: 100`
`selection.revenue_action_type`	`string`חובה באובייקט האב	`maxLength: 100`
`complete`	`boolean`חובה באובייקט האב	—
`rows`	`array`חובה באובייקט האב	`maxItems: 500`
`rows[]`	`object`רשות / פריט	—
`rows[].row_id`	`string`חובה באובייקט האב	`maxLength: 100`
`rows[].metrics`	`object`חובה באובייקט האב	—
`rows[].metrics.spend`	`object`חובה באובייקט האב	—
`rows[].metrics.spend.value`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.spend.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.spend.value`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.spend.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.spend.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.spend.reason`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.spend.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`rows[].metrics.spend.reason`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.spend.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`rows[].metrics.spend.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`rows[].metrics.clicks`	`object`חובה באובייקט האב	—
`rows[].metrics.clicks.value`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.clicks.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.clicks.value`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.clicks.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.clicks.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.clicks.reason`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.clicks.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`rows[].metrics.clicks.reason`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.clicks.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`rows[].metrics.clicks.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`rows[].metrics.conversions`	`object`חובה באובייקט האב	—
`rows[].metrics.conversions.value`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.conversions.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.conversions.value`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.conversions.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.conversions.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.conversions.reason`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.conversions.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`rows[].metrics.conversions.reason`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.conversions.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`rows[].metrics.conversions.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`rows[].metrics.attributed_revenue`	`object`חובה באובייקט האב	—
`rows[].metrics.attributed_revenue.value`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.attributed_revenue.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.attributed_revenue.value`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.attributed_revenue.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.attributed_revenue.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.attributed_revenue.reason`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.attributed_revenue.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`rows[].metrics.attributed_revenue.reason`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.attributed_revenue.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`rows[].metrics.attributed_revenue.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`rows[].metrics.cpc`	`object`חובה באובייקט האב	—
`rows[].metrics.cpc.value`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.cpc.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.cpc.value`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.cpc.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.cpc.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.cpc.reason`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.cpc.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`rows[].metrics.cpc.reason`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.cpc.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`rows[].metrics.cpc.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`rows[].metrics.cpa`	`object`חובה באובייקט האב	—
`rows[].metrics.cpa.value`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.cpa.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.cpa.value`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.cpa.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.cpa.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.cpa.reason`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.cpa.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`rows[].metrics.cpa.reason`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.cpa.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`rows[].metrics.cpa.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`rows[].metrics.attributed_roas`	`object`חובה באובייקט האב	—
`rows[].metrics.attributed_roas.value`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.attributed_roas.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`rows[].metrics.attributed_roas.value`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.attributed_roas.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`rows[].metrics.attributed_roas.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`rows[].metrics.attributed_roas.reason`	`string \| null`חובה באובייקט האב	—
`rows[].metrics.attributed_roas.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`rows[].metrics.attributed_roas.reason`anyOf 2	`null`חובה באובייקט האב	—
`rows[].metrics.attributed_roas.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`rows[].metrics.attributed_roas.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`totals`	`object`חובה באובייקט האב	—
`totals.spend`	`object`חובה באובייקט האב	—
`totals.spend.value`	`string \| null`חובה באובייקט האב	—
`totals.spend.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.spend.value`anyOf 2	`null`חובה באובייקט האב	—
`totals.spend.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.spend.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.spend.reason`	`string \| null`חובה באובייקט האב	—
`totals.spend.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`totals.spend.reason`anyOf 2	`null`חובה באובייקט האב	—
`totals.spend.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`totals.spend.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`totals.clicks`	`object`חובה באובייקט האב	—
`totals.clicks.value`	`string \| null`חובה באובייקט האב	—
`totals.clicks.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.clicks.value`anyOf 2	`null`חובה באובייקט האב	—
`totals.clicks.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.clicks.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.clicks.reason`	`string \| null`חובה באובייקט האב	—
`totals.clicks.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`totals.clicks.reason`anyOf 2	`null`חובה באובייקט האב	—
`totals.clicks.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`totals.clicks.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`totals.conversions`	`object`חובה באובייקט האב	—
`totals.conversions.value`	`string \| null`חובה באובייקט האב	—
`totals.conversions.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.conversions.value`anyOf 2	`null`חובה באובייקט האב	—
`totals.conversions.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.conversions.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.conversions.reason`	`string \| null`חובה באובייקט האב	—
`totals.conversions.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`totals.conversions.reason`anyOf 2	`null`חובה באובייקט האב	—
`totals.conversions.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`totals.conversions.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`totals.attributed_revenue`	`object`חובה באובייקט האב	—
`totals.attributed_revenue.value`	`string \| null`חובה באובייקט האב	—
`totals.attributed_revenue.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.attributed_revenue.value`anyOf 2	`null`חובה באובייקט האב	—
`totals.attributed_revenue.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.attributed_revenue.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.attributed_revenue.reason`	`string \| null`חובה באובייקט האב	—
`totals.attributed_revenue.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`totals.attributed_revenue.reason`anyOf 2	`null`חובה באובייקט האב	—
`totals.attributed_revenue.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`totals.attributed_revenue.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`totals.cpc`	`object`חובה באובייקט האב	—
`totals.cpc.value`	`string \| null`חובה באובייקט האב	—
`totals.cpc.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.cpc.value`anyOf 2	`null`חובה באובייקט האב	—
`totals.cpc.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.cpc.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.cpc.reason`	`string \| null`חובה באובייקט האב	—
`totals.cpc.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`totals.cpc.reason`anyOf 2	`null`חובה באובייקט האב	—
`totals.cpc.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`totals.cpc.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`totals.cpa`	`object`חובה באובייקט האב	—
`totals.cpa.value`	`string \| null`חובה באובייקט האב	—
`totals.cpa.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.cpa.value`anyOf 2	`null`חובה באובייקט האב	—
`totals.cpa.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.cpa.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.cpa.reason`	`string \| null`חובה באובייקט האב	—
`totals.cpa.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`totals.cpa.reason`anyOf 2	`null`חובה באובייקט האב	—
`totals.cpa.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`totals.cpa.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`totals.attributed_roas`	`object`חובה באובייקט האב	—
`totals.attributed_roas.value`	`string \| null`חובה באובייקט האב	—
`totals.attributed_roas.value`anyOf 1	`string`חובה באובייקט האב	`pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"`
`totals.attributed_roas.value`anyOf 2	`null`חובה באובייקט האב	—
`totals.attributed_roas.unit`	`string`חובה באובייקט האב	`enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]`
`totals.attributed_roas.availability`	`string`חובה באובייקט האב	`enum: ["available","missing_input","zero_denominator","incompatible","partial"]`
`totals.attributed_roas.reason`	`string \| null`חובה באובייקט האב	—
`totals.attributed_roas.reason`anyOf 1	`string`חובה באובייקט האב	`maxLength: 300`
`totals.attributed_roas.reason`anyOf 2	`null`חובה באובייקט האב	—
`totals.attributed_roas.input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`totals.attributed_roas.input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`gaps`	`array`חובה באובייקט האב	`maxItems: 1000`
`gaps[]`	`string`רשות / פריט	`maxLength: 300`
`suggestions`	`array`חובה באובייקט האב	`maxItems: 3`
`suggestions[]`	`object`רשות / פריט	—
`suggestions[].rule_id`	`string`חובה באובייקט האב	`enum: ["supply_revenue","review_comparable_creative_test","complete_coverage"]`
`suggestions[].rule_version`	`number`חובה באובייקט האב	`const: 1`
`suggestions[].proposal`	`string`חובה באובייקט האב	`maxLength: 600`
`suggestions[].input_refs`	`array`חובה באובייקט האב	`maxItems: 2000`
`suggestions[].input_refs[]`	`string`רשות / פריט	`maxLength: 300`
`suggestions[].limitations`	`string`חובה באובייקט האב	`const: "Observational comparison only; no causal uplift or profitability claim. Human review required."`
`advertising_account_id`	`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`	`string \| null`חובה באובייקט האב	—
`next_cursor`anyOf 1	`string`חובה באובייקט האב	`maxLength: 2048`
`next_cursor`anyOf 2	`null`חובה באובייקט האב	—

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

שגיאות וניסיונות חוזרים בטוחים

בדקו את סטטוס ה-HTTP ואת גוף התגובה. שגיאת אימות 400 עשויה להכיל ZodError; שגיאות מטפל משתמשות בשדות error, ‏message ו-code. שמרו request_id או x-request-id לאבחון, ללא אמצעי גישה. תקנו שגיאות גישה 401/403 לפני ניסיון חוזר, ופעלו לפי Retry-After עבור 429. אם תוצאת כתיבה אינה ודאית או שמוחזר 5xx, קראו תחילה את התוצאה הקיימת. השתמשו שוב במפתח אידמפוטנטיות רק במקומות הנתמכים; התנהגות הניסיון החוזר משתנה בין פעולות ואינה מבטיחה מסירה בדיוק פעם אחת.

מדריך לפתרון בעיות

דוגמאות

הדוגמאות משתמשות בערכים בדויים שנבדקו מול הסכמות. החליפו את המזהים בכאלה שאתם מורשים להשתמש בהם, את המדיה בנכסים מוכנים ואת התאריכים במועד הפרסום שאישרתם. בדקו את התאמת החשבון לפני שליחת כתיבה. העמוד הזה אינו שולח בקשות API.

הגדירו בשרת שלכם SOSOAPI_ACCESS_TOKEN לאמצעי גישה שהפעולה הזו מקבלת, והשאירו אותו מחוץ לקוד הדפדפן. עבור סוכן AI, השתמשו ב-sosoapi auth login כדי להיכנס דרך הדפדפן ולאפשר ל-CLI לרענן את אמצעי הגישה שלו.

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

דוגמת תגובה סינתטית

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

כל פעולות ה-API אימות והרשאות

העדפות פרטיות

תכונות חיוניות

אבחון Landing והקלטת הפעלות עם הסתרת תוכן

ניתוח שימוש אופציונלי

לאפשר גם הקלטת הפעלות באתר הציבורי הזה

שאילתת נתוני פרסום

סקירה

אימות והרשאות

שדות הבקשה

תגובה והשלמה

שגיאות וניסיונות חוזרים בטוחים

דוגמאות

request.json

cURL

JavaScript

CLI

דוגמת תגובה סינתטית

שאילתת נתוני פרסום

סקירה

אימות והרשאות

שדות הבקשה

תגובה והשלמה

שגיאות וניסיונות חוזרים בטוחים

דוגמאות

request.json

cURL

JavaScript

CLI

דוגמת תגובה סינתטית

כלים ומדריכים קשורים