将 Meta Ads 与 Adapty 归因集成

Adapty 的 Meta 归因集成让你能够跨 Facebook、Instagram、Messenger 和 Audience Network 追踪并优化广告系列表现。

步骤 1. 连接您的 Facebook 账号

要将 Meta Ads 连接到 Adapty 归因，请从左侧侧边栏前往 Integrations > Meta。您有两种连接方式：

• Continue with Facebook：通过 OAuth 连接。如果您使用个人或企业 Facebook 账号登录 Meta Ads Manager，请选择此方式。
• Add system token：使用永久系统用户令牌连接。如果您的组织通过 Meta Business 系统用户管理广告账号，请选择此方式。

Important

确保你的 Facebook 账号有权访问所需的广告系列和像素。

1. 点击 Continue with Facebook。

2. 使用你的 Facebook 账号登录，然后点击 Continue。

3. 查看所请求的权限，然后点击 Save。

在 Meta Business Settings 中生成系统用户访问令牌，然后将其添加到 Adapty Attribution 中。

Important

开始之前，你需要在 Meta Business 账户中拥有一个系统用户，并已将要追踪的广告账户分配给该用户。此外，还需要在账户中添加一个应用——生成令牌时需要选择此应用。

在 Meta Business Settings 中生成令牌：

1. 进入 Business Settings。
2. 在 Users 下，选择 System users。
3. 选择您的系统用户，然后点击 Generate new token。
4. 从下拉菜单中选择您的应用。
5. 在权限列表中，启用 ads_read。这是 Adapty Attribution 读取广告系列和广告数据所需的唯一权限。
6. 点击 Generate token。
7. 复制令牌并妥善保存。Meta 只会显示一次。

Note

Token expiration 设置控制连接保持活跃的时长。设置了过期日期的 token 必须在到期前重新生成并重新连接，否则归因将停止。没有过期日期的 token 可以避免这一问题，但属于长期有效凭证，请妥善保管，一旦泄露应立即撤销。

在 Adapty Attribution 中添加 token：

1. 点击 Add system token。

2. 粘贴 token 并点击 Connect。

完成后，您的所有广告账户将被添加到 Adapty Attribution，接下来可以继续添加广告系列。

第二步：添加营销活动

一个营销活动可以同时覆盖 App Store、Google Play 和你的 Web 漏斗。连接生效需要以下两个要素：

• 跟踪链接：放入广告中。当用户点击广告时，Adapty 记录该点击，将用户引导至目标页面，并在之后将安装和购买归因到该广告。每个目标页面对应一条独立的链接。
• Pixel：在广告系列中从您的 Meta 账户的 Pixel 中选择。将这些转化数据回传给 Meta，使 Meta 能够根据真实购买情况优化广告系列。一个 Pixel 可以服务于所有三个目标页面，也可以为每个目标页面单独设置。

如需向 Adapty Attribution 添加新的 Meta 广告系列：

1. 切换到 Web Campaigns 标签页，然后点击 Create configuration。

   

2. 在 General 标签页中，展开 iOS 和/或 Android 部分，粘贴 App Store 和/或 Google Play 应用 URL。

   

3. 复制 Click link 字段的值。然后在 Meta Ads Manager 中打开你的广告，将此链接粘贴进去。这样 Adapty 就能将安装和购买行为关联到 Meta 上的广告。

   

4. 要将转化事件回传至 Meta，您还可以在 Adapty 归因中将 Meta 的像素与广告系列关联。为此，请在 Pixel 下拉菜单中选择一个已有像素。选择像素后，可点击 Send test event 验证连接是否正常。

Web funnel 部分的工作方式与此相同。通过 Web 漏斗发生的购买行为在应用外进行，因此 Meta 只能通过你在此处选择的像素了解这些购买情况。同一部分还提供了用于在漏斗中安装像素的代码片段，以及用于为广告 URL 添加标签的参数。

每个目标使用不同的像素，可将 iOS、Android 和网页端购买分开进行优化和报告；各处使用相同的像素则会将其合并。Web Campaigns 列表会在每条配置下显示该选择，分别位于 Pixel (iOS)、Pixel (Android) 和 Pixel (Web) 列，显示像素的名称和 ID。未配置像素的部分显示破折号，若某个像素在三个部分中均被选中，则会出现三次。

第三步：映射事件

若要将转化事件回传至 Meta 以优化广告系列，需要在 Events mapping 部分配置事件映射。这样，当用户在应用内执行相关操作时，Adapty 会自动发送订阅事件。

在 Events mapping 部分，开启您希望在 Meta Ads Manager 中追踪的事件。对于每个已启用的事件，从下拉菜单中选择对应的 Meta 事件，或自定义一个。默认情况下，Adapty 会将 Adapty 事件映射到 Meta 的标准事件。

点击 Save 保存事件映射配置。

其他配置

附加参数

Additional parameter 字段允许你添加自定义数据点，以便在 Adapty 之外进行分析。当你需要将特定的广告活动或用户数据传递给外部分析工具或归因合作伙伴时，这一功能非常有用。

在 Additional parameter 字段中，输入你希望包含在归因追踪中的任何自定义数据。该附加参数将包含在发送给 Meta 的所有归因数据中，可用于高级广告活动分析和优化。

例如，如果你正在运行同一广告系列的多个变体，可以添加 variant=A 或 variant=B 来区分不同的素材方案。

设置

Settings 标签页控制 Adapty 如何将用户行为与你的 Meta Ads 广告活动进行匹配。这些设置决定了确定性归因匹配和概率性归因匹配的时间窗口。

要进行配置，请前往广告活动配置中的 Settings 标签页。你会看到以下两个主要设置：

• 确定性匹配窗口：使用精确的设备标识符（如 iOS 上的 IDFA 或 Android 上的 Advertising ID）将用户与广告系列进行高精度匹配。建议将此项设置为 168 小时（7 天）以获得最佳归因准确性——这也是默认推荐值。当用户点击您的 Meta 广告并在此窗口内安装应用时，Adapty 可以通过设备标识符明确将该安装归因到对应的广告点击。

• Probabilistic matching window：当无法进行确定性匹配时，系统会使用统计模型和设备指纹技术来匹配用户。对于大多数广告活动，建议将此项设置为 6 小时——这是默认值，适用于大多数场景。对于点击量较高的广告活动，可将其缩短至 1-2 小时。对于因隐私设置或其他原因无法进行确定性匹配的用户，Adapty 会在此较短时间窗口内使用概率匹配。

点击 Save 应用您的设置。

收入覆盖

如果您追踪试用事件并希望 Meta 将收入归因到这些事件上，请使用 Revenue override 部分。该部分在启用 Trial started 事件后出现。覆盖规则仅适用于 Trial started 事件——Trial converted 和 Subscription started 始终使用实际收入。

针对每个试用事件目标，设置需上报的订阅价格百分比作为收入。例如，设置为 30% 时，Adapty 会将订阅价格的 30% 作为试用事件的转化值发送给 Meta。

要添加覆盖规则：

1. 在 Events mapping 部分启用 Trial started。
2. 在 Revenue override 中，点击 Add override。
3. 选择目标事件并输入收入百分比（0–100）。
4. 点击 Save。

有效试用

试用在经过指定小时数且未被取消后即视为有效。使用 Qualified trial 部分可暂缓发送试用事件，直到满足条件后再发送，从而确保 Meta 只收到用户真正保留的试用记录。

对于每个试用事件目标，设置等待的小时数。Adapty 从试用开始计时，当截止时间到达时发送事件。如果用户在截止时间前关闭了自动续订，Adapty 将不会发送该事件。如果用户在截止时间前重新开启了自动续订，Adapty 将按计划发送事件。

要将试用事件保留至符合条件时再触发：

1. 在 Events mapping 部分启用 Trial started。
2. 在 Qualified trial 中，点击 Add event。
3. 选择目标事件并输入等待的小时数，范围为 1 到 24。
4. 点击 Save。

Adapty 发送合格事件时使用原始试用开始时间，因此 Meta 会将其归报到试用开始当天。

Revenue override 和 Qualified trial 相互独立，你可以将两者同时应用于同一个试用事件。Revenue override 更改 Meta 收到的金额；Qualified trial 更改 Meta 收到该事件的时机。两者同时启用时，Adapty 会等到试用达到合格条件后再发送事件，并附带覆盖后的收入金额。我们对这两者没有优先推荐——建议根据你的广告系列实际效果进行测试。

预测 LTV

Meta 的价值优化功能会根据转化价值来出价，但它本身只能看到上报的付款金额——因此月度试用和年度订阅在出价时看起来几乎没有区别。使用 Predicted LTV 部分，可以在上报转化的同时向 Meta 发送预测生命周期价值，让 Meta 根据用户在你所选时间范围内的预期价值来出价。

Adapty 根据您应用的实际收入数据（按国家、商店、设备和语言分组）生成趋势预测，并将其附加到已发送的转化事件上。

一旦应用数据足以支撑有意义的预测，预测 LTV 功能即可解锁。Adapty 每日重新计算一次，并在 Predicted LTV 板块显示当前进度。Trial started 和 Subscription started 分别独立统计，任意一项达标即可同时解锁两个进度条：

• 在过去 4 个完整周中，每周至少有 100 次 Meta 归因的该事件转化。
• 至少有 5 个不同的预测值，且最高值至少是最低值的 3 倍。

Meta 还有两项要求是 Adapty 无法帮你核验的：数据集必须已脱离核心设置阶段，且广告账户必须已启用经过验证的价值模型。

要为广告系列发送预测值：

1. 在 Events mapping 中，启用 Trial started 或 Subscription started，并将其映射到一个 Meta 事件。
2. 在 Predicted LTV 中，开启 Send predicted LTV to Meta。
3. 在 Anchor event 中，选择您在第 1 步中映射的事件。
4. 在 Prediction horizon 中，选择预测的时间范围：30、90、180 或 365 天。
5. 在 Target event 中，选择预测值所附加的 Meta 事件。列表中仅显示该广告系列将锚点事件映射到的目标事件。Meta 仅接受 Purchase、Subscribe、StartTrial、CompleteRegistration、AddPaymentInfo 以及自定义事件的预测值。
6. 点击 Save。
7. 为使 Meta 能够使用这些值，请在 Events Manager 中打开您的数据集，在 Value and Currency Metrics 中选择目标事件，点击 Set up pLTV，然后选择 After [Event Name] events——因为 Adapty 是在转化发生之后才传递该值的，而非与转化同步传递。

Meta 每个数据集只接受一个锚点事件和一个时间范围，因此共享同一像素的广告系列必须发送相同的配对。若某个广告系列保存的配对与该像素上另一个已启用广告系列的配对不一致，保存操作将被拒绝，错误信息会指出需要对齐的广告系列名称。

Adapty 在发送锚点转化时准备预测值，并在 24 小时后发送该值——这在 Meta 将值附加到转化的 7 天时间窗口之内。以下三种情况会影响 Meta 接收到的数据：

• 当锚定事件由 合格试用 持有时，24 小时从试用事件到达 Meta 时开始计算。在达到合格条件之前取消的试用，既不会发送转化事件，也不会发送预测值。
• 当 Adapty 对该用户所在群组没有预测数据时（例如你最近才开始投放的国家），转化事件仍会发出，但不包含预测值。
• 关闭 Send predicted LTV to Meta 后，尚未发送的预测值也会一并丢弃。

Adapty 以美元（USD）发送预测值。

一旦 Events Manager 不再显示该集成的未解决问题，Meta 大约需要两周时间训练其模型，然后你才能启动第一个 pLTV 广告系列。要查看结果，请在 Ads Manager 中通过 Columns > Customize columns > Results ROAS 添加目标事件对应的 pLTV 列，例如 StartTrial pLTV。Adapty 会在转化发生后的次日推送每个数值，因此请在广告系列结束后等待一天再查看最终数据。

发送所有事件

默认情况下，Adapty 仅上报来自 Meta 广告系列的用户事件。开启 Send all events 选项后，所有安装和交易事件都会被上报，包括自然流量和未归因用户的数据。

除非你的广告系列向 Meta 发送的转化数据太少，无法支撑优化，否则我们不建议开启此选项——将自然流量和未归因事件与广告系列事件混合上报，会降低 Meta 优化的精准度。

如果您决定开启此功能，请在广告系列设置中选择 Send all events (forward organic/non-attributed events to this pixel)，然后点击 Save。