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
In the Google API Console, go to Menu
> APIs & Services > Google Workspace Marketplace SDK.Click the Analytics tab.
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
- 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. Requireseditor
access to your app's Google Cloud project. In the Google API Console, go to Menu
> APIs & Services > Google Workspace Marketplace SDK.Click the Analytics tab.
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
In the Google API Console, go to Menu
> APIs & Services > Google Workspace Marketplace SDK.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.