SuperAPI AI 工具集

dx-app-analytics-use

数据与分析

查看项目

更新于 10-16 08:47

技能介绍

用途:处理 ISV 应用分析相关任务,包括通过 REST/sObject API 创建 AppAnalyticsQueryRequest、经 Metadata API 配置 AppAnalyticsSettings(模拟模式、退出采集)、理解查询生命周期、选择 dataType、文件格式与压缩、时间范围过滤,以及排查失败或过期查询。

主要能力:AppAnalyticsQueryRequest 是异步查询请求,用于从 ISV Intelligence Data Lake 获取托管包用量分析数据。通过 POST /services/data/vXX.0/sobjects/AppAnalyticsQueryRequest 创建,通过 GET /services/data/vXX.0/sobjects/AppAnalyticsQueryRequest/<id> 轮询,完成后提供预签名下载 URL。字段包含 DataType(PackageUsageSummary、PackageUsageLog、SubscriberSnapshot)、RequestState(New、Pending、Complete、Expired、Failed、NoData、Delivered)、StartTime、EndTime、AvailableSince、PackageIds、OrganizationIds、DownloadUrl、DownloadSize、DownloadExpirationTime、FileType(csv、parquet)、FileCompression(none、gzip、snappy)、QuerySubmittedTime、ErrorMessage。AppAnalyticsSettings 通过 Metadata API 或 Tooling API 部署,字段为 enableSimulationMode(启用后可用样本日志做集成测试)与 enableAppAnalyticsOptOut(订阅组织退出数据采集)。

使用方式:创建查询记录后轮询直至 RequestState 为 Complete,再从 DownloadUrl 下载;用 AvailableSince 设为上次成功查询完成时间做增量检索;测试时部署 AppAnalyticsSettings 并设 enableSimulationMode: true。

限制与注意:AppAnalyticsQueryRequest 是 sObject,须通过 REST Data API 而非 Metadata API XML 部署;不支持 Apex 触发器,也不经过自定义对象或 Flow;下载 URL 会过期,需先检查 DownloadExpirationTime;EndTime 应设在整点;AvailableSince 为包含式;PackageIds 使用 033 前缀 ID 而非 04t;数据处理为异步,无同步查询选项;大数据集建议 parquet 配合 snappy。

不适用场景:标准 CRM SOQL 查询、Data Cloud SQL 或 DMO、标准对象报表/仪表板、通用元数据部署或检索。