Branch
Branch 使客户能够跨多种设备、渠道和平台触达用户、与其互动并评估效果。这是一个用户友好的平台,通过专用链接提升移动端收益,这些链接可在所有设备、渠道和平台上无缝运行。
Adapty 提供完整的数据集,让您可以在一个地方追踪来自应用商店的订阅事件。借助 Adapty,您可以轻松了解订阅用户的行为,了解他们的喜好,并利用这些信息进行精准、有效的沟通。
Adapty 与 Branch 的集成通过两种主要方式运作。
-
从 Branch 接收归因数据
设置 Branch 集成后,Adapty 将开始从 Branch 接收归因数据。您可以在用户的用户画像页面上轻松访问和查看这些数据。
-
向 Branch 发送订阅事件
Adapty 可以将集成中配置的所有订阅事件发送到 Branch。这样,您就可以在 Branch 看板中追踪这些事件,并将其与您的获客活动关联起来。
设置集成
将 Adapty 连接到 Branch
要集成 Branch,请在 Adapty 看板中前往 Integrations > Branch,将开关从关闭切换为开启,并填写相关字段。
要获取 Branch Key 的值,请打开您的 Branch 账户设置,找到 Branch Key 字段。将其用于 Adapty 看板中的 Key test(沙盒环境)或 Key live(生产环境)字段。在 Branch 中,切换 Live 和 Tests 环境以获取相应的密钥。
配置事件和标签
在凭据下方,有三组事件可供您从 Adapty 发送到 Branch。只需开启您需要的事件即可。在此处查看 Adapty 提供的完整事件列表。
您可以发送含税后收益(扣除 Apple/Google 抽成后)的事件,也可以仅发送收入数据。此外,您还可以勾选以用户货币进行报告的选项。
我们建议使用 Adapty 提供的默认事件名称。但您也可以根据需要修改事件名称。
Adapty 将通过服务器到服务器集成向 Branch 发送订阅事件,使您能够在 Branch 看板中查看所有订阅事件,并将其与您的获客活动关联起来。
将您的应用连接到 Branch
- 调用
.setIntegrationIdentifier()SDK 方法初始化连接。您可以将 Branch Identity ID 传递给customerUserId参数。
如果您使用第三方用户 ID 作为 Customer User ID,请不要在 activate() 时传入——第三方 SDK 可能尚未生成该 ID。请先不带 CUID 调用 activate(),然后调用 setIntegrationIdentifier(),最后再使用 CUID 调用 identify()。
- 使用
.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_key | String | 您的 Branch Key。 |
name | String | Branch 事件名称(从 Adapty 事件映射而来,例如 “PURCHASE”)。 |
user_data | Object | 用户信息。 |
user_data.os | String | ”Android” 或 “iOS”。 |
user_data.developer_identity | String | 用户的 Customer User ID。 |
user_data.country | String | 基于用户 IP 的国家代码。 |
user_data.ip | String | 用户的 IP 地址。 |
user_data.idfa | String | 仅限 iOS。广告商标识符。 |
user_data.idfv | String | 仅限 iOS。供应商标识符。 |
user_data.aaid | String | 仅限 Android。Google 广告 ID。 |
event_data | Object | 标准事件指标(仅适用于 PURCHASE 及类似事件)。 |
event_data.transaction_id | String | 商店交易 ID。 |
event_data.revenue | Float | 收入金额。 |
event_data.currency | String | 货币代码(例如 “USD”)。 |
custom_data | Object | 详细事件属性(包含所有可用的事件字段)。 |