AppAnalyticsQueryRequest | Object Reference for Salesforce and Lightning Platform

AppExchange App Analytics is available for packages that have passed security review and are registered to a License Management App. 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. Once 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.
DownloadSize	Type int Properties Filter, Nillable, Sort Description The size of the AppExchange App Analytics results file available for download, in bytes.
DownloadUrl	Type url Properties , Nillable, Description URL from which the requested data can be downloaded. Populated once the request is completed.
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 In a 24-hour period, you can request a maximum of 7 days of log files. Note
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. Enter at least one package ID or one org ID, you can’t leave both fields blank. Note
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. To request data on all packages registered to this LMA, leave the field blank. Enter at least one package ID or one org ID, you can’t leave both fields blank. Note
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 In a 24-hour period, you can request a maximum of 7 days of log files. Note

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.

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

If requests to view data regarding packages 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.