Get Started with AgentExchange App Analytics | Second-Generation Managed Packaging Developer Guide

AgentExchange App Analytics provides usage data about how subscribers interact with your AgentExchange managed packages and packaged components. You can use these details to identify attrition risks, inform feature development decisions, and improve user experience.

AgentExchange App Analytics is subject to certain usage restrictions as described in the AgentExchange Program Policies. Usage data from Government Cloud and Government Cloud Plus orgs isn’t available in App Analytics.

Note

App Analytics is available for first- and second-generation (1GP and 2GP) managed packages that passed security review and are registered to a License Management App. Usage data is provided as package usage logs, monthly package usage summaries, or subscriber snapshots. All usage data is available as downloadable comma-separated value (.csv) files. To view the data in dashboard or visualization format, use CRM Analytics or a third-party analytics tool.

In a 24-hour period, you can download a maximum 20 GB of AgentExchange App Analytics data.

App Analytics Use Cases
To achieve your business objectives, use App Analytics across your teams. Read this guide to understand common use cases and how to map App Analytics data to sample product features.
Enable App Analytics on Your Second-Generation Managed Package
Activate AgentExchange App Analytics on your second-generation (2GP) managed package to access AgentExchange App Analytics package usage logs and subscriber snapshots. Package usage summaries are available by default.
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.
Considerations for Custom Interactions
Easily create and log custom interactions on your managed package using Apex. As subscribers interact with your package and your Apex code is executed, the custom interactions that you defined are logged. Retrieve your custom interactions in your package's AgentExchange App Analytics usage logs and usage summaries.
AgentExchange App Analytics Best Practices
To plan and maximize your AgentExchange App Analytics query strategy, follow our best practices. First, use file compression to reduce your data results file size. Second, schedule and automate your regular App Analytics queries. Third, plan, schedule, and automate catch-up queries to supplement your regular query data.
Package Usage Summaries
Package usage summaries provide high-level metrics by calendar month. Discover how many users access your package and which operations they perform.
Package Usage Logs
Analyze adoption and user behavior, then make informed feature development decisions based on data from package usage logs. AgentExchange App Analytics tracks UI, API-based, Lightning-based, and Apex operations, and it logs each CRUD operation on components and custom objects in packages. Events from sandbox and trial orgs are tracked in package usage logs. Events from scratch orgs aren’t tracked.
Subscriber Snapshots
Subscriber snapshots give you a point-in-time summary of subscriber activity. Use subscriber snapshots to see usage trends by org and package.
Test Custom Integrations
To test your custom integrations in a nonproduction environment, use AgentExchange App Analytics Simulation Mode. Submit an App Analytics query request and receive sample usage data.
AgentExchange App Analytics Developer Cookbook
Delve deeper into your AgentExchange App Analytics managed package usage data by creating key performance indicators (KPIs). First, complete some prerequisites and retrieve your App Analytics data. Next, prepare your CRM Analytics environment. Finally, to build your KPIs, complete App Analytics recipes.