使用Platform Web SDK数据设置事件转发
了解如何将事件转发与Adobe Experience Platform Web SDK数据结合使用。
事件转发是数据收集中可用的一种新属性。 事件转发让您能够直接从Adobe Experience PlatformEdge Network而不是传统的客户端浏览器向第三方非Adobe供应商发送数据。 在中详细了解事件转发的优势 事件转发概述.
要在Adobe Experience Platform中使用事件转发,必须首先使用以下三个选项中的一个或多个将数据发送到Adobe Experience PlatformEdge Network:
完成本教程中之前的课程后,您应该使用Web SDK将数据发送到PlatformEdge Network。 数据进入平台Edge Network后,您可以启用事件转发并使用event-forwarding属性将数据发送到非Adobe解决方案。
学习目标
在本课程结束时,您将能够:
- 创建事件转发属性
- 将事件转发属性链接到Platform Web SDK数据流
- 了解标记属性数据元素和规则与事件转发属性数据元素和规则之间的差异
- 创建事件转发数据元素
- 配置事件转发规则
- 验证事件转发属性是否已成功发送数据
先决条件
-
包含事件转发的软件许可证。 事件转发是数据收集的一项付费功能。 有关更多详细信息,请联系您的Adobe客户团队。
-
已在您的Experience Cloud组织中启用事件转发。
-
用于事件转发的用户权限。 (位于 Admin Console,在Adobe Experience Platform Launch产品下,权限项平台 > Edge 和所有 资产权限)。 授予权限后,您应会看到 事件转发 在数据收集界面的左侧导航中:
-
Adobe Experience Platform Web或Mobile SDK配置为将数据发送到Edge Network。 您必须完成本教程中的以下课程:
创建事件转发属性
首先,创建事件转发属性:
-
打开 数据收集界面
-
选择 事件转发 从左侧导航
-
选择 新属性。
-
命名资产。 在本例中,
Server-Side - Web SDK Course
-
选择 保存。
配置数据流
要使事件转发使用您发送到PlatformEdge Network的数据,您必须将新创建的事件转发属性链接到用于将数据发送到Adobe解决方案的相同数据流。
要在数据流中配置Target,请执行以下操作:
-
转到 数据收集 界面
-
在左侧导航中,选择 数据流
-
选择之前创建的
Luma Web SDK: Development Environment
数据流 -
选择 添加服务
-
选择 事件转发 作为 服务
-
在 属性ID 下拉列表中,选择您为事件转发属性提供的名称,在本例中为
Server-Side - Web SDK Course
-
在 环境ID 在本例中,下拉列表选择您要将事件转发环境链接到的标记环境
Development
note tip TIP 要将数据发送到Adobe组织外的事件转发环境,请选择 手动输入Id 并粘贴一个ID。 此ID是在创建事件转发属性时提供的。 -
选择 保存。
当您准备好通过发布流提升所做更改时,请为暂存和生产数据流重复这些步骤。
将数据从平台Edge Network转发到非Adobe解决方案
在本练习中,您将了解如何设置事件转发数据元素、配置事件转发规则,以及使用名为的第三方工具进行验证 Webhook.site.
创建事件转发数据元素
您之前使用Platform Web SDK标记扩展配置的XDM对象将成为事件转发属性中数据元素的数据源。 您可以使用已在标记属性中配置的数据作为事件转发的数据源。
arc.event
前缀:- 其中,
arc
表示 Adobe 响应上下文。 - 例如:
arc.event.xdm.web.webPageDetails.URL
在本练习中,您要将浏览器视区高度和Experience CloudID从XDM对象转发到webhook。 XDM字段路径由以下期间创建的XDM架构确定: 配置XDM架构 上课。
/ee
请求,打开信标 有效负荷 并向下钻取到要查找的变量。 然后,使用鼠标右键单击并选择“复制属性路径”。 以下是浏览器视区高度的示例:-
转到 事件转发 您最近创建的属性
-
在左侧导航中,选择 数据元素
-
选择以 创建新数据元素
-
名称 数据元素
environment.browserDetails.viewportHeight
-
下 扩展名,离开
CORE
-
下 数据元素类型,选择
Path
-
键入包含浏览器视区高度的XDM对象路径
arc.event.xdm.environment.browserDetails.viewportHeight
-
选择 保存
-
创建另一个数据元素
-
名称 it
ecid
-
下 扩展名,离开
CORE
-
下 数据元素类型,选择
Path
-
键入包含Experience CloudID的XDM对象路径
arc.event.xdm.identityMap.ECID.0.id
-
选择 保存
note caution CAUTION 确保包括 arc.event.
路径中的前缀。 此外,请确保遵循与XDM对象字段名称完全相同的大小写 — ECID命名空间必须全部大写。note tip TIP 使用您自己的网站时,您可以使用Web浏览器网络工具找到XDM对象路径,并过滤 /ee
请求,打开信标 有效负荷 并向下钻取到要查找的变量。 然后,使用鼠标右键单击并选择“复制属性路径”。 以下是浏览器视区高度的示例:
安装Adobe云连接器扩展
若要将数据发送到第三方位置,您首先要安装 Adobe云连接器 扩展。
-
选择 扩展 在左侧导航栏中
-
选择 目录 选项卡
-
搜索 Adobe云连接器,选择 安装
无需扩展配置。 通过此扩展,您现在可以将数据转发到非Adobe解决方案!
创建事件转发规则
配置标记属性中的规则与事件转发属性中的规则有一些主要区别:
-
活动 和 条件:
- 标记:所有规则均由必须在规则中指定的事件触发,例如
Library Loaded - Page Top
. 条件为可选。 - 事件转发:我们假定发送到PlatformEdge Network的每个事件都是转发数据的触发器。 因此,不存在 活动 在事件转发规则中必须选择的属性。 要管理哪些事件会触发事件转发规则,您必须配置条件。
- 标记:所有规则均由必须在规则中指定的事件触发,例如
-
数据元素标记化:
-
标记:数据元素名称使用
%
(在规则中使用时,位于数据元素名称的开始和结尾)。 例如:%viewportHeight%
。 -
事件转发:数据元素名称使用进行标记
{{
于开头及于年终}}
在数据元素名称的末尾。 例如:{{viewportHeight}}
。
-
-
规则操作顺序:
- 事件转发规则的“操作”部分始终按顺序执行。 保存规则时,请确保操作顺序正确。 无法像对标记执行操作一样异步执行此执行序列。
要配置用于将数据转发到webhook的规则,您必须先获取个人webhook:
-
转到 Webhook.site
-
查找 您的唯一URL,可将其用作URL请求
-
选择 复制到剪贴板
-
保持此窗口处于打开状态,因为您将能够验证Webhook实时捕获的事件转发数据
-
返回 数据收集 > 事件转发 > 规则 从左侧导航
-
选择 创建新规则
-
将其命名为
all events - ad cloud connector - webhook
-
添加操作
-
下 扩展名,选择 Adobe云连接器
-
下 操作类型,选择 进行Fetch调用
-
将Webhook URL粘贴到 URL 字段
-
下 [查询参数],您将添加之前创建的两个数据元素。
-
在 键 中的列类型
viewPortHeight
. 在 值 列中,输入{{environment.browserDetails.viewportHeight}}
键入数据元素或从数据元素选择器图标中进行选择 -
选择 +添加另一个 添加另一个查询参数
-
在 键 中的列类型
ecid
. 在值列中,输入{{ecid}}
数据元素 -
选择 保留更改
-
您的规则应如下所示
-
选择 保存
创建并生成库
创建一个库并生成对事件转发开发环境的所有更改,就像在标记属性中通常所做的那样。
验证事件转发规则
现在,您可以使用Platform Debugger和Webhook.site验证事件转发属性:
-
在重新加载页面之前,会打开Experience Platform调试器 日志 从左侧导航
-
选择 Edge 选项卡,然后选择 连接 查看平台Edge Network请求
-
重新加载页面
-
您将看到其他请求,这些请求使您能够了解平台Edge Network发送到WebHook的服务器端请求
-
需要重点验证的请求是显示由Edge网络发送的完全构建的URL的请求
-
请注意viewPortHeight和ecid查询字符串参数
-
它们与XDM对象中看到的数据匹配
-
最后,验证中的数据匹配 Webhook.site 以及查看打开的Webhook窗口
恭喜!您已配置事件转发!