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

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

נדרשות לאבטחה ולפעולות הבסיסיות של האתר.

פעילות תמיד

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

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

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

לאפשר ניתוח שימוש באמצעות PostHog? אפשר לשנות את הבחירה בכל עת בתחתית האתר.

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

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

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

איך אנחנו משתמשים בנתונים

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

אישור ניתוח שימוש אופציונלי מאפשר ל-PostHog לשתף קובץ Cookie אנונימי בין האתר הזה לאפליקציה שלנו, עם אחסון מקומי בדפדפן בכל אחד מהאתרים. בהסכמתכם, ניתן לקשר ביקור מאומת באותה לשונית לחשבון החדש שלכם לאחר אישור ההרשמה.

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

הודעת פרטיות ומדידה מצטברת נפרדת באמצעות Cloudflare.

ניתוח השימוש בדפדפן אינו מפעיל ניתוח שימוש בחשבון.

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

החיפוש נטען רק כשמשתמשים בו. עיינו בכל הקטגוריות שלהלן.

כלי MCP

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

sosoapi_ads_insights_query

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

קריאה בפורמט Markdown

פרופילים ואמצעי תעבורה

פרופילים: full · אמצעי תעבורה: stdio, http

בחרו core או full כדי לשלוט בכלים שהלקוח רואה; הבחירה אינה משנה את ההרשאות שלו. העלאת קבצים מקומיים דורשת stdio ואינה זמינה דרך HTTP. הגדירו SOSOAPI_OUTPUT_SCHEMAS=1 להכללת סכמות פלט בגילוי הכלים. הכלים מחזירים תוצאות מובנות עם ההגדרה הזו או בלעדיה.

הרשאות והשפעות לוואי

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

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

שדות קלט

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

שדות קלט
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
workspace_idstringחובה באובייקט האב
  • format: "uuid"
advertising_account_idstringחובה באובייקט האב
  • format: "uuid"
levelstringחובה באובייקט האב
  • enum: ["campaign","adset","ad"]
start_datestringחובה באובייקט האב
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
end_datestringחובה באובייקט האב
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
action_attribution_windowsarrayחובה באובייקט האב
  • minItems: 1
  • maxItems: 1
action_attribution_windows[]stringרשות / פריט
  • enum: ["1d_click","7d_click","1d_view"]
action_report_timestringחובה באובייקט האב
  • enum: ["impression","conversion"]
conversion_action_typestringחובה באובייקט האב
  • pattern: "^[a-z][a-z0-9_.]{0,99}$"
revenue_action_typestringחובה באובייקט האב
  • pattern: "^[a-z][a-z0-9_.]{0,99}$"
afterstringרשות / פריט
  • maxLength: 2048
limitintegerרשות / פריט
  • minimum: 1
  • maximum: 50
JSON Schema מלא
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "advertising_account_id": {
      "type": "string",
      "format": "uuid"
    },
    "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": {
      "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
}

פלט מובנה

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

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

פלט מובנה
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
contract_versionstringחובה באובייקט האב
  • const: "ad-performance/v1"
source_idstringחובה באובייקט האב
  • maxLength: 100
source_sha256stringחובה באובייקט האב
  • pattern: "^[a-f0-9]{64}$"
identity_verificationstringחובה באובייקט האב
  • enum: ["customer_supplied","accepted_provider_grant"]
currencystringחובה באובייקט האב
  • pattern: "^[A-Z]{3}$"
timezonestringחובה באובייקט האב
  • maxLength: 100
selectionobjectחובה באובייקט האב
  • additionalProperties: false
selection.provider_api_versionstringחובה באובייקט האב
  • const: "v26.0"
selection.provider_account_idstringחובה באובייקט האב
  • pattern: "^[1-9]\\d{1,24}$"
selection.currencystringחובה באובייקט האב
  • pattern: "^[A-Z]{3}$"
selection.timezonestringחובה באובייקט האב
  • maxLength: 100
selection.levelstringחובה באובייקט האב
  • enum: ["campaign","adset","ad"]
selection.start_datestringחובה באובייקט האב
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
selection.end_datestringחובה באובייקט האב
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
selection.action_attribution_windowsarrayחובה באובייקט האב
  • minItems: 1
  • maxItems: 1
selection.action_attribution_windows[]stringרשות / פריט
  • enum: ["1d_click","7d_click","1d_view"]
selection.action_report_timestringחובה באובייקט האב
  • enum: ["impression","conversion"]
selection.conversion_action_typestringחובה באובייקט האב
  • maxLength: 100
selection.revenue_action_typestringחובה באובייקט האב
  • maxLength: 100
completebooleanחובה באובייקט האב—
rowsarrayחובה באובייקט האב
  • maxItems: 500
rows[]objectרשות / פריט
  • additionalProperties: false
rows[].row_idstringחובה באובייקט האב
  • maxLength: 100
rows[].metricsobjectחובה באובייקט האב
  • additionalProperties: false
rows[].metrics.spendobjectחובה באובייקט האב
  • additionalProperties: false
rows[].metrics.spend.valuestring | nullחובה באובייקט האב—
rows[].metrics.spend.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.spend.valueanyOf 2nullחובה באובייקט האב—
rows[].metrics.spend.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.spend.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.spend.reasonstring | nullחובה באובייקט האב—
rows[].metrics.spend.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
rows[].metrics.spend.reasonanyOf 2nullחובה באובייקט האב—
rows[].metrics.spend.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
rows[].metrics.spend.input_refs[]stringרשות / פריט
  • maxLength: 300
rows[].metrics.clicksobjectחובה באובייקט האב
  • additionalProperties: false
rows[].metrics.clicks.valuestring | nullחובה באובייקט האב—
rows[].metrics.clicks.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.clicks.valueanyOf 2nullחובה באובייקט האב—
rows[].metrics.clicks.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.clicks.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.clicks.reasonstring | nullחובה באובייקט האב—
rows[].metrics.clicks.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
rows[].metrics.clicks.reasonanyOf 2nullחובה באובייקט האב—
rows[].metrics.clicks.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
rows[].metrics.clicks.input_refs[]stringרשות / פריט
  • maxLength: 300
rows[].metrics.conversionsobjectחובה באובייקט האב
  • additionalProperties: false
rows[].metrics.conversions.valuestring | nullחובה באובייקט האב—
rows[].metrics.conversions.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.conversions.valueanyOf 2nullחובה באובייקט האב—
rows[].metrics.conversions.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.conversions.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.conversions.reasonstring | nullחובה באובייקט האב—
rows[].metrics.conversions.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
rows[].metrics.conversions.reasonanyOf 2nullחובה באובייקט האב—
rows[].metrics.conversions.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
rows[].metrics.conversions.input_refs[]stringרשות / פריט
  • maxLength: 300
rows[].metrics.attributed_revenueobjectחובה באובייקט האב
  • additionalProperties: false
rows[].metrics.attributed_revenue.valuestring | nullחובה באובייקט האב—
rows[].metrics.attributed_revenue.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.attributed_revenue.valueanyOf 2nullחובה באובייקט האב—
rows[].metrics.attributed_revenue.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.attributed_revenue.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.attributed_revenue.reasonstring | nullחובה באובייקט האב—
rows[].metrics.attributed_revenue.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
rows[].metrics.attributed_revenue.reasonanyOf 2nullחובה באובייקט האב—
rows[].metrics.attributed_revenue.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
rows[].metrics.attributed_revenue.input_refs[]stringרשות / פריט
  • maxLength: 300
rows[].metrics.cpcobjectחובה באובייקט האב
  • additionalProperties: false
rows[].metrics.cpc.valuestring | nullחובה באובייקט האב—
rows[].metrics.cpc.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.cpc.valueanyOf 2nullחובה באובייקט האב—
rows[].metrics.cpc.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.cpc.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.cpc.reasonstring | nullחובה באובייקט האב—
rows[].metrics.cpc.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
rows[].metrics.cpc.reasonanyOf 2nullחובה באובייקט האב—
rows[].metrics.cpc.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
rows[].metrics.cpc.input_refs[]stringרשות / פריט
  • maxLength: 300
rows[].metrics.cpaobjectחובה באובייקט האב
  • additionalProperties: false
rows[].metrics.cpa.valuestring | nullחובה באובייקט האב—
rows[].metrics.cpa.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.cpa.valueanyOf 2nullחובה באובייקט האב—
rows[].metrics.cpa.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.cpa.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.cpa.reasonstring | nullחובה באובייקט האב—
rows[].metrics.cpa.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
rows[].metrics.cpa.reasonanyOf 2nullחובה באובייקט האב—
rows[].metrics.cpa.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
rows[].metrics.cpa.input_refs[]stringרשות / פריט
  • maxLength: 300
rows[].metrics.attributed_roasobjectחובה באובייקט האב
  • additionalProperties: false
rows[].metrics.attributed_roas.valuestring | nullחובה באובייקט האב—
rows[].metrics.attributed_roas.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
rows[].metrics.attributed_roas.valueanyOf 2nullחובה באובייקט האב—
rows[].metrics.attributed_roas.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
rows[].metrics.attributed_roas.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
rows[].metrics.attributed_roas.reasonstring | nullחובה באובייקט האב—
rows[].metrics.attributed_roas.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
rows[].metrics.attributed_roas.reasonanyOf 2nullחובה באובייקט האב—
rows[].metrics.attributed_roas.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
rows[].metrics.attributed_roas.input_refs[]stringרשות / פריט
  • maxLength: 300
totalsobjectחובה באובייקט האב
  • additionalProperties: false
totals.spendobjectחובה באובייקט האב
  • additionalProperties: false
totals.spend.valuestring | nullחובה באובייקט האב—
totals.spend.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.spend.valueanyOf 2nullחובה באובייקט האב—
totals.spend.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.spend.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.spend.reasonstring | nullחובה באובייקט האב—
totals.spend.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
totals.spend.reasonanyOf 2nullחובה באובייקט האב—
totals.spend.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
totals.spend.input_refs[]stringרשות / פריט
  • maxLength: 300
totals.clicksobjectחובה באובייקט האב
  • additionalProperties: false
totals.clicks.valuestring | nullחובה באובייקט האב—
totals.clicks.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.clicks.valueanyOf 2nullחובה באובייקט האב—
totals.clicks.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.clicks.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.clicks.reasonstring | nullחובה באובייקט האב—
totals.clicks.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
totals.clicks.reasonanyOf 2nullחובה באובייקט האב—
totals.clicks.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
totals.clicks.input_refs[]stringרשות / פריט
  • maxLength: 300
totals.conversionsobjectחובה באובייקט האב
  • additionalProperties: false
totals.conversions.valuestring | nullחובה באובייקט האב—
totals.conversions.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.conversions.valueanyOf 2nullחובה באובייקט האב—
totals.conversions.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.conversions.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.conversions.reasonstring | nullחובה באובייקט האב—
totals.conversions.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
totals.conversions.reasonanyOf 2nullחובה באובייקט האב—
totals.conversions.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
totals.conversions.input_refs[]stringרשות / פריט
  • maxLength: 300
totals.attributed_revenueobjectחובה באובייקט האב
  • additionalProperties: false
totals.attributed_revenue.valuestring | nullחובה באובייקט האב—
totals.attributed_revenue.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.attributed_revenue.valueanyOf 2nullחובה באובייקט האב—
totals.attributed_revenue.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.attributed_revenue.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.attributed_revenue.reasonstring | nullחובה באובייקט האב—
totals.attributed_revenue.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
totals.attributed_revenue.reasonanyOf 2nullחובה באובייקט האב—
totals.attributed_revenue.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
totals.attributed_revenue.input_refs[]stringרשות / פריט
  • maxLength: 300
totals.cpcobjectחובה באובייקט האב
  • additionalProperties: false
totals.cpc.valuestring | nullחובה באובייקט האב—
totals.cpc.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.cpc.valueanyOf 2nullחובה באובייקט האב—
totals.cpc.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.cpc.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.cpc.reasonstring | nullחובה באובייקט האב—
totals.cpc.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
totals.cpc.reasonanyOf 2nullחובה באובייקט האב—
totals.cpc.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
totals.cpc.input_refs[]stringרשות / פריט
  • maxLength: 300
totals.cpaobjectחובה באובייקט האב
  • additionalProperties: false
totals.cpa.valuestring | nullחובה באובייקט האב—
totals.cpa.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.cpa.valueanyOf 2nullחובה באובייקט האב—
totals.cpa.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.cpa.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.cpa.reasonstring | nullחובה באובייקט האב—
totals.cpa.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
totals.cpa.reasonanyOf 2nullחובה באובייקט האב—
totals.cpa.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
totals.cpa.input_refs[]stringרשות / פריט
  • maxLength: 300
totals.attributed_roasobjectחובה באובייקט האב
  • additionalProperties: false
totals.attributed_roas.valuestring | nullחובה באובייקט האב—
totals.attributed_roas.valueanyOf 1stringחובה באובייקט האב
  • pattern: "^\\d{1,24}(?:\\.\\d{1,6})?$"
totals.attributed_roas.valueanyOf 2nullחובה באובייקט האב—
totals.attributed_roas.unitstringחובה באובייקט האב
  • enum: ["currency","count","currency_per_click","currency_per_conversion","ratio"]
totals.attributed_roas.availabilitystringחובה באובייקט האב
  • enum: ["available","missing_input","zero_denominator","incompatible","partial"]
totals.attributed_roas.reasonstring | nullחובה באובייקט האב—
totals.attributed_roas.reasonanyOf 1stringחובה באובייקט האב
  • maxLength: 300
totals.attributed_roas.reasonanyOf 2nullחובה באובייקט האב—
totals.attributed_roas.input_refsarrayחובה באובייקט האב
  • maxItems: 2000
totals.attributed_roas.input_refs[]stringרשות / פריט
  • maxLength: 300
gapsarrayחובה באובייקט האב
  • maxItems: 1000
gaps[]stringרשות / פריט
  • maxLength: 300
suggestionsarrayחובה באובייקט האב
  • maxItems: 3
suggestions[]objectרשות / פריט
  • additionalProperties: false
suggestions[].rule_idstringחובה באובייקט האב
  • enum: ["supply_revenue","review_comparable_creative_test","complete_coverage"]
suggestions[].rule_versionnumberחובה באובייקט האב
  • const: 1
suggestions[].proposalstringחובה באובייקט האב
  • maxLength: 600
suggestions[].input_refsarrayחובה באובייקט האב
  • maxItems: 2000
suggestions[].input_refs[]stringרשות / פריט
  • maxLength: 300
suggestions[].limitationsstringחובה באובייקט האב
  • const: "Observational comparison only; no causal uplift or profitability claim. Human review required."
advertising_account_idstringחובה באובייקט האב
  • format: "uuid"
next_cursorstring | nullחובה באובייקט האב—
next_cursoranyOf 1stringחובה באובייקט האב
  • maxLength: 2048
next_cursoranyOf 2nullחובה באובייקט האב—
JSON Schema מלא
{
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "ad-performance/v1"
    },
    "source_id": {
      "type": "string",
      "maxLength": 100
    },
    "source_sha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "identity_verification": {
      "type": "string",
      "enum": [
        "customer_supplied",
        "accepted_provider_grant"
      ]
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "timezone": {
      "type": "string",
      "maxLength": 100
    },
    "selection": {
      "type": "object",
      "properties": {
        "provider_api_version": {
          "type": "string",
          "const": "v26.0"
        },
        "provider_account_id": {
          "type": "string",
          "pattern": "^[1-9]\\d{1,24}$"
        },
        "currency": {
          "type": "string",
          "pattern": "^[A-Z]{3}$"
        },
        "timezone": {
          "type": "string",
          "maxLength": 100
        },
        "level": {
          "type": "string",
          "enum": [
            "campaign",
            "adset",
            "ad"
          ]
        },
        "start_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "end_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "action_attribution_windows": {
          "minItems": 1,
          "maxItems": 1,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "1d_click",
              "7d_click",
              "1d_view"
            ]
          }
        },
        "action_report_time": {
          "type": "string",
          "enum": [
            "impression",
            "conversion"
          ]
        },
        "conversion_action_type": {
          "type": "string",
          "maxLength": 100
        },
        "revenue_action_type": {
          "type": "string",
          "maxLength": 100
        }
      },
      "required": [
        "provider_api_version",
        "provider_account_id",
        "currency",
        "timezone",
        "level",
        "start_date",
        "end_date",
        "action_attribution_windows",
        "action_report_time",
        "conversion_action_type",
        "revenue_action_type"
      ],
      "additionalProperties": false
    },
    "complete": {
      "type": "boolean"
    },
    "rows": {
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "row_id": {
            "type": "string",
            "maxLength": 100
          },
          "metrics": {
            "type": "object",
            "properties": {
              "spend": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ],
                "additionalProperties": false
              },
              "clicks": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ],
                "additionalProperties": false
              },
              "conversions": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ],
                "additionalProperties": false
              },
              "attributed_revenue": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ],
                "additionalProperties": false
              },
              "cpc": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ],
                "additionalProperties": false
              },
              "cpa": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ],
                "additionalProperties": false
              },
              "attributed_roas": {
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "currency",
                      "count",
                      "currency_per_click",
                      "currency_per_conversion",
                      "ratio"
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "missing_input",
                      "zero_denominator",
                      "incompatible",
                      "partial"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 300
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "input_refs": {
                    "maxItems": 2000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  }
                },
                "required": [
                  "value",
                  "unit",
                  "availability",
                  "reason",
                  "input_refs"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "spend",
              "clicks",
              "conversions",
              "attributed_revenue",
              "cpc",
              "cpa",
              "attributed_roas"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "row_id",
          "metrics"
        ],
        "additionalProperties": false
      }
    },
    "totals": {
      "type": "object",
      "properties": {
        "spend": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ],
          "additionalProperties": false
        },
        "clicks": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ],
          "additionalProperties": false
        },
        "conversions": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ],
          "additionalProperties": false
        },
        "attributed_revenue": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ],
          "additionalProperties": false
        },
        "cpc": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ],
          "additionalProperties": false
        },
        "cpa": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ],
          "additionalProperties": false
        },
        "attributed_roas": {
          "type": "object",
          "properties": {
            "value": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{1,24}(?:\\.\\d{1,6})?$"
                },
                {
                  "type": "null"
                }
              ]
            },
            "unit": {
              "type": "string",
              "enum": [
                "currency",
                "count",
                "currency_per_click",
                "currency_per_conversion",
                "ratio"
              ]
            },
            "availability": {
              "type": "string",
              "enum": [
                "available",
                "missing_input",
                "zero_denominator",
                "incompatible",
                "partial"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 300
                },
                {
                  "type": "null"
                }
              ]
            },
            "input_refs": {
              "maxItems": 2000,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "required": [
            "value",
            "unit",
            "availability",
            "reason",
            "input_refs"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "spend",
        "clicks",
        "conversions",
        "attributed_revenue",
        "cpc",
        "cpa",
        "attributed_roas"
      ],
      "additionalProperties": false
    },
    "gaps": {
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 300
      }
    },
    "suggestions": {
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rule_id": {
            "type": "string",
            "enum": [
              "supply_revenue",
              "review_comparable_creative_test",
              "complete_coverage"
            ]
          },
          "rule_version": {
            "type": "number",
            "const": 1
          },
          "proposal": {
            "type": "string",
            "maxLength": 600
          },
          "input_refs": {
            "maxItems": 2000,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 300
            }
          },
          "limitations": {
            "type": "string",
            "const": "Observational comparison only; no causal uplift or profitability claim. Human review required."
          }
        },
        "required": [
          "rule_id",
          "rule_version",
          "proposal",
          "input_refs",
          "limitations"
        ],
        "additionalProperties": false
      }
    },
    "advertising_account_id": {
      "type": "string",
      "format": "uuid"
    },
    "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"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

דוגמת קריאה לכלי

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

{
  "name": "sosoapi_ads_insights_query",
  "arguments": {
    "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"
  }
}

structuredContent

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