dx-app-analytics-query

What problem does it solve?

This Skill helps you retrieve and manage Salesforce ISV App Analytics data without guessing the right API, metadata setting, or query lifecycle step. It is designed for partner teams that need managed package usage visibility, subscriber snapshot access, and reliable analytics downloads.

Core Features & Use Cases

• AppAnalyticsQueryRequest lifecycle: Create, poll, and interpret asynchronous analytics requests from New to Pending, Complete, Delivered, Expired, Failed, or NoData.
• AppAnalyticsSettings configuration: Configure simulation mode for testing and opt-out behavior through metadata deployment or Tooling API workflows.
• Query planning and filtering: Work with PackageUsageSummary, PackageUsageLog, and SubscriberSnapshot data using package IDs, organization IDs, time ranges, and incremental retrieval windows.
• Troubleshooting and operational guidance: Handle download expiration, file format and compression selection, hour-boundary end times, and failed request diagnostics.
• Use case: A partner analytics team can request last-week usage summaries for a managed package, wait for completion, and download the results for reporting or customer analysis.

Quick Start

Ask for an App Analytics query for your managed package, specify the time range and output format, and then poll the request until the download URL becomes available.