Measure performance

  • The Reports service allows you to retrieve performance metrics, such as impressions, clicks, and click-through rate (CTR), for your account.

  • To access this service, you must have the Reporting manager role (equivalent to the Performance and insights role in Merchant Center), which can be assigned using the accounts.update method.

  • A comprehensive list of available metrics can be found in the metrics documentation, and you can use Merchant Center Query Language to create customized reports.

  • For more detailed analysis, you can segment your metrics and further explore report functionalities through the provided guides on segmentation and products.

You can use the Reports service to retrieve performance metrics for your account.

See the metrics documentation for the complete list of available metrics.

Requirements

You need the Reporting manager role to retrieve this report.

To give an account the Reporting manager role, use accounts.update to set the reportingManager field to true. The Reporting manager role is equivalent to the Performance and insights role in Merchant Center.

accounts.update replaces the entire Account resource. Use accounts.get to get the full Account resource, then provide all fields in your accounts.update request so you don't lose information.

Sample query

The following query retrieves the impressions, clicks, and ctr for all products in your account during a specific 30-day period. To make the request, pass the following Merchant Center Query Language statement to the reports.search method:

SELECT
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'

Run

Click Run to try the sample in the API Explorer. After you click Run, update the merchant ID placeholder to your own merchant ID in the request URL. You can modify the query. The full query must remain on one line to work with the API explorer.

You can also segment the metrics in the query for more granular performance reports.

See the Products guide to learn how to retrieve and filter products with the Reports service.

Previous
Example
Next
Filter products