meta_join_product_insights

Query product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available.

ParametersLink to this section

Name	Type	Required	Notes
`adAccountId`	string	Required	Ad account ID (e.g., act_123456789)
`catalogId`	string	Optional	Product Catalog ID used to load product metadata for joins.
`productBreakdown`	string	Optional	One of: `product_id`, `product_brand_breakdown`, `product_category_breakdown`, `product_type_breakdown`, `product_custom_label_0_breakdown`, `product_custom_label_1_breakdown`, `product_custom_label_2_breakdown`, `product_custom_label_3_breakdown`, `product_custom_label_4_breakdown`, `product_group_content_id_breakdown`. Default: `"product_id"`.
`metrics`	array	Optional	Default: `["impressions","clicks","spend","actions","action_values"]`.
`level`	string	Optional	One of: `account`, `campaign`, `adset`, `ad`. Default: `"ad"`.
`datePreset`	string	Optional	Insights date preset. Defaults to last_30d. One of: `today`, `yesterday`, `this_month`, `last_month`, `this_quarter`, `maximum`, `data_maximum`, `last_3d`, `last_7d`, `last_14d`, `last_28d`, `last_30d`, `last_90d`, `last_week_mon_sun`, `last_week_sun_sat`, `last_quarter`, `last_year`, `this_week_mon_today`, `this_week_sun_today`, `this_year`.
`timeRange`	object	Optional	Optional custom insights date range.
`limit`	integer	Optional	Default: `500`.
`catalogProductLimit`	integer	Optional	Default: `500`.

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "meta_join_product_insights",
    "args": {
      "adAccountId": "<string>"
    }
  }
}