google ads get shopping performance
google_ads_get_shopping_performanceRetrieve read-only Google Ads Shopping performance data by Merchant Center product dimensions to analyze spend and conversions across merchant, item, title, brand, and feed labels.
Instructions
Read-only Shopping performance report keyed by Merchant Center product dimensions. Useful for joining spend/conversions to merchant ID, item ID, title, brand, feed label, and custom labels.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"customerId": "<customerId>",
"startDate": "<startDate>",
"endDate": "<endDate>"
},
"name": "google_ads_get_shopping_performance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | No | Optional product brand filter | |
| limit | No | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. | |
| itemId | No | Optional Merchant Center item ID filter | |
| endDate | Yes | End date YYYY-MM-DD | |
| adGroupId | No | Optional ad group ID filter | |
| feedLabel | No | Optional product feed label filter | |
| startDate | Yes | Start date YYYY-MM-DD | |
| campaignId | No | Optional campaign ID filter | |
| customerId | Yes | Google Ads customer ID (without dashes, e.g., 1234567890) | |
| titleContains | No | Optional product title substring filter | |
| merchantCenterId | No | Optional Merchant Center ID filter |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |