BrightLake

设置自归因数据回传

如果你的应用集成 Apple AdServices · 在新标签页打开，且团队将直接提供归因数据，请选择此方式。

  • 4 个步骤
  • 简体中文 / English
  • 阅读无需登录 BrightLake
开始设置查看官方指引 ↗ · 在新标签页打开

如果从表单打开此指引，请返回原标签页继续，以保留尚未保存的修改。

4 个步骤

设置步骤

开始前准备

适用于能在相应平台修改设置的人员。

谁来操作

你的开发团队确认 AdServices 集成；运营协调聚合 CSV 交接和报表核验。

需要准备什么

  • iOS 应用已集成 AdServices，能获取 Apple Ads 归因结果。
  • 已约定聚合 CSV 交付方式，事件和美元收入数据按要求分开。
AdServices 归因数据流程你的应用请求归因令牌Apple 返回归因数据你的后端处理响应共享约定的事件与报表运营核对配置与数据
本图仅说明配置流程，不代表授权已通过、集成已生效或已收到数据。

  1. 确认 AdServices 集成

    检查 iOS 应用已集成 AdServices，能够获取 Apple Ads 归因结果。确认项仅记录此设置，不会运行或自动核验你的应用。

  2. 安排报表交付

    当前支持由运营协助导入聚合 CSV。选择 API 回传仅记录需求，不代表已有客户回传端点。

  3. 准备报表字段

    请按公开自归因指引准备 cohort 日期、广告活动映射和累计事件或美元收入列。AdServices 本身不提供应用内事件或收入。

  4. 对齐时区和事件定义

    用于效果考核前，请与运营确认时区、字段定义、交付频率、自有系统中的准确事件名，以及已有的交付安排。

确认完成与下一步

需要核对什么

  • 群组日期、广告系列映射、事件或美元收入字段和时区均已确认。
  • 运营核对导入行和报表值；仅凭导入回执不能证明数据可用。

接下来做什么

联系 BrightLake 协调数据交付并核验结果。阅读指南不会创建集成或提交申请。

告知 BrightLake

自归因报表接入

当前支持由运营协助导入聚合报表。请准备报表，并与对接团队安排导入。目前没有已文档化的客户自动事件回传端点，选择 API 回传仅表示提出需求，不代表集成已生效。

CSV 表头模板

下载文件仅含表头，不含客户数据。请先使用获授权的测试导出，将 signup_completed 替换为准确事件名，并确认统计窗口。事件和收入使用独立文件。

单个事件，累计到第 7 日偏移

Cohort Day,Campaign Id,signup_completed - count - day 7
下载事件表头模板

美元收入，第 0、2、6 日偏移

Cohort Day,Campaign Id,Users,revenue - sum - day 0,revenue - sum - day 2,revenue - sum - day 6
下载收入表头模板

1. 准备支持的文件

使用不带字节顺序标记（BOM）的 UTF-8 CSV，首行为表头，文件不超过 50 MB。事件导入需使用 CSV，便于运营选择识别到的日列。后端可读取 XLSX 的第一个工作表，但当前事件导入界面无法识别其日列。数字使用普通数值，日期使用 YYYY-MM-DD。

2. 对齐应用与广告账户

Cohort Day（或 date）为安装 cohort 日期。每行需要有效日期和 Campaign Id；只有广告活动名称在所选账户内唯一时，才可使用 Campaign name 替代。系统根据已有 Apple Ads 广告活动映射确定应用，不读取应用列。请一次准备一个应用/广告账户范围，并由团队核对映射。未知或属于其他账户的广告活动会被跳过；没有任何匹配时导入失败。

3. 保持单一汇总层级

可选表头包括 Users（也接受 Install、Installs）、Adset Id（也接受 Ad Set Id）、Adgroup name（也接受 Ad Group Name、Adset name）和 Keywords。请提供累计聚合值，而非逐用户事件。空数字单元格会变为零，重复匹配行会相加。不要混合总计及其明细，也不要包含个人或设备标识、广告成本和计算后的比率。未知列不会改变目标应用或币种。

4. 一个准确事件对应一个约定窗口

事件列表头使用准确格式：event_name - count - day N。可加后缀 - partial，但不代表数据已成熟。每个文件只放一类事件，不混合不同事件，也不混合事件和收入列。运营选择文件中存在的日列。day 7 表示累计到第 7 日偏移。同一应用/广告账户的同名事件共用一个指标槽位；改变所选日会修改该指标窗口，不会新增并行窗口。请保持约定窗口不变，事件说明写在开通表单或交接资料中，不要改写事件名。

5. 将收入导出为美元

导入固定写入 USD，不执行汇率换算。不要提供非美元金额，也不要依赖币种列转换。收入表头使用 revenue - sum - day N。第 0、2、6、13、29 日偏移分别对应 t0、t3、t7、t14、t30 收入窗口；事件第 7 日偏移不等于收入 t7（第 6 日偏移）。汇总 revenue 列只写总额，不填充所有日窗口。最大的收入日列提供累计 cohort 值。

6. 导出前确认时区

团队可将导入标记为 ORTZ（Apple Ads 账户报告时区）、UTC 或 BJ（Asia/Shanghai）。cohort 日期和总数必须已按此时区计算。导入不会转换时间戳或重新划分自然日，核对时需使用相同 cohort 日期、时区和统计窗口。

7. 了解修正与重复数据

每次上传都会创建新导入，不按文件内容去重。重新导入匹配行会更新其值，但未包含的旧行不会删除。同一文件内的重复行会相加。请记录文件、范围、统计窗口和回执，由团队核对修正内容后再重试。不要通过改变事件窗口来创建另一指标。

8. 安排运营导入

请使用与对接团队约定的安全交接渠道。有权限的运营在 Admin 导入页选择关联客户、Apple Ads 广告账户和时区，再选择 AppsFlyer 格式适配器、收入或事件指标模式、日窗口和文件。适配器只说明文件格式，不代表你使用 AppsFlyer，也不需要创建 Adjust 集成。运营需具备导入权限；不要分享应用登录凭证或内部服务密钥。

9. 核验结果，而非仅看回执

先用已知广告活动和日期的一小份获授权测试导出。运营检查任务状态和导入历史，按相同应用、账户、cohort 日期及时区比对写入行和总数。排队中仅代表已接收处理，不代表数据可用。Admin 已完成的任务仍可能包含部分导入，需检查未匹配广告活动及写入行数、修正被拒映射、确认准确事件指标和窗口，再读回报表值。通过一次受控修正验证更新行为。商务批准和 Performance 就绪检查仍须满足。

自动 API 回传需要独立集成

客户回传 URL 需要已部署的版本化采集路由、应用/租户范围的凭证与权限，以及明确的数据格式和应用/账户映射。还需 cohort、时区、窗口、金额和币种规则，持久回执和错误协议，以及经过验证的幂等、重放和修正行为。团队需证明从数据产生、存储到报表读回的完整链路。内部导入 API 和设计草案不是客户端点，请联系对接团队评估此依赖，不要向猜测的 postback 地址发送数据。

本指南描述当前聚合文件导入实现，不证明平台授权、客户数据、自动采集或生产集成已经验收。

其他接入指引

全部指引

需要帮助？

设置中遇到问题，随时联系 BrightLake 团队。

联系我们访问官网