App Store Connect“分析”帮助

支持 / App Store Connect“分析” / 概述 / Analytics Reports API

概述

Analytics Reports API

概述

通过 Analytics Reports API(分析报告 API),你可以批量导出 App Store Connect 中的分析数据,方便离线分析 App Store 表现情况,并将其整合至自己的数据系统中。

详细了解分析报告。

分析报告以最为详尽的方式提供 App Store Connect 中的数据,同时兼顾用户隐私保护。这些报告可用于自定义分析、制作报表和实现流程自动化。

  • 数据格式:报告以制表符分隔的压缩文本文件(.txt.gz)交付,大多数数据处理工具都可直接读取此标准格式。

  • 访问和职能:具备相应职能且有 App Store Connect API 密钥的用户才可获取报告。只有具备“管理”职能的用户才可申请新的分析报告类型;申请了报告类型之后,“Sales and Reports(销售和报告)”或“财务”用户就可以使用 API 密钥下载生成的报告。

  • 初始设置:你可以执行两种类型的请求:ONGOING 请求会定期(每日、每周和每月)生成报告,而 ONE_TIME_SNAPSHOT 请求会提供所有可用历史数据。你会在执行 ONGOING 报告请求后约 24 至 48 小时内收到第一份报告。

  • 数据完整性:在报告日期的 2 天后,系统才能提供指定日期的完整数据。进一步了解数据完整性。

可用的报告类别

分析报告分为多个类别,分别关注 App 周期的不同部分。

App Store 互动

此类报告用于了解用户如何在 App Store 上发现你的 App 并与之互动。

  • App Store 发现和互动报告

    产品页面、商店表单和 App 内活动的展示次数、页面浏览次数和轻点次数的详细数据,包括活动类型、页面类型、来源类型等维度,以及汇总计数。

  • App Store 网页预览报告

    用户在网页上如何与 App 产品页面和 App 内活动互动。

App Store 商务

此类报告关注下载、预购和购买的数据。

  • App Store 下载报告

    App 在 App Store 中被下载的频率。

  • App Store 预购报告

    用户预购 App 和取消预购的详细信息。

  • App Store 购买报告

    收入和购买数据,包括购买类型、内容名称、销售额、所得、付费用户数,以及下载来源归因。

  • 订阅事件

    关于订阅周期变化的详细信息,包括优惠生效、优惠续期、从优惠订阅转为付费订阅、付费续期、自愿与非自愿流失的次数等。支持将订阅事件归因至下载来源。

  • 订阅状态

    关于 App Store 上有效和流失订阅数的详细信息,包括付费订阅、免费试用、付费优惠的总数和遇到账单问题的订阅数等。支持将订阅状态归因至下载来源。

【注】以上报告将代替旧有的“销售和趋势”订阅报告,在保护隐私的同时,轻松关联下载与订阅结果。

App 使用情况

此类报告有助于了解用户在下载 App 后如何与之互动。所收集的 App 使用数据均来自同意共享诊断和使用信息的用户。

隐私和数据可用性

分析报告始终以保护用户隐私为原则,通过增强隐私保护的技术汇总与处理数据,以防识别出个人身份信息。标准报告会省略容易识别出个人用户的字段,而包含更多字段的详细报告还采用了额外的安全保护措施,例如通过设定门槛阈值,剔除数据来源少于 5 位用户或 5 台独立设备的报告行。部分使用情况报告在未达到最低数据门槛时不会生成,这意味着数据量较低的活动或新功能可能不会显示数据。此外,系统会向指标添加少量统计噪声,避免通过数据识别出特定用户身份的可能性,同时保持整体数据的准确性。