Read splits
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | ||
| limit | No | ||
| ad_ids | No | ||
| cursor | No | ||
| rollup | No | dimension | |
| date_to | No | ||
| date_from | No | ||
| product_ref | No | ||
| product_name | No | ||
| breakdown_type | No | ||
| conversion_event | No |
| Name | Required | Description | Default |
|---|---|---|---|
| message | No | ||
| retryable | No | ||
| support_ref | No |
Changes observed during successful MCP inspections.
Input schema / properties / conversion_eventAdded value: +{
+ "type": "string"
+}Input schema / properties / ad_idsAdded value: +{
+ "items": {
+ "type": "string"
+ },
+ "maxItems": 50,
+ "minItems": 1,
+ "type": "array"
+}Input schema / properties / cursorAdded value: +{
+ "type": "string"
+}Input schema / properties / rollup / enumPrevious value: -[
- "dimension",
- "campaign"
-]New value: +[
+ "dimension",
+ "campaign",
+ "ad"
+]Output schema / else / anyOfPrevious value: -[
- {
- "properties": {
- "cache_hint": {
- "properties": {
- "message": {
- "type": "string"
- },
- "recommended_next_tool": {
- "type": "string"
- },
- "status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "count": {
- "type": "integer"
- },
- "dimension_row_count": {
- "type": "integer"
- },
- "items": {
- "items": {
- "properties": {
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "bid_amount": {
- "type": [
- "number",
- "null"
- ]
- },
- "bid_strategy": {
- "type": [
- "string",
- "null"
- ]
- },
- "breakdown_key": {
- "type": "string"
- },
- "breakdown_type": {
- "type": "string"
- },
- "budget_level": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_row_count": {
- "type": "integer"
- },
- "clicks": {
- "type": [
- "number",
- "null"
- ]
- },
- "configured_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "conversion_value": {
- "type": [
- "number",
- "null"
- ]
- },
- "conversions": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpa": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpc": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpc_usd": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpm": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpm_usd": {
- "type": [
- "number",
- "null"
- ]
- },
- "ctr": {
- "type": [
- "number",
- "null"
- ]
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "data_as_of_date": {
- "type": [
- "string",
- "null"
- ]
- },
- "date": {
- "type": [
- "string",
- "null"
- ]
- },
- "date_from": {
- "type": [
- "string",
- "null"
- ]
- },
- "date_start": {
- "type": [
- "string",
- "null"
- ]
- },
- "date_stop": {
- "type": [
- "string",
- "null"
- ]
- },
- "date_to": {
- "type": [
- "string",
- "null"
- ]
- },
- "delivery_issue_codes": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "delivery_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "effective_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_id": {
- "type": "string"
- },
- "entity_name": {
- "type": "string"
- },
- "event_metrics": {
- "additionalProperties": {
- "properties": {
- "cost_usd": {
- "type": "number"
- },
- "count": {
- "type": "number"
- },
- "cvr_clicks": {
- "type": "number"
- }
- },
- "type": "object"
- },
- "type": "object"
- },
- "funnel": {
- "additionalProperties": {
- "type": "number"
- },
- "type": "object"
- },
- "id": {
- "type": [
- "string",
- "null"
- ]
- },
- "impressions": {
- "type": [
- "number",
- "null"
- ]
- },
- "level": {
- "type": [
- "string",
- "null"
- ]
- },
- "lifetime_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "money_unit": {
- "type": [
- "string",
- "null"
- ]
- },
- "name": {
- "type": [
- "string",
- "null"
- ]
- },
- "optimization_goal": {
- "type": [
- "string",
- "null"
- ]
- },
- "primary_event_count": {
- "type": [
- "number",
- "null"
- ]
- },
- "primary_event_cpa_usd": {
- "type": [
- "number",
- "null"
- ]
- },
- "primary_event_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "product_type": {
- "type": [
- "string",
- "null"
- ]
- },
- "reach": {
- "type": [
- "number",
- "null"
- ]
- },
- "roas": {
- "type": [
- "number",
- "null"
- ]
- },
- "rollup": {
- "type": "string"
- },
- "source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "spend": {
- "type": [
- "number",
- "null"
- ]
- },
- "spend_usd": {
- "type": [
- "number",
- "null"
- ]
- },
- "status": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "meta": {
- "properties": {
- "cache_hit": {
- "type": "boolean"
- },
- "coalesced": {
- "type": "boolean"
- },
- "complete": {
- "type": "boolean"
- },
- "data_as_of_date": {
- "type": [
- "string",
- "null"
- ]
- },
- "data_freshness": {
- "properties": {
- "interval_min": {
- "type": "integer"
- },
- "label": {
- "type": "string"
- },
- "last_pull_failed_account_count": {
- "type": [
- "integer",
- "null"
- ]
- },
- "last_pull_scope": {
- "const": "workspace"
- },
- "last_pull_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "last_pulled_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "max_staleness_min": {
- "type": "integer"
- },
- "server_now_utc": {
- "type": "string"
- },
- "staleness_seconds": {
- "type": [
- "integer",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "duration_ms": {
- "type": "integer"
- },
- "failed": {
- "type": "integer"
- },
- "freshness_warnings": {
- "items": {
- "properties": {
- "account_count": {
- "type": "integer"
- },
- "code": {
- "type": "string"
- },
- "dispersion_seconds": {
- "type": "integer"
- },
- "last_pull_failed_account_count": {
- "type": [
- "integer",
- "null"
- ]
- },
- "last_pull_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "message": {
- "type": "string"
- },
- "metrics_source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "newest_source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "observed_account_count": {
- "type": "integer"
- },
- "oldest_source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "has_more": {
- "type": "boolean"
- },
- "item_count": {
- "type": "integer"
- },
- "limitations": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "metrics_source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "missing_scopes": {
- "items": {
- "properties": {
- "index": {
- "type": "integer"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "index",
- "status"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "next_cursor": {
- "type": [
- "string",
- "null"
- ]
- },
- "page": {
- "type": "integer"
- },
- "page_size": {
- "type": "integer"
- },
- "refresh_reused": {
- "type": "boolean"
- },
- "returned_count": {
- "type": "integer"
- },
- "scope_count": {
- "type": "integer"
- },
- "source": {
- "type": "string"
- },
- "source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_row_count": {
- "type": "integer"
- },
- "source_truncated": {
- "type": "boolean"
- },
- "source_watermark": {
- "type": [
- "string",
- "null"
- ]
- },
- "succeeded": {
- "type": "integer"
- },
- "total_count": {
- "type": [
- "integer",
- "null"
- ]
- },
- "total_items": {
- "type": "integer"
- },
- "total_pages": {
- "type": "integer"
- }
- },
- "type": "object"
- },
- "rollup": {
- "type": "string"
- },
- "routing": {
- "properties": {
- "cache_coverage": {
- "properties": {
- "products": {
- "additionalProperties": {
- "properties": {
- "complete": {
- "type": "boolean"
- },
- "has_more": {
- "type": "boolean"
- },
- "limitations": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "next_cursor": {
- "type": [
- "string",
- "null"
- ]
- },
- "returned_count": {
- "type": "integer"
- },
- "source": {
- "type": "string"
- },
- "source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_watermark": {
- "type": [
- "string",
- "null"
- ]
- },
- "total_count": {
- "type": [
- "integer",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "object"
- },
- "status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "decision": {
- "type": "string"
- },
- "pull_breakdowns": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "quota": {
- "properties": {
- "available": {
- "type": "boolean"
- },
- "limit": {
- "type": [
- "integer",
- "null"
- ]
- },
- "operator_bypass": {
- "type": "boolean"
- },
- "remaining": {
- "type": "integer"
- },
- "used": {
- "type": "integer"
- }
- },
- "type": "object"
- },
- "reason": {
- "type": "string"
- },
- "recommended_next_tool": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "stored_row_count": {
- "type": [
- "integer",
- "null"
- ]
- },
- "totals": {
- "properties": {
- "clicks": {
- "type": [
- "number",
- "null"
- ]
- },
- "conversion_value": {
- "type": [
- "number",
- "null"
- ]
- },
- "conversions": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpa": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpc": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpm": {
- "type": [
- "number",
- "null"
- ]
- },
- "ctr": {
- "type": [
- "number",
- "null"
- ]
- },
- "funnel": {
- "additionalProperties": {
- "type": "number"
- },
- "type": "object"
- },
- "impressions": {
- "type": [
- "number",
- "null"
- ]
- },
- "reach": {
- "type": [
- "number",
- "null"
- ]
- },
- "roas": {
- "type": [
- "number",
- "null"
- ]
- },
- "spend": {
- "type": [
- "number",
- "null"
- ]
- },
- "spend_usd": {
- "type": [
- "number",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "truncated": {
- "type": "boolean"
- }
- },
- "required": [
- "items",
- "count",
- "truncated",
- "rollup",
- "meta",
- "routing"
- ]
- },
- {
- "properties": {
- "expires_at": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "poll": {
- "properties": {
- "arguments": {
- "properties": {
- "product_ref": {
- "type": "string"
- },
- "task_ref": {
- "type": "string"
- },
- "template_name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "name": {
- "type": "string"
- },
- "tool": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "poll_after_ms": {
- "type": "integer"
- },
- "status": {
- "const": "queued"
- },
- "submitted_new": {
- "type": "boolean"
- },
- "task_ref": {
- "type": "string"
- },
- "task_status": {
- "type": "string"
- },
- "task_type": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "task_ref",
- "task_status",
- "poll_after_ms",
- "expires_at",
- "poll"
- ]
- }
-]New value: +[
+ {
+ "properties": {
+ "ad_ids": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cache_hint": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "recommended_next_tool": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "complete": {
+ "type": "boolean"
+ },
+ "count": {
+ "type": "integer"
+ },
+ "dimension_row_count": {
+ "type": "integer"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "bid_amount": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "bid_strategy": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "breakdown_key": {
+ "type": "string"
+ },
+ "breakdown_type": {
+ "type": "string"
+ },
+ "budget_level": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_row_count": {
+ "type": "integer"
+ },
+ "clicks": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "configured_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "conversion_value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "conversions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpa": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpc": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpc_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpm": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpm_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "ctr": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "data_as_of_date": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date_from": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date_start": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date_stop": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date_to": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "delivery_issue_codes": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "delivery_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "effective_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_id": {
+ "type": "string"
+ },
+ "entity_name": {
+ "type": "string"
+ },
+ "event_metrics": {
+ "additionalProperties": {
+ "properties": {
+ "cost_usd": {
+ "type": "number"
+ },
+ "count": {
+ "type": "number"
+ },
+ "cvr_clicks": {
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "type": "object"
+ },
+ "funnel": {
+ "additionalProperties": {
+ "type": "number"
+ },
+ "type": "object"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "impressions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "level": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "lifetime_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "money_unit": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "optimization_goal": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "primary_event_count": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "primary_event_cpa_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "primary_event_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "product_type": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reach": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "roas": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "rollup": {
+ "type": "string"
+ },
+ "source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "spend": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "meta": {
+ "properties": {
+ "cache_hit": {
+ "type": "boolean"
+ },
+ "coalesced": {
+ "type": "boolean"
+ },
+ "complete": {
+ "type": "boolean"
+ },
+ "data_as_of_date": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "data_freshness": {
+ "properties": {
+ "interval_min": {
+ "type": "integer"
+ },
+ "label": {
+ "type": "string"
+ },
+ "last_pull_failed_account_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "last_pull_scope": {
+ "const": "workspace"
+ },
+ "last_pull_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "last_pulled_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "max_staleness_min": {
+ "type": "integer"
+ },
+ "server_now_utc": {
+ "type": "string"
+ },
+ "staleness_seconds": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "duration_ms": {
+ "type": "integer"
+ },
+ "failed": {
+ "type": "integer"
+ },
+ "freshness_warnings": {
+ "items": {
+ "properties": {
+ "account_count": {
+ "type": "integer"
+ },
+ "code": {
+ "type": "string"
+ },
+ "dispersion_seconds": {
+ "type": "integer"
+ },
+ "last_pull_failed_account_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "last_pull_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "message": {
+ "type": "string"
+ },
+ "metrics_source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "newest_source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "observed_account_count": {
+ "type": "integer"
+ },
+ "oldest_source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "has_more": {
+ "type": "boolean"
+ },
+ "item_count": {
+ "type": "integer"
+ },
+ "limitations": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "metrics_source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "missing_scopes": {
+ "items": {
+ "properties": {
+ "index": {
+ "type": "integer"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "index",
+ "status"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "next_cursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page": {
+ "type": "integer"
+ },
+ "page_size": {
+ "type": "integer"
+ },
+ "refresh_reused": {
+ "type": "boolean"
+ },
+ "returned_count": {
+ "type": "integer"
+ },
+ "scope_count": {
+ "type": "integer"
+ },
+ "source": {
+ "type": "string"
+ },
+ "source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_row_count": {
+ "type": "integer"
+ },
+ "source_truncated": {
+ "type": "boolean"
+ },
+ "source_watermark": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "succeeded": {
+ "type": "integer"
+ },
+ "total_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total_items": {
+ "type": "integer"
+ },
+ "total_pages": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "next_cursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "rollup": {
+ "type": "string"
+ },
+ "routing": {
+ "properties": {
+ "cache_coverage": {
+ "properties": {
+ "products": {
+ "additionalProperties": {
+ "properties": {
+ "complete": {
+ "type": "boolean"
+ },
+ "has_more": {
+ "type": "boolean"
+ },
+ "limitations": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "next_cursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "returned_count": {
+ "type": "integer"
+ },
+ "source": {
+ "type": "string"
+ },
+ "source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_watermark": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "total_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "object"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "decision": {
+ "type": "string"
+ },
+ "pull_breakdowns": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "quota": {
+ "properties": {
+ "available": {
+ "type": "boolean"
+ },
+ "limit": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "operator_bypass": {
+ "type": "boolean"
+ },
+ "remaining": {
+ "type": "integer"
+ },
+ "used": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "recommended_next_tool": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "stored_row_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "totals": {
+ "properties": {
+ "clicks": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "conversion_value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "conversions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpa": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpc": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpm": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "ctr": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "funnel": {
+ "additionalProperties": {
+ "type": "number"
+ },
+ "type": "object"
+ },
+ "impressions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "reach": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "roas": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "truncated": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "items",
+ "count",
+ "truncated",
+ "rollup",
+ "meta",
+ "routing"
+ ]
+ },
+ {
+ "properties": {
+ "expires_at": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "poll": {
+ "properties": {
+ "arguments": {
+ "properties": {
+ "product_ref": {
+ "type": "string"
+ },
+ "task_ref": {
+ "type": "string"
+ },
+ "template_name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "name": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "poll_after_ms": {
+ "type": "integer"
+ },
+ "status": {
+ "const": "queued"
+ },
+ "submitted_new": {
+ "type": "boolean"
+ },
+ "task_ref": {
+ "type": "string"
+ },
+ "task_status": {
+ "type": "string"
+ },
+ "task_type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "task_ref",
+ "task_status",
+ "poll_after_ms",
+ "expires_at",
+ "poll"
+ ]
+ }
+]Output schema / else / anyOfPrevious value: -[
- {
- "properties": {
- "cache_hint": {
- "properties": {
- "message": {
- "type": "string"
- },
- "recommended_next_tool": {
- "type": "string"
- },
- "status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "count": {
- "type": "integer"
- },
- "dimension_row_count": {
- "type": "integer"
- },
- "items": {
- "items": {
- "properties": {
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "bid_amount": {
- "type": [
- "number",
- "null"
- ]
- },
- "bid_strategy": {
- "type": [
- "string",
- "null"
- ]
- },
- "breakdown_key": {
- "type": "string"
- },
- "breakdown_type": {
- "type": "string"
- },
- "budget_level": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_row_count": {
- "type": "integer"
- },
- "clicks": {
- "type": [
- "number",
- "null"
- ]
- },
- "configured_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "conversion_value": {
- "type": [
- "number",
- "null"
- ]
- },
- "conversions": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpa": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpc": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpc_usd": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpm": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpm_usd": {
- "type": [
- "number",
- "null"
- ]
- },
- "ctr": {
- "type": [
- "number",
- "null"
- ]
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "data_as_of_date": {
- "type": [
- "string",
- "null"
- ]
- },
- "date": {
- "type": [
- "string",
- "null"
- ]
- },
- "date_from": {
- "type": [
- "string",
- "null"
- ]
- },
- "date_start": {
- "type": [
- "string",
- "null"
- ]
- },
- "date_stop": {
- "type": [
- "string",
- "null"
- ]
- },
- "date_to": {
- "type": [
- "string",
- "null"
- ]
- },
- "delivery_issue_codes": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "delivery_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "effective_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_id": {
- "type": "string"
- },
- "entity_name": {
- "type": "string"
- },
- "event_metrics": {
- "additionalProperties": {
- "properties": {
- "cost_usd": {
- "type": "number"
- },
- "count": {
- "type": "number"
- },
- "cvr_clicks": {
- "type": "number"
- }
- },
- "type": "object"
- },
- "type": "object"
- },
- "funnel": {
- "additionalProperties": {
- "type": "number"
- },
- "type": "object"
- },
- "id": {
- "type": [
- "string",
- "null"
- ]
- },
- "impressions": {
- "type": [
- "number",
- "null"
- ]
- },
- "level": {
- "type": [
- "string",
- "null"
- ]
- },
- "lifetime_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "money_unit": {
- "type": [
- "string",
- "null"
- ]
- },
- "name": {
- "type": [
- "string",
- "null"
- ]
- },
- "optimization_goal": {
- "type": [
- "string",
- "null"
- ]
- },
- "primary_event_count": {
- "type": [
- "number",
- "null"
- ]
- },
- "primary_event_cpa_usd": {
- "type": [
- "number",
- "null"
- ]
- },
- "primary_event_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "product_type": {
- "type": [
- "string",
- "null"
- ]
- },
- "reach": {
- "type": [
- "number",
- "null"
- ]
- },
- "roas": {
- "type": [
- "number",
- "null"
- ]
- },
- "rollup": {
- "type": "string"
- },
- "source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "spend": {
- "type": [
- "number",
- "null"
- ]
- },
- "spend_usd": {
- "type": [
- "number",
- "null"
- ]
- },
- "status": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "meta": {
- "properties": {
- "cache_hit": {
- "type": "boolean"
- },
- "coalesced": {
- "type": "boolean"
- },
- "complete": {
- "type": "boolean"
- },
- "data_as_of_date": {
- "type": [
- "string",
- "null"
- ]
- },
- "data_freshness": {
- "properties": {
- "interval_min": {
- "type": "integer"
- },
- "label": {
- "type": "string"
- },
- "last_pull_failed_account_count": {
- "type": [
- "integer",
- "null"
- ]
- },
- "last_pull_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "last_pulled_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "max_staleness_min": {
- "type": "integer"
- },
- "server_now_utc": {
- "type": "string"
- },
- "staleness_seconds": {
- "type": [
- "integer",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "duration_ms": {
- "type": "integer"
- },
- "failed": {
- "type": "integer"
- },
- "freshness_warnings": {
- "items": {
- "properties": {
- "account_count": {
- "type": "integer"
- },
- "code": {
- "type": "string"
- },
- "dispersion_seconds": {
- "type": "integer"
- },
- "last_pull_failed_account_count": {
- "type": [
- "integer",
- "null"
- ]
- },
- "last_pull_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "message": {
- "type": "string"
- },
- "metrics_source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "newest_source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "observed_account_count": {
- "type": "integer"
- },
- "oldest_source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "has_more": {
- "type": "boolean"
- },
- "item_count": {
- "type": "integer"
- },
- "limitations": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "metrics_source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "missing_scopes": {
- "items": {
- "properties": {
- "index": {
- "type": "integer"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "index",
- "status"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "next_cursor": {
- "type": [
- "string",
- "null"
- ]
- },
- "page": {
- "type": "integer"
- },
- "page_size": {
- "type": "integer"
- },
- "refresh_reused": {
- "type": "boolean"
- },
- "returned_count": {
- "type": "integer"
- },
- "scope_count": {
- "type": "integer"
- },
- "source": {
- "type": "string"
- },
- "source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_row_count": {
- "type": "integer"
- },
- "source_truncated": {
- "type": "boolean"
- },
- "source_watermark": {
- "type": [
- "string",
- "null"
- ]
- },
- "succeeded": {
- "type": "integer"
- },
- "total_count": {
- "type": [
- "integer",
- "null"
- ]
- },
- "total_items": {
- "type": "integer"
- },
- "total_pages": {
- "type": "integer"
- }
- },
- "type": "object"
- },
- "rollup": {
- "type": "string"
- },
- "routing": {
- "properties": {
- "cache_coverage": {
- "properties": {
- "products": {
- "additionalProperties": {
- "properties": {
- "complete": {
- "type": "boolean"
- },
- "has_more": {
- "type": "boolean"
- },
- "limitations": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "next_cursor": {
- "type": [
- "string",
- "null"
- ]
- },
- "returned_count": {
- "type": "integer"
- },
- "source": {
- "type": "string"
- },
- "source_observed_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "source_watermark": {
- "type": [
- "string",
- "null"
- ]
- },
- "total_count": {
- "type": [
- "integer",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "object"
- },
- "status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "decision": {
- "type": "string"
- },
- "pull_breakdowns": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "quota": {
- "properties": {
- "available": {
- "type": "boolean"
- },
- "limit": {
- "type": [
- "integer",
- "null"
- ]
- },
- "operator_bypass": {
- "type": "boolean"
- },
- "remaining": {
- "type": "integer"
- },
- "used": {
- "type": "integer"
- }
- },
- "type": "object"
- },
- "reason": {
- "type": "string"
- },
- "recommended_next_tool": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "stored_row_count": {
- "type": [
- "integer",
- "null"
- ]
- },
- "totals": {
- "properties": {
- "clicks": {
- "type": [
- "number",
- "null"
- ]
- },
- "conversion_value": {
- "type": [
- "number",
- "null"
- ]
- },
- "conversions": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpa": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpc": {
- "type": [
- "number",
- "null"
- ]
- },
- "cpm": {
- "type": [
- "number",
- "null"
- ]
- },
- "ctr": {
- "type": [
- "number",
- "null"
- ]
- },
- "funnel": {
- "additionalProperties": {
- "type": "number"
- },
- "type": "object"
- },
- "impressions": {
- "type": [
- "number",
- "null"
- ]
- },
- "reach": {
- "type": [
- "number",
- "null"
- ]
- },
- "roas": {
- "type": [
- "number",
- "null"
- ]
- },
- "spend": {
- "type": [
- "number",
- "null"
- ]
- },
- "spend_usd": {
- "type": [
- "number",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "truncated": {
- "type": "boolean"
- }
- },
- "required": [
- "items",
- "count",
- "truncated",
- "rollup",
- "meta",
- "routing"
- ]
- },
- {
- "properties": {
- "expires_at": {
- "type": "string"
- },
- "message": {
- "type": "string"
- },
- "poll": {
- "properties": {
- "arguments": {
- "properties": {
- "product_ref": {
- "type": "string"
- },
- "task_ref": {
- "type": "string"
- },
- "template_name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "name": {
- "type": "string"
- },
- "tool": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "poll_after_ms": {
- "type": "integer"
- },
- "status": {
- "const": "queued"
- },
- "submitted_new": {
- "type": "boolean"
- },
- "task_ref": {
- "type": "string"
- },
- "task_status": {
- "type": "string"
- },
- "task_type": {
- "type": "string"
- }
- },
- "required": [
- "status",
- "task_ref",
- "task_status",
- "poll_after_ms",
- "expires_at",
- "poll"
- ]
- }
-]New value: +[
+ {
+ "properties": {
+ "cache_hint": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "recommended_next_tool": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "count": {
+ "type": "integer"
+ },
+ "dimension_row_count": {
+ "type": "integer"
+ },
+ "items": {
+ "items": {
+ "properties": {
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "bid_amount": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "bid_strategy": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "breakdown_key": {
+ "type": "string"
+ },
+ "breakdown_type": {
+ "type": "string"
+ },
+ "budget_level": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_row_count": {
+ "type": "integer"
+ },
+ "clicks": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "configured_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "conversion_value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "conversions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpa": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpc": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpc_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpm": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpm_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "ctr": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "data_as_of_date": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date_from": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date_start": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date_stop": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date_to": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "delivery_issue_codes": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "delivery_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "effective_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "entity_id": {
+ "type": "string"
+ },
+ "entity_name": {
+ "type": "string"
+ },
+ "event_metrics": {
+ "additionalProperties": {
+ "properties": {
+ "cost_usd": {
+ "type": "number"
+ },
+ "count": {
+ "type": "number"
+ },
+ "cvr_clicks": {
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "type": "object"
+ },
+ "funnel": {
+ "additionalProperties": {
+ "type": "number"
+ },
+ "type": "object"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "impressions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "level": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "lifetime_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "money_unit": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "optimization_goal": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "primary_event_count": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "primary_event_cpa_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "primary_event_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "product_type": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reach": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "roas": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "rollup": {
+ "type": "string"
+ },
+ "source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "spend": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "meta": {
+ "properties": {
+ "cache_hit": {
+ "type": "boolean"
+ },
+ "coalesced": {
+ "type": "boolean"
+ },
+ "complete": {
+ "type": "boolean"
+ },
+ "data_as_of_date": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "data_freshness": {
+ "properties": {
+ "interval_min": {
+ "type": "integer"
+ },
+ "label": {
+ "type": "string"
+ },
+ "last_pull_failed_account_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "last_pull_scope": {
+ "const": "workspace"
+ },
+ "last_pull_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "last_pulled_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "max_staleness_min": {
+ "type": "integer"
+ },
+ "server_now_utc": {
+ "type": "string"
+ },
+ "staleness_seconds": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "duration_ms": {
+ "type": "integer"
+ },
+ "failed": {
+ "type": "integer"
+ },
+ "freshness_warnings": {
+ "items": {
+ "properties": {
+ "account_count": {
+ "type": "integer"
+ },
+ "code": {
+ "type": "string"
+ },
+ "dispersion_seconds": {
+ "type": "integer"
+ },
+ "last_pull_failed_account_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "last_pull_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "message": {
+ "type": "string"
+ },
+ "metrics_source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "newest_source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "observed_account_count": {
+ "type": "integer"
+ },
+ "oldest_source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "has_more": {
+ "type": "boolean"
+ },
+ "item_count": {
+ "type": "integer"
+ },
+ "limitations": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "metrics_source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "missing_scopes": {
+ "items": {
+ "properties": {
+ "index": {
+ "type": "integer"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "index",
+ "status"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "next_cursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "page": {
+ "type": "integer"
+ },
+ "page_size": {
+ "type": "integer"
+ },
+ "refresh_reused": {
+ "type": "boolean"
+ },
+ "returned_count": {
+ "type": "integer"
+ },
+ "scope_count": {
+ "type": "integer"
+ },
+ "source": {
+ "type": "string"
+ },
+ "source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_row_count": {
+ "type": "integer"
+ },
+ "source_truncated": {
+ "type": "boolean"
+ },
+ "source_watermark": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "succeeded": {
+ "type": "integer"
+ },
+ "total_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total_items": {
+ "type": "integer"
+ },
+ "total_pages": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "rollup": {
+ "type": "string"
+ },
+ "routing": {
+ "properties": {
+ "cache_coverage": {
+ "properties": {
+ "products": {
+ "additionalProperties": {
+ "properties": {
+ "complete": {
+ "type": "boolean"
+ },
+ "has_more": {
+ "type": "boolean"
+ },
+ "limitations": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "next_cursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "returned_count": {
+ "type": "integer"
+ },
+ "source": {
+ "type": "string"
+ },
+ "source_observed_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source_watermark": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "total_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "object"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "decision": {
+ "type": "string"
+ },
+ "pull_breakdowns": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "quota": {
+ "properties": {
+ "available": {
+ "type": "boolean"
+ },
+ "limit": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "operator_bypass": {
+ "type": "boolean"
+ },
+ "remaining": {
+ "type": "integer"
+ },
+ "used": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "reason": {
+ "type": "string"
+ },
+ "recommended_next_tool": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "stored_row_count": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "totals": {
+ "properties": {
+ "clicks": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "conversion_value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "conversions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpa": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpc": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "cpm": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "ctr": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "funnel": {
+ "additionalProperties": {
+ "type": "number"
+ },
+ "type": "object"
+ },
+ "impressions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "reach": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "roas": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "truncated": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "items",
+ "count",
+ "truncated",
+ "rollup",
+ "meta",
+ "routing"
+ ]
+ },
+ {
+ "properties": {
+ "expires_at": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "poll": {
+ "properties": {
+ "arguments": {
+ "properties": {
+ "product_ref": {
+ "type": "string"
+ },
+ "task_ref": {
+ "type": "string"
+ },
+ "template_name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "name": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "poll_after_ms": {
+ "type": "integer"
+ },
+ "status": {
+ "const": "queued"
+ },
+ "submitted_new": {
+ "type": "boolean"
+ },
+ "task_ref": {
+ "type": "string"
+ },
+ "task_status": {
+ "type": "string"
+ },
+ "task_type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "task_ref",
+ "task_status",
+ "poll_after_ms",
+ "expires_at",
+ "poll"
+ ]
+ }
+]Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false, so no contradiction exists, but the description adds zero behavioral context. It does not mention pagination, date filtering, enum significance, or any operational caveats beyond what annotations already convey.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
'Read splits' is under-specification rather than effective conciseness. The description is too short to earn its place and provides no front-loaded information that helps an agent select or invoke the tool correctly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Even with an output schema and read-only annotations, the description is inadequate for an 11-parameter tool with optional fields and multiple enums. The output schema may describe returns, but it cannot compensate for missing domain context about how to construct a valid request.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With schema description coverage at 0% and 11 parameters, the description must compensate but does not. It gives no meaning to parameters like breakdown_type, rollup, ad_ids, or how they interact, leaving the agent entirely dependent on raw schema names.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Read splits' is a near-tautology of the tool name, since 'breakdowns' and 'splits' refer to the same concept. It does not state what is being split, which entity is involved, or how this differs from the many sibling insights_* tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance about when to use this tool versus alternatives like insights_pull_product_breakdowns, insights_query_overview, or insights_get_date_range. No preconditions, exclusions, or selection criteria are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.