## 5.1 Reporting Free Listings Performance (Impressions and Clicks)

### Introduction and Business Impact

*** ** * ** ***

Free Listing Performance reporting allows your merchants to view the number of
clicks and impressions that your products receive across the Shopping tab,
YouTube, the Shopping Knowledge Panel, and Popular Product. Learn more about
[where Google shows your free product listings](https://support.google.com/merchants/answer/9826670) and [how performance
reporting works in Merchant Center](https://support.google.com/merchants/answer/10265167).

### Tech Guidance

*** ** * ** ***

Use the [Reporting API](https://developers.google.com/shopping-content/guides/reports/overview) to retrieve [performance data](https://support.google.com/merchants/answer/10265167) for products and
programs in Merchant Center accounts.

Requests use the [Merchant Center Query Language](https://developers.google.com/shopping-content/guides/reports/query-language/overview), 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](https://developers.google.com/google-ads/api/docs/reporting/overview), 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`](https://developers.google.com/shopping-content/reference/rest/v2.1/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):

    https://shoppingcontent.googleapis.com/content/v2.1/merchantId/reports/search

For the full example, see the [Example in the Content API documentation](https://developers.google.com/shopping-content/guides/reports/example).
For more examples and information, see the following:

- Retrieve product [performance metrics](https://developers.google.com/shopping-content/guides/reports/metrics).
- Learn about [segmentation](https://developers.google.com/shopping-content/guides/reports/segmentation).
- Learn about [paging your data](https://developers.google.com/shopping-content/guides/reports/paging).
- Learn the syntax of the [Merchant Center Query Language](https://developers.google.com/shopping-content/guides/reports/query-language/overview).

> [!IMPORTANT]
> **Important:** Users need to have the *reporting manager* role enabled using the content API ([`Accountsuser`](https://developers.google.com/shopping-content/reference/rest/v2.1/accounts#accountuser)) or manually added through Merchant Center to see the data.

> [!TIP]
> **Tip:** You can cross check what you pull using the Reporting API with what you see in the Google Merchant Center platform. See [About performance reporting for
> free listings - Google Merchant Center Help](https://support.google.com/merchants/answer/9826542) for more information and troubleshooting advice.

See: [Track your product performance](https://support.google.com/merchants/answer/188492)