Use your Google Analytics account with the Chrome Web Store

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

To track usage of your extension, seeUsing Google Analytics 4.

Opt-in to Google Analytics

When viewing your item in theDeveloper Dashboard, find the Additionalmetrics section on the Store listing page. Click "Opt in to Google Analytics".

Opt in UI for Google Analytics in Developer Dashboard
Opt in UI for Google Analytics in Developer Dashboard.

Then, head tohttps://analytics.google.com/. You should have access to a new property whichhas 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 trackingan individual user. For example, data may be withheld if it does not meet system-definedthresholds.
  • Additional users can only be added by syncing with a Group Publisher (seebelow).

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:

Monitoring ad performance

Using UTM parameters

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

You can use theutm_source,utm_medium, andutm_campaign parameters for this which are allforwarded 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

You will see the following for the correspondingpage_view andinstall 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 usermedium", "first user campaign", and "first user source" fields will also be set.

Note: It can take between 24 and 48 hours for data to be finalized. Before then, you may see eventsreported 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 GoogleAds. We recommend periodically checking the data in Google Analytics to understand ad performanceand 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 toAdmin, thenConversions and chooseNew Conversion Event. Enter "install" and clickSave. Theevent will now appear as a Conversion across your Google Analytics dashboard.

Giving other accounts access to Google Analytics

Using a Group Publisher

To give other Google accounts access to your Google Analytics property, set up aGroup Publisher. Members of this group will be automatically granted access tothe Google Analytics property. Note that granting access to the linked group means those users canact on behalf of the publisher account. This means they can access the Developer Dashboard and editand publish updates to your extensions. Consequently, access should be shared sparingly.

With Looker Studio

Alternatively, you can useLooker Studio to create a report based on yourGoogle Analytics data. This can be easily shared with any Google account.

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

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2023-08-02 UTC.