使用Platform Web SDK数据设置事件转发

Last update: Thu Jul 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

初学者
中级
开发人员

了解如何使将事件转发功能与 Adobe Experience Platform Web SDK 数据一起使用。

事件转发是数据收集中可用的一种新属性。事件转发让您能够直接从Adobe Experience Platform Edge Network而不是传统的客户端浏览器向第三方非Adobe供应商发送数据。在事件转发概述中进一步了解事件转发的优势。

Web SDK和事件转发图

要在Adobe Experience Platform中使用事件转发，必须首先使用以下三个选项中的一个或多个将数据发送到Adobe Experience Platform Edge Network：

NOTE

Platform Web SDK和Platform Mobile SDK不需要通过标记进行部署，但是，建议使用标记来部署这些SDK。

完成本教程中之前的课程后，您应该使用Web SDK将数据发送到Platform Edge Network。数据传入Platform Edge Network中后，您可以启用事件转发并使用事件转发属性将数据发送到非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
选择保存。

配置数据流

对于事件转发，要使用您发送到Platform Edge Network的数据，必须将新创建的事件转发属性链接到用于将数据发送到Adobe解决方案的相同数据流。

要在数据流中配置Target，请执行以下操作：

转到数据收集接口
在左侧导航中，选择 数据流
选择之前创建的Luma Web SDK: Development Environment数据流
选择 添加服务
选择 事件转发 作为服务
在 属性ID 下拉列表下，选择您为事件转发属性提供的名称，在本例中为Server-Side - Web SDK Course

在 环境ID 下拉列表下，选择要将事件转发环境链接到的标记环境，在本例中为Development

note tip
TIP
若要将数据发送到Adobe组织之外的事件转发环境，请选择手动输入ID 并粘贴到ID中。此ID是在创建事件转发属性时提供的。

选择保存。

当您准备好通过发布流提升所做更改时，请为暂存和生产数据流重复这些步骤。

将数据从Platform Edge Network转发到非Adobe解决方案

在本练习中，您将学习如何设置事件转发数据元素、配置事件转发规则，以及使用名为Webhook.site的第三方工具进行验证。

NOTE

webhook是一种半实时地集成不同系统的方法。 Webhook.site是第三方工具，可让您轻松检查、测试和自动化（使用可视化自定义操作生成器或WebhookScript）任何传入的HTTP请求或电子邮件。

IMPORTANT

您必须已创建数据元素并将其映射到XDM对象，且已配置标记规则并在库中将这些更改构建到标记环境才能继续。如果没有，请参阅 先决条件 部分中的标记配置步骤。这些步骤可确保将数据发送到Platform Edge Network，并且您可从此处配置事件转发属性以将数据转发到非Adobe解决方案。

创建事件转发数据元素

您之前使用Platform Web SDK标记扩展配置的XDM对象将成为事件转发属性中数据元素的数据源。您可以使用已在标记属性中配置的数据作为事件转发的数据源。

IMPORTANT

在事件转发中引用XDM字段与其他上下文时，有一个关键语法差异。要在事件转发属性中引用数据，数据元素路径必须包含arc.event前缀：

其中，arc 表示 Adobe 响应上下文。
例如：arc.event.xdm.web.webPageDetails.URL

如果未正确指定此路径，则不会收集数据。

在本练习中，您将把浏览器视区高度和Experience Cloud ID从XDM对象转发到webhook。 XDM字段路径由配置XDM架构课程中创建的XDM架构确定。

TIP

您还可以通过使用Web浏览器网络工具、筛选/ee请求、打开信标 有效负载 并向下钻取到要查找的变量来查找XDM对象路径。然后，使用鼠标右键单击并选择“复制属性路径”。以下是浏览器视区高度的示例：
>

转到您最近创建的 事件转发 属性
在左侧导航中，选择 数据元素
选择以 创建新数据元素
名称数据元素environment.browserDetails.viewportHeight
在扩展下，离开CORE
在 数据元素类型 下，选择Path
键入包含浏览器视区高度arc.event.xdm.environment.browserDetails.viewportHeight的XDM对象路径
选择保存
创建另一个数据元素
名称，它ecid
在扩展下，离开CORE
在 数据元素类型 下，选择Path
键入包含Experience Cloud ID arc.event.xdm.identityMap.ECID.0.id的XDM对象路径

选择保存

事件转发ECID路径

note caution
CAUTION
确保在路径中包含`arc.event.`前缀。此外，请确保遵循与XDM对象字段名称完全相同的大小写 — ECID命名空间必须全部大写。

note tip
TIP
使用您自己的网站时，您可以使用Web浏览器网络工具找到XDM对象路径，过滤`/ee`请求，打开信标有效负载并向下钻取到要查找的变量。然后，使用鼠标右键单击并选择“复制属性路径”。以下是浏览器视区高度的示例：

安装Adobe云连接器扩展

若要将数据发送到第三方位置，您将首先安装Adobe Cloud Connector扩展。

在左侧导航中选择扩展
选择目录选项卡
搜索 Adobe Cloud Connector，选择安装

无需扩展配置。通过此扩展，您现在可以将数据转发到非Adobe解决方案！

创建事件转发规则

配置标记属性中的规则与事件转发属性中的规则有一些主要区别：

事件和条件：
- 标记：所有规则均由必须在规则中指定的事件触发，例如Library Loaded - Page Top。条件为可选。
- 事件转发：假定每个发送到Platform Edge Network的事件都是转发数据的触发器。因此，在事件转发规则中不能选择事件。要管理哪些事件会触发事件转发规则，您必须配置条件。
数据元素标记化：
- 标记：在规则中使用数据元素名称时，其开头和结尾分别使用%来标记数据元素名称。例如：%viewportHeight%。
- 事件转发：在规则中使用数据元素名称时，数据元素名称的开头以{{标记，结尾以}}标记。例如：{{viewportHeight}}。
规则操作序列：
- 事件转发规则的“操作”部分始终按顺序执行。保存规则时，请确保操作顺序正确。无法像对标记执行操作一样异步执行此执行序列。

要配置用于将数据转发到webhook的规则，您必须先获取个人webhook：

转到Webhook.site
查找 您的唯一URL，在事件转发规则中将此作为URL请求
选择 复制到剪贴板
保持此窗口处于打开状态，因为您将能够验证Webhook实时捕获的事件转发数据
从左侧导航中返回 数据收集 > 事件转发 > 规则
选择 创建新规则
将其命名为all events - ad cloud connector - webhook
添加操作
在扩展下，选择 Adobe云连接器
在 操作类型 下，选择 发出获取调用
将Webhook URL粘贴到 URL 字段中
在 [Query Params] 下，您将添加之前创建的两个数据元素。
在中的键viewPortHeight列类型上。在值列上，通过键入{{environment.browserDetails.viewportHeight}}数据元素或从数据元素选择器图标中进行选择来输入该数据元素
选择 +添加另一个 以添加另一个查询参数
在中的键ecid列类型上。在值列中，输入{{ecid}}数据元素
选择 保留更改
您的规则应如下所示
选择保存