Second-Generation Managed Packaging Developer Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
Second-Generation Managed Packages
What’s a Second-Generation Managed Package?
Set Up Your Development Environment
Before You Create Second-Generation Managed Packages
Scratch Orgs and Package Development
Workflow for Second-Generation Managed Packages
Components Available in Second-Generation Managed Packages
Behavior of Specific Metadata in Second-Generation Managed Packages
Develop Second-Generation Managed Packages
Install and Uninstall Second-Generation Managed Packages
Prepare to Distribute Your Second-Generation Managed Package
Push a Package Upgrade for Second-Generation Managed Packages
Advanced Features for Second-Generation Managed Packages
Best Practices for Second-Generation Managed Packages
Manage Licenses for Managed Packages
Manage Features in Second-Generation Managed Packages
Get Started with AppExchange App Analytics
App Analytics Use Cases
Enable App Analytics on Your Second-Generation Managed Package
Download Package Usage Logs, Package Usage Summaries, and Subscriber Snapshots
Considerations for Custom Interactions
AppExchange App Analytics Best Practices
Package Usage Summaries
Package Usage Logs
Subscriber Snapshots
Test Custom Integrations
AppExchange App Analytics Developer Cookbook
Gaps Between First-Generation and Second-Generation Managed Packaging
PDF

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