Meta Ads 对接
在 adstage 中，可以收集 Meta Ads（Facebook、Instagram）上投放中的广告系列的费用数据，也可以对接把 adstage 收集到的转化事件回传给 Meta 的转化 API（CAPI）。Meta Ads 对接由 渠道对接、费用对接、转化 API 三个标签页构成。
1. 对接概述
在 adstage 仪表板 对接 > 广告渠道对接 > Meta Ads 中设置以下项目。
| 标签页 | 作用 |
|---|---|
渠道对接 | 登记解密 Android Install Referrer 所需的 Facebook App ID 与解密密钥。 |
费用对接 | 通过 OAuth 连接 Meta 广告账户，收集广告系列的费用数据。 |
转化 API | 将 adstage 收集到的事件通过 Meta Conversions API（CAPI）从服务器端发送。 |
2. 进行费用对接
在 费用对接 标签页中连接 Meta 广告账户后，即可在 adstage 仪表板中确认 Meta Ads 上投放中的广告系列的费用数据。
使用 Meta 账户对接
采用 Meta Business 登录（OAuth）方式进行安全认证。
-
在
费用对接标签页中启用费用数据收集开关。 -
点击
添加对接账户按钮。Facebook 商务登录窗口会以新窗口打开。 -
使用 Meta 账户登录，并批准 adstage 访问广告数据的权限。
对接前的准备
要进行费用对接，需要 Meta 商务管理平台（Business Manager）的访问权限，以及相应广告账户的管理员权限。
选择广告账户
认证完成后，会显示该 Meta 账户可访问的广告账户列表。
-
选择一个以上要对接的广告账户。列表会显示账户名称、广告账户 ID（Ad Account ID）、商务管理平台（Business Manager）信息，请据此确认是否为正确的账户。
-
可以按账户名称或 ID 搜索列表，也可以用
全选一次性全部选中。 -
确认已选账户数量后确定对接，相应广告账户即与 adstage 完成对接。
请注意
已登记过的广告账户会被排除在对接之外。若所选账户全部已登记，则不会进行对接。
管理对接账户
已对接的广告账户可在 费用对接 标签页的账户列表中通过以下信息确认。
| 项目 | 说明 |
|---|---|
广告账户 | Meta 广告账户名称与广告账户 ID（Ad Account ID） |
状态 | 费用对接状态（准备中、成功、失败） |
最后数据更新 | 最近一次数据收集的时间 |
Facebook 账户 | 对接时所用的 Meta 账户邮箱或名称 |
管理 | 解除账户对接（删除） |
要解除对接，请在账户列表中点击该账户的删除按钮，然后在确认消息中选择 删除。
请注意
删除账户后，该账户的数据收集将会中断。已收集的历史数据仍保留在 adstage 中，但不会再收集新数据。
收集的数据
费用数据按以下方式收集。
| 项目 | 说明 |
|---|---|
| 收集周期 | 每 4 小时自动收集 |
| 数据层级 | 广告系列、广告组（Ad Set）、广告（Ad）层级的明细数据 |
| 收集指标 | 费用等各广告系列的成效数据 |
3. 进行转化 API（CAPI）对接
在 转化 API 标签页中对接 Meta Conversions API（CAPI）后，即使不在应用中安装 Facebook SDK，也能把 adstage 收集到的事件从服务器端发送给 Meta。即使在 iOS ATT 环境下，也可通过服务器端发送提升归因准确度。
输入 Pixel ID
在 Meta 事件管理工具（Events Manager） 中确认 Pixel ID 后输入。
- 查看路径：事件管理工具 → 数据源 → 选择 Pixel → 设置 → Pixel ID
输入访问令牌
在事件管理工具中生成转化 API 专用的访问令牌后输入。
- 生成路径：事件管理工具 → 数据源 → 选择 Pixel → 设置 → Conversions API → 生成访问令牌
访问令牌会加密保存
保存的访问令牌会被加密并安全保管，保存后不会再次显示。如需更改，请重新输入新令牌。
测试事件代码（可选）
若想在不影响正式报告的前提下验证事件，可设置测试事件代码。切换到正式模式时，请清空代码并重新保存。
- 查看路径：事件管理工具 → 测试事件（Test Events）标签页 → 确认测试代码
连接测试与事件转发设置
保存 Pixel ID 与访问令牌后，即可使用以下功能。
| 项目 | 说明 |
|---|---|
连接测试 | 发送测试事件，确认 CAPI 设置是否正常工作。 |
事件转发设置 | 可按收集到的各个事件开启或关闭向 Meta 的发送，并映射每个 adstage 事件要以哪个 Meta 事件发送。 |
事件转发设置中只会显示实际已收集到的事件。若尚无已收集的事件，则会在应用有数据进入之后出现在列表中。
CAPI 的工作方式
- 用户邮箱与电话号码在发送给 Meta 之前会经过 SHA256 哈希处理。
- 自动应用基于 event_id 的去重，防止与浏览器 Pixel 的重复统计。
- 通过服务器端事件发送绕开 iOS ATT 限制，从而提升归因准确度。
4. 进行渠道对接
渠道对接 标签页用于登记解密 Android Facebook Install Referrer 所需的信息。
确认 Facebook App ID
在 Meta for Developers 注册应用后，确认 App ID 并输入。
- 查看路径：Dashboard → 选择应用 → 设置（Settings） → 基本（Basic） → App ID
输入解密密钥
输入 Meta 签发的 32 字节解密密钥（HEX 64 位）。
- 查看路径：Dashboard → 选择应用 → 设置（Settings） → 高级（Advanced） → Install Referrer Decryption Key
解密密钥会加密保存
保存的解密密钥会被加密并安全保管，保存后不会再次显示。如需更改，请重新输入新密钥。
5. 注意事项
请留意以下事项。
- Meta Ads 与 adstage 之间可能出现数值差异。这是统计时点、时区、筛选基准的差异所致。
- 若撤销 Meta 账户的权限或令牌过期，数据收集可能会中断。
- 在广告渠道中修改广告系列名称后，反映到 adstage 可能需要一些时间。
- 要启用转化 API，Pixel ID 与访问令牌两者都必须已保存。