English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

Braze

作为顶尖的用户互动解决方案之一，Braze 提供了丰富的推送通知、电子邮件、短信及应用内消息工具。通过将 Adapty 与 Braze 集成，您可以在一处轻松查看所有订阅事件，并基于这些事件触发自动化通信流程。

Adapty 提供了一套完整的数据，让你可以在一个地方追踪来自所有应用商店的订阅事件，并用于更新 Braze 中的用户画像。借助 Adapty，你可以轻松了解订阅用户的行为偏好，并据此以精准有效的方式与他们沟通。因此，通过此集成，你可以在 Braze 看板中追踪订阅事件，并将其与你的获客活动进行关联。

Adapty 会将订阅事件、用户属性和购买记录发送至 Braze，让你在完成以下简单集成后，即可使用 Braze 推送通知与客户建立精准沟通。

如何设置 Braze 集成

要将 Adapty 连接到 Braze，请在 Adapty 看板中打开 Integrations → Braze，开启开关，并填写凭据：

  • REST API key 和 Braze Instance ID 为必填项。
  • iOS App ID 和 Android App ID 为选填项。
5f1e62c-adapty_braze.webp
  1. 要创建 REST API key，请在 Braze 看板中前往 Settings → APIs and Identifiers，然后点击 Create API Key。在用户数据权限下，选择 users.track。Braze 不允许在创建密钥后更改其权限，因此不含 users.track 的密钥必须替换为新密钥。详情请参阅 Braze 文档中的 Creating REST API keys。
  2. 要查找 Braze Instance ID，请将您的 Braze 看板 URL 与 Braze 文档中的实例表进行对照。实例 ID 采用区域格式，例如 US-03 或 EU-01。举个例子，dashboard-03.braze.com 对应 US-03。
  3. 要查找 iOS App ID 和 Android App ID，请在 Braze 看板中前往 Settings → APIs and Identifiers → App Identifiers。复制每个应用的 Identifier 列中的值。详情请参阅 Braze 文档中的 App identifier。

事件、用户属性与购买记录

在凭据设置下方，有三组事件可供你从 Adapty 发送到 Braze。直接开启你需要的事件即可。你也可以根据需要修改事件名称，以便发送到 Braze。查看 Adapty 提供的完整事件列表，请点击这里：

702e628-adapty_braze_events_names.webp

Adapty 将通过服务端对服务端集成，把订阅事件和用户属性发送到 Braze，让你可以在 Braze 看板中查看这些数据，并据此配置营销活动。

对于包含收入的事件（如试用转化和续订），Adapty 会将这些信息以购买事件的形式发送至 Braze。

Warning

Adapty 仅通过旧版购买事件向 Braze 发送收入数据。Braze 已将旧版购买事件置于维护模式，不再为新客户启用该功能。如果您的 Braze 工作区不支持旧版购买事件，Braze 将以 HTTP 400 状态码和 Legacy purchase ingestion is disabled 消息拒绝所有包含收入的事件。首次购买、续订、试用转化、退款等事件将完全无法到达 Braze，而不仅仅是其收入数据。

在开启集成之前，请确保您的 Braze 工作区支持旧版购买事件。详情请参阅 Braze 文档中的购买事件。

此处提供了发送至 Braze 的事件属性完整说明。

Note

实用用户属性

Adapty 默认为 Braze 集成发送一些用户属性。您可以参考下方提供的列表，选择最适合您需求的属性。

用户属性类型值
adapty_customer_user_idString包含客户定义的用户唯一标识符的值。可在 Adapty 看板和 Braze 中找到。
adapty_profile_idString包含 Adapty 用户画像 ID 的唯一标识符值，可在 Adapty 看板中找到。
environmentString

表示用户当前处于沙盒还是生产环境。

值为 Sandbox 或 Production

storeString

包含用于完成购买的商店名称。

可能的值：

app_store 或 play_store。

vendor_product_idString

包含 Apple/Google 商店中产品 ID 的值。

例如：org.locals.12345

subscription_expires_atString

包含最新订阅的到期日期。

值格式为：

YYYY-MM-DDTHH:mm:ss.SSS+TZ

例如：2023-02-15T17:22:03.000+0000

active_subscriptionString在任何购买/续订事件时值将设为 true，若订阅已到期则设为 false。
period_typeString

表示最近一次购买或续订的周期类型。

可能的值为：

trial 表示试用期，normal 表示其他情况。

所有浮点值将被四舍五入为整数，字符串保持不变。

除了预定义的标签列表外，还可以使用标签发送自定义属性。这为标签中包含的数据类型提供了更大的灵活性，有助于追踪与产品或服务相关的特定信息。如果用户在集成页面勾选了 Send user attributes 复选框，所有自定义用户属性将自动发送到 Braze。

SDK 配置

要在 Adapty 和 Braze 中关联用户画像，需要使用与 Adapty 相同的 customer user ID 配置 Braze SDK，或调用其 .changeUser() 方法：

故障排除

access_level_updated 在事件流中显示为失败

access_level_updated 是一个仅限 Webhook 的事件。Adapty 不会将其发送到此集成。但 Adapty 会为每个已启用的集成记录结果，不支持的事件将显示为失败。