The Chrome Web Store offers integration with Google Analytics. This allows you to see analytics for
your Chrome Web Store listing in addition to the view offered in the Developer Dashboard.

To track usage of your extension, see [Using Google Analytics 4](https://developer.chrome.com/docs/extensions/mv3/tut_analytics).

## Opt-in to Google Analytics

When viewing your item in the [Developer Dashboard](https://chrome.google.com/webstore/devconsole/), find the Additional
metrics section on the Store listing page. Click "Opt in to Google Analytics".
![Opt in UI for Google Analytics in Developer Dashboard](https://developer.chrome.com/static/docs/webstore/google-analytics/image/opt-ui-google-analytics-607e706bd69c9.png) Opt in UI for Google Analytics in Developer Dashboard.

Then, head to <https://analytics.google.com/>. You should have access to a new property which
has been named with your extension ID.

## Limits

Some limits apply in your Google Analytics property. These include:

- Data retention is set to two months.
- Data de-identification is enabled, which limits access to non aggregated data to prevent tracking an individual user. For example, data may be withheld if it does not meet system-defined [thresholds](https://support.google.com/analytics/answer/9383630).
- Additional users can only be added by invitation to your publisher (see [below](https://developer.chrome.com/docs/webstore/google-analytics.md.txt#publisher)).

You will be granted access to the property with the [Marketer](https://support.google.com/analytics/answer/9305587#property)
role. This can't be changed.

## Page views

Each time a user visits your extension listing, you will see a page view for the following URL: `/webstore/detail/ext/free/EXTENSION_ID/EXTENSION_NAME`

## Events

The Chrome Web Store also sends a number of events to your property:

- [`page_view`](https://support.google.com/analytics/answer/9234069#page_view), [`session_start`](https://support.google.com/analytics/answer/9234069#session_start), [`first_visit`](https://support.google.com/analytics/answer/9234069#first_visit) and [`user_engagement`](https://support.google.com/analytics/answer/9234069#user_engagement)
- `install`: A [custom event](https://support.google.com/analytics/answer/12229021) sent when a user installs your extension. This is only sent if a user accepts the permission prompt to complete the install.

## Monitoring ad performance

### Using UTM parameters

A common use case for developers is monitoring advertising performance. In these cases, it is useful
to know which ads led to views of your item's store listing or which resulted in conversions.

You can use the `utm_source`, `utm_medium`, and `utm_campaign` parameters for this which are all
forwarded to Google Analytics. For example, an ad could direct users to the following URL:

[https://chrome.google.com/webstore/detail/action-api-demo/ljjhjaakmncibonnjpaoglbhcjeolhkk?utm_source=ad\&utm_medium=cpc\&utm_campaign=summer-ad-campaign](https://chrome.google.com/webstore/detail/action-api-demo/ljjhjaakmncibonnjpaoglbhcjeolhkk?utm_source=ad&utm_medium=cpc&utm_campaign=summer-ad-campaign)

You will see the following for the corresponding `page_view` and `install` events:

- Session source: `ad`
- Session medium: `cpc`
- Session campaign: `summer-ad-campaign`

If this is the first time the user has visited your extension listing the "first user
medium", "first user campaign", and "first user source" fields will also be set.

> [!NOTE]
> **Note:** It can take between 24 and 48 hours for data to be finalized. Before then, you may see events reported with a blank entry for these fields. This will be corrected as the data is finalized.

### Connecting to Google Ads or other services

It is not currently possible to link your Google Analytics property to other services like Google
Ads. We recommend periodically checking the data in Google Analytics to understand ad performance
and make decisions about how to optimize campaigns.

## Tracking conversions

The install event generated when a user installs your extension can be marked as a conversion event.
Go to **Admin** , then **Conversions** and choose **New Conversion Event** . Enter "install" and click **Save**. The
event will now appear as a Conversion across your Google Analytics dashboard.

## Giving other accounts access to Google Analytics

### Add additional members to your publisher

To give other Google Accounts access to your Google Analytics property, you can
[invite them to be members of your publisher](https://developer.chrome.com/docs/webstore/share-ownership.md.txt). The Viewer role
grants read-only access which is ideal for sharing analytics data.

### With Data Studio

Alternatively, you can use [Data Studio](https://lookerstudio.google.com/) to create a report based on your
Google Analytics data. This can be shared with any Google Account.

Simple choose "Create" and choose the type of file you would like to create. Use the Google
Analytics connector and add your property under the "Chrome Web Store developer properties" account.