Branch

Branch 使客户能够跨多种设备、渠道和平台触达用户、与其互动并评估效果。这是一个用户友好的平台,通过专用链接提升移动端收益,这些链接可在所有设备、渠道和平台上无缝运行。

Adapty 提供完整的数据集,让您可以在一个地方追踪来自应用商店的订阅事件。借助 Adapty,您可以轻松了解订阅用户的行为,了解他们的喜好,并利用这些信息进行精准、有效的沟通。

Adapty 与 Branch 的集成通过两种主要方式运作。

  1. 从 Branch 接收归因数据
    设置 Branch 集成后,Adapty 将开始从 Branch 接收归因数据。您可以在用户的用户画像页面上轻松访问和查看这些数据。

    49f4aa7-CleanShot_2023-08-11_at_17.36.072x.webp
  2. 向 Branch 发送订阅事件
    Adapty 可以将集成中配置的所有订阅事件发送到 Branch。这样,您就可以在 Branch 看板中追踪这些事件,并将其与您的获客活动关联起来。

设置集成

将 Adapty 连接到 Branch

要集成 Branch,请在 Adapty 看板中前往 Integrations > Branch,将开关从关闭切换为开启,并填写相关字段。

817a051-CleanShot_2023-08-11_at_15.54.372x.webp

要获取 Branch Key 的值,请打开您的 Branch 账户设置,找到 Branch Key 字段。将其用于 Adapty 看板中的 Key test(沙盒环境)或 Key live(生产环境)字段。在 Branch 中,切换 Live 和 Tests 环境以获取相应的密钥。

130e58b-CleanShot_2023-08-11_at_15.24.162x.webp

配置事件和标签

在凭据下方,有三组事件可供您从 Adapty 发送到 Branch。只需开启您需要的事件即可。在此处查看 Adapty 提供的完整事件列表。

您可以发送含税后收益(扣除 Apple/Google 抽成后)的事件,也可以仅发送收入数据。此外,您还可以勾选以用户货币进行报告的选项。

a645cf8-CleanShot_2023-08-11_at_15.18.282x.webp

我们建议使用 Adapty 提供的默认事件名称。但您也可以根据需要修改事件名称。

Adapty 将通过服务器到服务器集成向 Branch 发送订阅事件,使您能够在 Branch 看板中查看所有订阅事件,并将其与您的获客活动关联起来。

将您的应用连接到 Branch

  1. 调用 .setIntegrationIdentifier() SDK 方法初始化连接。您可以将 Branch Identity ID 传递给 customerUserId 参数。

如果您使用第三方用户 ID 作为 Customer User ID,请不要在 activate() 时传入——第三方 SDK 可能尚未生成该 ID。请先不带 CUID 调用 activate(),然后调用 setIntegrationIdentifier(),最后再使用 CUID 调用 identify()

  1. 使用 .updateAttribution() 方法保存归因数据。如果您在上一步中未指定 Branch 用户 ID,请在此处将其传递给 networkUserId 参数。

事件结构

Adapty 按照 Branch 集成页面Events names 部分的配置,将所选事件发送到 Branch。每个事件的结构如下:

{
  "branch_key": "key_live_kaFuWw8WvY7n1ss7...",
  "name": "PURCHASE",
  "user_data": {
    "os": "iOS",
    "developer_identity": "user_12345",
    "country": "US",
    "ip": "192.168.100.1",
    "idfa": "00000000-0000-0000-0000-000000000000",
    "idfv": "00000000-0000-0000-0000-000000000000",
    "aaid": "00000000-0000-0000-0000-000000000000"
  },
  "event_data": {
    "transaction_id": "GPA.3383-4699-1373-07113",
    "revenue": 9.99,
    "currency": "USD"
  },
  "custom_data": {
    "vendor_product_id": "yearly.premium.6999",
    "original_transaction_id": "GPA.3383-4699-1373-07113",
    "store": "play_store",
    "environment": "production"
  }
}

各参数说明:

参数类型描述
branch_keyString您的 Branch Key。
nameStringBranch 事件名称(从 Adapty 事件映射而来,例如 “PURCHASE”)。
user_dataObject用户信息。
user_data.osString”Android” 或 “iOS”。
user_data.developer_identityString用户的 Customer User ID。
user_data.countryString基于用户 IP 的国家代码。
user_data.ipString用户的 IP 地址。
user_data.idfaString仅限 iOS。广告商标识符。
user_data.idfvString仅限 iOS。供应商标识符。
user_data.aaidString仅限 Android。Google 广告 ID。
event_dataObject标准事件指标(仅适用于 PURCHASE 及类似事件)。
event_data.transaction_idString商店交易 ID。
event_data.revenueFloat收入金额。
event_data.currencyString货币代码(例如 “USD”)。
custom_dataObject详细事件属性(包含所有可用的事件字段)。