Second-Generation Managed Packaging Developer Guide

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

Enable App Analytics on Your Second-Generation Managed Package

Activate AppExchange App Analytics on your second-generation (2GP) managed package to access AppExchange App Analytics package usage logs and subscriber snapshots. Package usage summaries are available by default.
Available in: Enterprise, Performance, Unlimited, and Developer Editions.

User Permissions Needed
To access packages and package versions: Read on Packages, Package Versions
To request and retrieve AppExchange App Analytics data: Create, Read, Edit, Delete, View All, and Modify All on the AppAnalyticsQueryRequest object

To ensure that you’re running the latest version of Salesforce CLI and its plug-ins, run sf update and sf plugins update.

  1. Activate App Analytics on your managed 2GP package. sf package update --package "Your Package Alias" --enable-app-analytics

    To deactivate App Analytics on your managed 2GP package, run this CLI command. sf package update --package "Your Package Alias" --no-enable-app-analytics

  2. For any additional package that you want App Analytics data for, repeat step 1.