Download Package Usage Logs, Package Usage Summaries, and Subscriber Snapshots

To request package usage logs, monthly package usage summaries, and subscriber snapshots, use the AppAnalyticsQueryRequest object. Usage logs, usage summaries, and subscriber snapshots are downloadable comma-separated value (.csv) files.

To enable App Analytics on your second-generation (2GP) managed packages, follow these instructions. To enable App Analytics on your first-generation (1GP) managed packages, follow these instructions.

Then determine which team members need create, read, update, and delete (CRUD) access to the AppAnalyticsQueryRequest object, and consider creating a permission set for them. By default, admins have the permissions required to request package usage logs and usage summaries using the AppAnalyticsQueryRequest object.

In a 24-hour period, you can download up to 20 GB of AppExchange App Analytics data.

Package usage summary data is available to download for 10 years from the summary file log date. Package usage log data is available to download for 45 days from the date that the log event occurred. Subscriber snapshot data is available to download for 45 days from the snapshot date.

The usage data that AppExchange App Analytics collects depends on the org type and data type.

Table 1. Data Type Collection Varies by Org Type
Data Type Data is Collected on... Data isn’t Collected on...
PackageUsageLog Production, sandbox, and trial orgs Scratch orgs
PackageUsageSummary Production orgs Sandbox, scratch, and trial orgs
SubscriberSnapshot Production org and trial orgs Sandbox and scratch orgs

AppExchange App Analytics is subject to certain usage restrictions as described in AppExchange Program Policies.

Note

  1. Log in to the License Management Org (LMO) that the package is registered to.
  2. From the LMO, complete the required fields in the AppAnalyticsQueryRequest object.
  3. Retrieve the App Analytics Query Request object created in the API request. The DownloadURL field populates after the request is completed.
  4. Click the URL in the DownloadURL field in the App Analytics Query Request object, and download the .csv file.

    The download URL expires after 60 minutes.

    Note