SuperAPI AI 工具集

dx-app-analytics-query

数据与分析

查看项目

更新于 10-15 21:43

技能介绍

用途:该技能面向 Salesforce ISV 合作伙伴,用于从 ISV Intelligence Data Lake 检索托管包的使用分析数据,并配置相关设置。

主要能力:

  1. AppAnalyticsQueryRequest(REST/sObject API):通过 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(033 前缀)、OrganizationIds、DownloadUrl、DownloadSize、DownloadExpirationTime、FileType(csv、parquet)、FileCompression(none、gzip、snappy)、QuerySubmittedTime、ErrorMessage。
  2. AppAnalyticsSettings(Metadata API):通过 sf project deploy 或 Tooling API 部署,字段 enableSimulationMode(模拟模式,用于集成测试)与 enableAppAnalyticsOptOut(订阅组织退出数据采集)。

使用方式:创建查询记录后轮询直至 Complete,再在 DownloadExpirationTime 前从 DownloadUrl 下载。增量检索可将 AvailableSince 设为上次成功查询完成时间。测试时可启用模拟模式查询样本数据。

适用场景:托管包使用情况分析、订阅者快照、增量数据拉取、查询失败或过期排查。

限制:AppAnalyticsQueryRequest 是 sObject,须经 REST Data API 创建与轮询,不能通过 Metadata API XML 部署;无 Apex 触发器,不经过自定义对象或 Flow;无同步查询选项;下载 URL 会过期;EndTime 应设在整点;AvailableSince 为包含边界;PackageIds 使用 033 前缀而非 04t。大数据集建议 parquet 加 snappy。标准 CRM SOQL、Data Cloud、报表及通用元数据部署应转交其他技能。