Braze Track Events API 事件转发扩展

Braze 是一个客户参与平台,可实时支持消费者和品牌之间以客户为中心的互动。 使用 Braze,您可以执行以下操作:

  • 根据用户的语言偏好、位置偏好等,向目标用户交付数据(例如营销消息),以提高转化率并支持关键业务目标。
  • 在适当的时间以客户的首选语言跨多个渠道向客户发送个性化消息,包括电子邮件、推送通知和应用程序内消息。
  • 定位特定用户进行营销和促销活动,以增加常客的数量。
  • 研究用户行为和模式,通过自定义消息定位特定受众,这可能有助于增加收入。

此 Braze Track Events API 事件转发 通过扩展,您可以利用在Adobe Experience Platform Edge Network中捕获的数据并将其发送至 Braze 以服务器端事件的形式使用 Braze User Track API。

本文档介绍了扩展的用例,如何在事件转发库中安装扩展,以及如何在事件转发中部署扩展的功能 规则.

用例

如果您要在以下位置使用来自Edge Network的数据,则应该使用此扩展: Braze 以利用其客户分析和定位功能。

例如,假定某个零售组织具有多渠道存在(网站和移动设备),并且从其网站和移动平台捕获事务性或对话性输入作为事件数据。 使用各种 标记 规则,此数据会实时发送到Edge Network。 从这里, Braze 事件转发扩展会自动将相关事件发送到 Braze 从服务器端。

发送数据后,组织的分析团队就可以利用 Braze’s 处理数据集并获取业务洞察以生成图形、功能板或其他可视化图表以告知业务利益相关者。 请参阅 Braze 客户 页面,以了解该平台各种用例的更多详细信息。

Braze 先决条件和护栏 prerequisites

您必须拥有 Braze 以使用其技术。 如果您没有帐户,请导航到 入门页面 日期 Braze 以连接到 Braze Sales 并启动帐户创建流程。

API护栏

扩展使用两个 Braze的API及其限制概述如下:

API
速率限制
User Track
每分钟50,000个请求。
请参阅 User Track API文档 以了解详细信息。
User Identify
每分钟20,000个请求。
请参阅 User Identify API文档 以了解详细信息。
NOTE
请参阅指南,网址为 Braze API限制 有关它们所施加限制的更多细节。

可记帐数据点

将其他自定义属性发送至 Braze 可能会增加 Braze 数据点消耗。 请咨询您的 Braze 帐户管理器。 请参阅 Braze 文档 可记帐数据点 以了解更多信息。

收集所需的配置详细信息 configuration-details

为了将Edge Network连接到 Braze时,需要以下输入值:

键类型
描述
示例
Braze 实例
与关联的REST端点 Braze 帐户。 请参阅 Braze 文档 实例 作为指导。
https://rest.iad-03.braze.com
API密钥
此 Braze 与关联的API密钥 Braze 帐户。
请参阅 Braze 相关文档 REST API密钥 作为指导。
YOUR-BRAZE-REST-API-KEY

创建密钥

新建 事件转发密码 并将值设置为 Braze API密钥. 这将用于验证与您的帐户的连接,同时保持值的安全。

安装和配置 Braze 扩展 install

要安装扩展, 创建事件转发属性 或者选择现有的属性进行编辑。

选择 扩展 在左侧导航中。 在 目录 选项卡,选择 安装 在的卡片上 Braze 扩展。

安装 Braze 扩展。

在下一个屏幕上,输入以下内容 配置值 您之前收集到的 Braze:

  • Braze Rest端点URL:您可以输入 Braze 在提供的输入中,将端点URL重置为纯文本。
  • API密钥:选择 机密数据元素 之前创建的,其中包含 Braze API密钥。

选择 保存 完成后。

此 Braze 扩展配置页面。

创建 Send Event 规则 tracking-rule

安装该扩展后,请创建新的事件转发 规则 并根据需要配置其条件。 配置规则的操作时,选择 布拉泽 扩展,然后选择 发送事件 操作类型的。

添加事件转发规则操作配置。

用户标识

输入
描述
外部用户ID
长、随机和分布良好的UUID或GUID。 如果您选择不同的方法来命名用户ID,则这些用户ID还必须很长且是随机的、分布良好的。 了解有关 建议的用户ID命名约定.
钎焊用户ID
Braze用户标识符。
用户别名
别名用作替代的唯一用户标识符。 使用别名标识与核心用户ID沿不同维度的用户。

用户别名对象由两部分组成:标识符本身的alias_name和指示别名类型的alias_label。 用户可以有多个具有不同标签的别名,但每个alias_label只能有一个别名。
NOTE
要将事件绑定到用户,您需要填写 外部用户ID 字段,或 钎焊用户标识符 字段或 用户别名 部分。

事件数据

输入
描述
必需
事件名​称
事件的名称。
事件时间
ISO 8601或中的字符串形式的日期时间 yyyy-MM-dd'T'HH:mm:ss:SSSZ 格式。
应用程序标识符
应用程序标识符或 app_id 是将活动与应用程序组中的特定应用程序关联的参数。 它可指定您正在与应用程序组中的哪个应用程序进行交互。 了解关于 API标识符类型.
事件属​性
包含事件的自定义属性的JSON对象。
NOTE
Braze发送事件 操作只需要 事件名称事件时间 ,但您应在自定义属性字段中包含尽可能多的信息。 欲知有关 Braze 事件对象,请参阅 官方文档.

用户属性

用户属性可以是JSON对象,其中包含相应的字段,这些字段将在指定的用户配置文件上使用提供的名称和值创建或更新属性。 支持以下属性:

用户属性
描述
名字
姓氏
电话
电子邮件
性别
以下字符串之一:“M”、“F”、“O”(其他)、“N”(不适用)、“P”(不愿意说)。
城市
国家/地区
字符串形式的国家/地区 ISO-3166-1 alpha-2 格式。
语言
中的字符串语言 ISO-639-1 格式。
出生日期
“YYYY-MM-DD”格式的字符串(例如,1980-12-21)。
时区
时区名称来源 IANA时区数据库 (例如,“美国/纽约”或“东部时间(美国和加拿大)”)。
facebook
散列包含任意ID(字符串)、like(字符串数组)、num_friends(整数)。
Twitter
包含ID (整数)、screen_name (字符串、Twitter句柄)、followers_count (整数)、friends_count (整数)、statuses_count (整数)的任意哈希值。

创建 Send Purchase Event 规则 purchase-rule

安装该扩展后,请创建新的事件转发 规则 并根据需要配置其条件。 配置规则的操作时,选择 布拉泽 扩展,然后选择 发送购买事件 操作类型的。

添加Braze Purchase操作类型事件转发规则操作配置。

用户标识

输入
描述
外部用户ID
长、随机和分布良好的UUID或GUID。 如果您选择不同的方法来命名用户ID,则这些用户ID还必须很长且是随机的、分布良好的。 了解有关 建议的用户ID命名约定.
钎焊用户ID
Braze用户标识符。
用户别名
别名用作替代的唯一用户标识符。 使用别名标识与核心用户ID沿不同维度的用户。

用户别名对象由两部分组成:标识符本身的alias_name和指示别名类型的alias_label。 用户可以有多个具有不同标签的别名,但每个alias_label只能有一个别名。
NOTE
要将事件链接到用户,您必须完成 外部用户ID 字段, 钎焊用户标识符 字段,或 用户别名 部分。

购买数据

输入
描述
必需
产品​ID
购买的标识符。 (例如,产品名称或产品类别)
购买时间
ISO 8601或中的字符串形式的日期时间 yyyy-MM-dd'T'HH:mm:ss:SSSZ 格式。
货币​
货币作为字符串 ISO 4217 字母货币代码格式。
价​格
价格。
数​量
如果未提供,则默认值为1。 最大值必须小于100。
应用程序标识符
应用程序标识符或 app_id 是将活动与应用程序组中的特定应用程序关联的参数。 它可指定您正在与应用程序组中的哪个应用程序进行交互。 了解关于 API标识符类型.
购买属​性
包含购买的自定义属性的JSON对象。
NOTE
Braze发送事件 操作只需要 事件名称事件时间 ,但您应在自定义属性字段中包含尽可能多的信息。 欲知有关 Braze 事件对象,请参阅 官方文档.

用户属性

用户属性可以是JSON对象,其中包含相应的字段,这些字段将在指定的用户配置文件上使用提供的名称和值创建或更新属性。 支持以下属性:

用户属性
描述
名字
姓氏
电话
电子邮件
性别
以下字符串之一:“M”、“F”、“O”(其他)、“N”(不适用)、“P”(不愿意说)。
城市
国家/地区
字符串形式的国家/地区 ISO-3166-1 alpha-2 格式。
语言
中的字符串语言 ISO-639-1 格式。
出生日期
“YYYY-MM-DD”格式的字符串(例如,1980-12-21)。
时区
时区名称来源 IANA时区数据库 (例如,“美国/纽约”或“东部时间(美国和加拿大)”)。
facebook
散列包含任意ID(字符串)、like(字符串数组)、num_friends(整数)。
Twitter
包含ID (整数)、screen_name (字符串、Twitter句柄)、followers_count (整数)、friends_count (整数)、statuses_count (整数)的任意哈希值。

验证中的数据 Braze validate

如果事件集合和 Adobe Experience Platform 集成成功,您将会在 Braze 控制台时间 查看用户配置文件. 具体而言,新事件数据将发送到 Braze 反映在 Purchases 特定用户的部分 “概述”选项卡.

后续步骤

本指南介绍了如何将转化事件发送到 Braze 使用事件转发。 有关发送到的事件数据的下游应用程序的更多详细信息 Braze,请参阅 官方文档.

有关Experience Platform中事件转发功能的详细信息,请参阅 事件转发概述.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743