Braze Track Events API 事件转发扩展

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

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

Braze Track Events API 事件转发扩展允许您利用Adobe Experience PlatformEdge Network中捕获的数据,并使用Braze User Track API以服务器端事件的形式将其发送到Braze。

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

用例

如果要使用Braze中Edge Network的数据以利用其客户分析和定位功能,应使用此扩展。

例如,假定某个零售组织具有多渠道存在(网站和移动设备),并且从其网站和移动平台捕获事务性或对话性输入作为事件数据。 使用各种标记规则,实时将此数据发送给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实例
与Braze帐户关联的REST终结点。 有关指导,请参阅有关实例的Braze文档。
https://rest.iad-03.braze.com
API密钥
与Braze帐户关联的Braze API密钥。
有关指导,请参阅有关REST API密钥的Braze文档。
YOUR-BRAZE-REST-API-KEY

创建密钥

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

安装和配置Braze扩展 install

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

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

安装Braze扩展。

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

  • Braze Rest终结点URL:您可以在提供的输入中输入Braze Rest终结点URL的纯文本值。
  • API密钥:选择您之前创建的机密数据元素,该元素包含您的Braze API密钥。

完成后选择​ 保存

扩展配置页面Braze。

创建Send Event规则 tracking-rule

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

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

用户标识

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

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

事件数据

输入
描述
必需
事件名称{​1}
事件的名称。
事件时间
ISO 8601或yyyy-MM-dd'T'HH:mm:ss:SSSZ格式字符串形式的日期时间。
应用程序标识符
应用程序标识符或 app_id 是将活动与应用程序组中的特定应用程序关联的参数。 它可指定您正在与应用程序组中的哪个应用程序进行交互。 了解有关API标识符类型的更多信息。
事件属性{1​}
包含事件的自定义属性的JSON对象。
NOTE
Braze Send Event ​操作只需要指定​ 事件名称 ​和​ 事件时间,但您应在自定义属性字段中包含尽可能多的信息。 有关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 ​扩展,然后为操作类型选择​ 发送购买事件

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

用户标识

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

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

购买数据

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