AppAnalyticsQueryRequest | Object Reference for Salesforce and Lightning Platform

AppExchange App Analytics is available for managed packages that have passed security review and are registered to a License Management App. Usage data is provided as log files or month-based usage summaries. Custom Object Usage Logs include Lightning apps and pages, and company information of subscribers who’ve downloaded your app. Both log files and monthly summaries 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: `CustomObjectUsageLog` `CustomObjectUsageSummary`
DownloadExpirationTime	Type dateTime Properties Filter, Nillable, Sort Description The time when the download URL is no longer valid.
DownloadUrl	Type url Properties Filter, Nillable, Sort 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 managed packaged is registered to, and initiate the API request from the LMO.

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

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