skills.rest
angryracoon
angryracoonCOMMUNITY
Explore all skills by this author →
GitHub

dx-app-analytics-query

Retrieve Salesforce managed package usage data via AppAnalyticsQueryRequest lifecycle.

Updated Jun 17, 2026
Search Tags:#salesforce#app analytics#managed packages#query requests#simulation mode#subscriber snapshots#metadata settings
One-click install
npx skills add https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG --skill dx-app-analytics-query
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dx-app-analytics-query
Source: https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG/tree/main/.agents/skills/dx-app-analytics-query
Command: npx skills add https://github.com/angryracoon/ARIEF-VISEO-DEV-ORG --skill dx-app-analytics-query

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about dx-app-analytics-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve Salesforce App Analytics data for a managed package?▼

Retrieve Salesforce App Analytics data by creating an AppAnalyticsQueryRequest via REST sObject API, polling the lifecycle status until Complete, and downloading the results. Specify your 033-prefixed package ID, time range, and output format.

What is the AppAnalyticsQueryRequest lifecycle and how do I track it?▼

The AppAnalyticsQueryRequest lifecycle transitions from New to Pending, Complete, Delivered, Expired, Failed, or NoData. Track these asynchronous analytics requests by polling the request status until the download URL becomes available.

How do I configure simulation mode for App Analytics in Salesforce?▼

Configure simulation mode for App Analytics by deploying AppAnalyticsSettings metadata or using the Tooling API. This enables testing and manages opt-out behavior before requesting actual managed package usage data.

What Salesforce App Analytics data types are available for managed package queries?▼

Available Salesforce App Analytics data types for managed packages include PackageUsageSummary, PackageUsageLog, and SubscriberSnapshot. Filter these queries using package IDs, organization IDs, time ranges, and incremental retrieval windows.

Why does my App Analytics download URL expire before I retrieve the file?▼

App Analytics download URLs expire after a set timeframe if not retrieved promptly. Handle download expiration by polling the AppAnalyticsQueryRequest status frequently and fetching the file immediately once the request reaches Complete status.

Do I need a specific package ID format for Salesforce App Analytics queries?▼

Yes, Salesforce App Analytics queries require a valid 033-prefixed package ID. You must also select the file format and compression type, and use hour-boundary end times when defining the time range for the analytics retrieval.

Related Skills

Explore More Data & Analytics Skills→
padjeipadjei

dx-app-analytics-query

Manage ISV App Analytics queries and metadata configurations via REST/sObject and Metadata APIs.

Community
Advanced
Hollis36Hollis36
1

pdf

Extract text and tables from PDFs using Python libraries.

Community
Intermediate
salesforce-miscsalesforce-misc
4

datakit-api-deploy

Automate Data360 Retail Data Kit deployment via Salesforce Connect REST API.

Official
Advanced
forcedotcomforcedotcom
803

graphql-data-access

Automate Salesforce GraphQL data access with codegen tooling and the UI API.

Official
Intermediate