Agent skill · forcedotcom
dx-app-analytics-query
ISV App Analytics metadata types — AppAnalyticsQueryRequest and AppAnalyticsSettings. Use this skill when the user asks about retrieving managed package usage data, configuring App Analytics simulation mode, querying subscriber snapshots, or understanding the AppAnalyticsQueryRequest lifecycle (New → Pending → Complete → Expired). TRIGGER when: user mentions App Analytics, AppAnalyticsQueryRequest, AppAnalyticsSettings, package usage data, subscriber analytics, ISV analytics, or simulation mode for app analytics. DO NOT TRIGGER when: the task is about standard Salesforce reports or dashboards (use platform-report-generate), custom CRM SOQL (use platform-soql-query), or Data Cloud query or search (use data360-query).
What it needs
About 4k tokens when loaded.
What this skill does
App Analytics When This Skill Owns the Task Use dx-app-analytics-query when the work involves: Creating AppAnalyticsQueryRequest records via the REST/sObject API Configuring AppAnalyticsSettings via the Metadata API (simulation mode, opt-out) Understanding the query lifecycle: New → Pending → Complete → Expired → Failed Choosing between dataType values: PackageUsageSummary, PackageUsageLog, SubscriberSnapshot File format and compression options for analytics downloads Time-range filtering with startTime, endTime, availableSince Troubleshooting failed or expired analytics queries Delegate elsewhere when the user is: Running standard CRM SOQL queries → platform-soql-query Working with Data Cloud SQL or DMOs → data360-query Building reports/dashboards on standard objects → platform-report-generate Deploying or retrieving generic metadata XML → platform-metadata-deploy / platform-metadata-retrieve --- Available Types AppAnalyticsQueryRequest (REST/sObject API) An asynchronous query request that ISV partners use to retrieve usage analytics data for their managed packages from the ISV Intelligence Data Lake. Records are created via POST /services/data/vXX.0/sobjects/AppAnalyticsQueryRequest and polled via GET /services/data/vXX.0/sobjects/AppAnalyticsQueryRequest/<id>. The system processes the query and provides a presigned download URL upon completion. Fields (14 properties): Field Type Description ------- ------ ------------- DataType string (filterable) Type of analytics data. Values: PackageUsageSummary, PackageUsageLog, SubscriberSnapshot RequestState string (filterable) Processing status. Values: New, Pending, Complete, Expired, Failed, NoData, Delivered StartTime string Start of time range for requested data EndTime string End of time range. Should be set on an hour boundary AvailableSince string Limits query to data indexed after this time (inclusive). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills forcedotcom/dx-app-analytics-query--aa4e1e