Requests use the Merchant Center Query Language, which lets you select
performance metrics and segments that determine how the metrics are
summarized in the response, and additional filtering to select the date range
and other criteria. If you also use the reporting features of the Google Ads
API, you find that many of these concepts are similar.
For example, a common use case is to summarize the performance of your account
over the last 30 days segmented by program and offer_id. The following is the
query for this report:
SELECT
segments.program,
segments.offer_id,
metrics.impressions,
metrics.clicks,
metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'
To issue this request, pass the Merchant Center Query Language statement, shown
above, to the reports.search method.
The request consists of an HTTP POST to the Content API for Shopping server at
the following URL (substitute the merchant ID for merchantId):
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-03 UTC."],[[["\u003cp\u003eFree Listing Performance reporting enables merchants to monitor impressions and clicks of their products across Google surfaces like Shopping, YouTube, and Knowledge Panel.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the Reporting API and Merchant Center Query Language to access and analyze performance data for your products and programs.\u003c/p\u003e\n"],["\u003cp\u003eA common use case involves summarizing account performance over a period, segmented by program and offer ID, using specific queries.\u003c/p\u003e\n"],["\u003cp\u003eEnsure users have the "reporting manager" role for data access and cross-check API data with the Google Merchant Center platform for verification.\u003c/p\u003e\n"]]],["Merchants can access free listing performance data, including clicks and impressions, across Google platforms. This data is retrievable via the Reporting API using Merchant Center Query Language. Requests, sent as HTTP POSTs, allow users to filter and segment data (e.g., by program, offer ID, and date range). The `reports.search` method is used to issue queries. Access requires the *reporting manager* role. Results can be cross-checked with the Google Merchant Center platform.\n"],null,[]]