AppAnalyticsQueryRequest | Object Reference for Salesforce and Lightning Platform

AppExchange App Analytics is available for packages that passed security review and are registered to a License Management App (LMA). Usage data is provided as log files, as month-based usage summaries, or as point-in-time subscriber snapshots. Log files, monthly summaries, and subscriber snapshots are downloadable comma-separated value (.csv) files.

Supported Calls

create(), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert()

Special Access Rules

See Request AppExchange App Analytics in the ISVforce Guide.

Fields

Field Name	Details
DataType	Type picklist Properties Create, Filter, Group, Restricted picklist, Sort Description The type of usage data being requested. Valid values include: `PackageUsageLog` `PackageUsageSummary` `SubscriberSnapshot` In Summer ’20, we changed the enum names from `CustomObjectUsageSummary` and `CustomObjectUsageLog` to `PackageUsageSummary` and `PackageUsageLog`. If you wrote integrations using `CustomObjectUsageSummary` or `CustomObjectUsageLog`, they continue to work only with v47 and earlier. After you upgrade to v48, you must update the `DataType` to `PackageUsageSummary` and `PackageUsageLog`. Note
DownloadExpirationTime	Type dateTime Properties Filter, Nillable, Sort Description The time when the download URL is no longer valid. The expiration time is 60 minutes after the query is completed.
DownloadSize	Type long Properties Filter, Group, Nillable, Sort Description The size of the AppExchange App Analytics results file available for download, in bytes.
DownloadUrl	Type textarea Properties Nillable Description URL that the user can download data from. Populated after the request is completed. This URL expires and is removed after the expiration time is reached.
EndTime	Type dateTime Properties Create, Filter, Nillable, Sort Description Enter end time in format yyyy-MM-ddTHH:mm:ss. Example: 2019-04-15T12:00:00
ErrorMessage	Type string Properties Filter, Group, Nillable, Sort Description Stores error message text that results from this query.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed a record related to this record.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed this record. If this value is null, it’s possible that this record was referenced (LastReferencedDate) and not viewed.
Name	Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description The auto-generated name of the App Analytics query request.
OrganizationIds	Type string Properties Create, Filter, Group, Nillable, Sort Description Optional. Enter up to 16 comma-separated org IDs without spaces between IDs. Or enter up to 15 comma-separated org IDs with spaces between the IDs. To request data for all the orgs the package is installed in, leave the field blank.
PackageIds	Type string Properties Create, Filter, Group, Nillable, Sort Description Optional. Enter up to 16 comma-separated package IDs without spaces between IDs. Or enter up to 15 comma-separated package IDs with spaces between the IDs. Use the subscriber package ID that begins with `033`. To retrieve a list of your second-generation managed package IDs, run `sfdx force:package:list --verbose` in Salesforce CLI. To request data on all packages registered to this License Management App, leave the field blank.
RequestState	Type picklist Properties Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort Description Status of the query request. Valid values are: `New` `Pending` `Complete` `Expired` `Failed` `NoData`
StartTime	Type dateTime Properties Create, Filter, Sort Description Required. Enter start time in format yyyy-MM-ddTHH:mm:ss. Example: 2019-04-14T12:00:00

Usage

To request usage data, log into the License Management Org (LMO) that your package is registered to, and initiate the API request from the LMO. In a 24-hour period, you can download a maximum 20 GB of AppExchange App Analytics data.

See Download Package Log Files, Usage Summaries, and Subscriber Snapshots in the ISVforce Guide.

If requests to view package data are inactive for 90 days, we stop collecting the log file data. To resume data collection for package log files, Request AppExchange App Analytics in the Partner Community.