设置 Braze

Braze 既是数据分析服务提供商,也是 Adjust 的模块合作伙伴。我们的集成允许 Braze 通过自动回传接收归因和应用内事件数据。

参照我们的基本设置说明来启用 Adjust 的集成,并发送回传至 Braze。之后,使用我们的高级设置说明自定义 Braze 将接收哪些信息。

操作前须知

在启用 Adjust 与 Braze 的集成之前,请按照下列步骤完成操作:

1. 映射设备 ID

安卓

如果您拥有的是 Android 应用,就需要向 Adjust 发送唯一的 Braze 设备 ID。请在 Adjust SDK 中使用 addSessionPartnerParameter() 方法设置该值。您需要在 Adjust.onCreate() 上初始化 Braze Android SDK 之前提供该代码片段。

Adjust.addSessionPartnerParameter("braze_device_id", Braze.getInstance(getApplicationContext()).getDeviceId()););

iOS

Objective-C

Adjust 会收集 iOS 应用的 IDFV,并将其发送给 Braze。然后,Braze 会将该 ID 映射到唯一的设备 ID。

如果您使用 Braze 收集 IDFA,那么 Braze 就会储存已授予数据跟踪许可的用户 IDFA 值,否则,Braze 会以后备标识符的方式使用 IDFV,映射用户。

Swift

如果您拥有的是 iOS 应用,那么可以在 Braze Swift SDK 中将 userUUIDAsDeviceId 字段设置为 false,启用 IDFV 收集。否则,Adjust 到 Braze 的 iOS 归因就无法精确映射。要了解更多信息,请参阅 Braze 文档中的 IDFV 收集相关内容

2. 生成 Braze Data Import Key (数据导入密钥)

  1. 在 Braze 中找到 Technology Partners​ ,然后选择 Adjust​ 。
  2. 找到这里的 REST Endpoint​ ,生成 Braze Data Import Key​ 。

生成后,您可以创建新的密钥,或作废现有密钥。使用数据导入密钥和 REST Endpoint (REST 终端),可配置 Adjust 与 Braze 的集成。如需了解更多信息,请参阅Braze 文档

基本设置

如需启用 Adjust 与 Braze 的集成,请遵循以下步骤。

  1. 查找应用并点击应用选项插入符号 (^)
  2. 选择 合作伙伴设置​ > 添加合作伙伴​ 。
  3. 选择 Braze​ 旁的添加 (+) 图标。
  4. 输入您的数据导入密钥和 REST 终端。请查看这一节内容,了解如何找到这些值。
  5. 可选:参阅高级设置来自定义回传。
  6. 然后选择 保存​ 。

太棒了!基本设置已经完成。

请注意:​ Braze 从 Adjust 收到已归因安装的相关数据后,Braze 中 Adjust 技术合作伙伴界面的状态指示就会从 "Not Connected" (未连接) 变成 "Connected" (已连接),并显示最后一次成功请求的时间戳。

高级设置

通过自定义设置来选择 Braze 将从 Adjust 接收的数据内容。

转发应用内收入

应用内收入转发功能允许 Braze 接收收入金额以及您的收入事件数据。

如需向 Braze 转发应用内收入,请按以下步骤操作。

  1. 查找应用并点击应用选项插入符号 (^)
  2. 选择 合作伙伴设置​ > Braze​ 。
  3. 打开 应用内收入转发

现在 Braze 将接收每笔跟踪交易的收入金额。

注意:​ 在打开 "收入转发" 之前,至少要将一个收入事件关联到 Braze。

发送自定义数据

合作伙伴参数(在 Adjust SDK 4.0+ 版本中提供)允许 Adjust 从您的应用中收集自定义数据点,并将其发送至 Braze。

注意:​ 在向 Adjust SDK 添加新的合作伙伴参数之前,请首先确保不存在已满足您要求的合作伙伴参数。

如需向 Braze 转发合作伙伴参数,请遵循以下步骤。

  1. 在 Adjust SDK 中设置合作伙伴参数(iOS安卓使用说明)。
  2. 在 Adjust 控制面板中,查找应用并选择应用选项插入符号 (^)。
  3. 选择 合作伙伴设置​ > Braze​ 。
  4. 打开 参数转发​ 。
  5. 选择 合作伙伴参数映射​ 。
  6. 从应用​ 字段中,输入 Adjust 参数的名称(与写入 Adjust SDK 的名称相同)。在 至合作伙伴​ 字段中,输入相应的 Braze 名称。
  7. 然后选择 保存​ 。

现在 Braze 将接收您每个关联事件的自定义事件详细信息。

注意:​ 如果您在 Adjust SDK 中设置了合作伙伴参数而没有打开”合作伙伴参数映射“,则 Adjust 将按照 Adjust SDK 中的名称发送参数。

合作伙伴特定设置说明

注意​ :不要输入终端协议,请确保您的激活字段中不包含 https://。最后同样需要注意的是,Braze 需要特定的参数才能接收回传数据。

预定义参数

Braze 允许您发送一组预定义参数。如果将这些参数中的任一参数附加到您的 Adjust SDK 中的事件中,该参数将会转发至 Braze。有关附加合作伙伴参数的更多信息,请参阅您正在使用的单个或多个 SDK 的相应 SDK 说明文件。以下是 Braze 可以接受的已定义参数的列表:

参数键 > 值

  • external_id > 向 Braze 发送事件时为强制参数。
  • braze_device_id > 向 Braze 发送任何 Android 数据时为强制参数。
  • product_id > 向 Braze 发送收入事件时为强制参数。 如需发送事件回传给 Braze,您必须在 Adjust SDK 中将 external_id 设置为事件合作伙伴参数。如需转发收入事件,您还应将 product_id 设置为事件合作伙伴参数。

对于 Android 应用,您必须将 braze_device_id 设置为会话和事件合作伙伴参数。最后,如需转发收入事件,您必须将 product_id 设置为收入事件的合作伙伴参数。请注意,Braze 不支持 Organic (自然量)、Facebook 或 Twitter 数据,因此也不会发送这些跟踪链接的回传。

回传
目前 Adjust 不会向 Braze 转发 Organic (自然量)、Facebook 和 Twitter 的推广活动数据。

如果您想了解如何根据自身需求使用此集成,请参考我们的Braze 要点说明。如对此说明中的信息有任何疑问,请联系 partners@adjust.com

转发给 Braze 的所有参数列表

Braze 要求 Adjust 通过您的回传发送以下参数 (数据点):

占位符信息
{currency}从 Adjust SDK 发送的原始 ISO 4217 货币代码
{idfa}广告 ID(仅限 iOS 设备)
{partner_parameters}Adjust SDK 或 S2S 请求收集并且通过回调传输给第三方提供商的自定义合作伙伴参数
{revenue}从 Adjust SDK 发送的收入(以分计)
{win_adid}Windows 广告标识符
{adgroup_name}广告组名称,取自跟踪链接
{app_id}商店的应用 ID 或 Google Play 商店
{campaign_name}推广活动名称,取自跟踪链接
{created_at}活动时间戳
{creative_name}素材名称,取自跟踪链接
{network_name}渠道名称,取自跟踪链接