Get analytics about app usage

You can get app listing, user, and installation metrics from Google Analytics and the Google Workspace Marketplace SDK.

Get app listing analytics from Google Analytics

To monitor how users interact with your app listing with Google Analytics, you must opt-in to Google Analytics 4. Then you can give other users access and review app listing analytics.

Opt-in to Google Analytics 4

  1. In the Google API Console, go to Menu > APIs & Services > Google Workspace Marketplace SDK.

    Go to the Google Workspace Marketplace SDK page

  2. Click the Analytics tab.

  3. To view additional metrics, click Opt-in to Google Analytics.

After you opt-in, the opt-in button is replaced with Google Analytics tools.

Give users access to Google Analytics data

  1. In your app's Google Cloud project, opt-in to get marketer access to the Google-owned Analytics 4 property. For instructions, see Access and data-restriction management. Requires editor access to your app's Google Cloud project.
  2. In the Google API Console, go to Menu > APIs & Services > Google Workspace Marketplace SDK.

    Go to the Google Workspace Marketplace SDK page

  3. Click the Analytics tab.

  4. In the Google Analytics section, enter the users you want to have marketer access to your app listing data.

Find app metrics in Google Analytics

Google Analytics includes the following information:

  • How many visitors have viewed your app listing for a specific time period. A visit is only counted if the visitor clicks on your app listing to view the details.
  • The geographic distribution of visitors.
  • How visitors reach your app listing, for example, from a Google Search.
  • The average time spent viewing your app listing.
  • Install events that are created when users start and finish installing your app. These events let you determine how often an install process was aborted and how many installs were completed over time.

To find install information in Google Analytics, search using the following event information:

Install events
When an install of the application is started. category=workspace_MARKETPLACE
action=START_INSTALL
When an install of the application is completed. category=workspace_MARKETPLACE
action=FINISH_INSTALL

To see how individual marketing campaigns drive app listing impressions and installs, you can add utm parameters to the app listing URL.

Get app listing analytics in the Google Workspace Marketplace SDK

  1. In the Google API Console, go to Menu > APIs & Services > Google Workspace Marketplace SDK.

    Go to the Google Workspace Marketplace SDK page

  2. Click the Analytics tab.

The following information is available:

Data type Description
Domain installs The number of domains that have installed your app. For example, if the administrator of altostrat.com installs your app for 500 users and the administrator of examplepetstore.com installs your app for 30 users, the domain installs count is 2 domains.
Seat installs The number of users that have your app installed and enabled. For example, if the administrator for altostrat.com installs your app for 500 users and the administrator for examplepetstore.com installs your app for 30 users, the seat installs count is 530 seats.
Individual end user installs The number of users that have directly installed your app. The individual end user installs count doesn't include installs made by domain administrators. For example, if the administrator for altostrat.com installs your app for 500 users and 25 individual users from examplepetstore.com install your app, the individual end user installs count is 25.

Connect usage info with your licensing or billing server

Your app might communicate with a licensing or billing server that manages monetization or usage. The Google Workspace Marketplace API—called from your license server, not from your app—can help with this level of administration.

The Google Workspace Marketplace API lets you determine what domains have installed or uninstalled your app. Use the API's LicenseNotification collection to get the activity for your app:

  • Provision events represent installations of your app on a domain.
  • Delete events represent removals of your app from a domain.

Refer to the Google Workspace Marketplace API Reference for more details.