事件转发

本指南介绍如何使用Adobe Experience Platform Edge Network实施服务器端事件转发。 它专为需要通过Edge Network将收集的实时事件数据分发到非Adobe目标（如第三方分析平台、云存储端点、广告网络或自定义Webhook）的解决方案架构师、营销技术人员和实施工程师而设计。

它提供了配置事件转发的所有可行方法，说明了它们之间的利弊，并提供了指向Adobe Experience League文档的链接以获取详细的过程指导。

用例概述

通过Adobe Experience Platform Web SDK、Mobile SDK或Server API收集行为数据的组织通常需要与非Adobe系统（如Google Analytics或Snowflake等分析平台、用于转化跟踪的广告网络、用于长期存储的数据仓库或自定义内部服务）共享该事件流。 传统上，这要求客户端标记激增，这会增加页面权重、引入延迟，并产生隐私和治理风险。

事件转发通过在Edge Network上操作服务器端解决了此问题。 当访客交互通过Web SDK或服务器API触发事件时，该事件通过数据流路由到Edge Network。 事件转发规则（在专用事件转发属性中配置）会评估传入事件数据并选择性地将其转发到一个或多个已配置的目标。 这种服务器端方法可减少客户端标记膨胀，提高页面性能，集中数据管理，并使组织能够准确地控制哪些数据离开Adobe生态系统。

此模式的目标受众包括已部署（或计划部署）用于数据收集的Adobe Experience Platform Web SDK或服务器API的组织，这些组织希望通过将事件数据分发到非Adobe端点来扩展该投资，而无需添加客户端JavaScript标记。

主要业务目标

此用例模式支持以下业务目标。

提高数据质量和改善管理

确保数据干净、完整且合规，以实现准确定位、减少浪费和可靠的分析。 事件转发可在服务器端集中数据分发，为组织提供单一控制点来管理与外部系统共享的数据，降低数据泄露的风险，并确保在数据离开Adobe Edge Network之前应用治理策略。

KPI：​效率，成本节约

有关详细信息，请参阅改进数据质量和管理。

整合营销技术并使其现代化

通过迁移到统一、可扩展的平台，减少工具碎片化和技术债务。 事件转发使组织能够使用一个服务器端数据分发机制替换多个客户端供应商标记，从而减少页面加载开销并简化技术栈栈。

KPI：​成本节约、效率、上市速度

有关详细信息，请参阅整合营销技术并使其现代化。

战术用例示例

以下是适用于此用例模式的常见战术情景。

关键绩效指标

以下KPI可帮助衡量此用例模式是否成功。

用例模式

本节介绍用于实施事件转发的模式和函数链。

事件转发 — 将通过Edge Network收集的实时事件数据转发到非Adobe目标以用于分析、存储或广告。

函数链：​数据流配置>事件规则定义>目标映射>转发执行>监视

应用程序

在此用例模式中使用以下应用程序。

基本函数

必须具备以下基本功能才能使用此用例模式。 对于每个函数，状态都指示它通常是必需的、假定为预配置还是不适用。

支持功能

以下功能增强此用例模式，但核心执行不需要这些功能。

应用程序功能

此计划从“应用程序功能目录”中练习以下功能。 函数会映射到实施阶段而不是编号步骤。

Adobe Experience Platform (AEP)

先决条件

确保在开始实施之前已满足以下条件。

实施选项

此部分介绍了实施事件转发的可用方法，并提供了有关选择正确选项的指导。

选项A：基于扩展的事件转发

最适合：​个使用受良好支持的目标平台的团队（Meta、Google、AWS、Azure、Snowflake等） 数据收集目录中提供了预置的事件转发扩展。

工作方式：

基于扩展的事件转发利用了由Adobe或第三方合作伙伴维护的预建集成。 每个扩展都是为特定目标专门构建的，可处理身份验证、有效负载格式和端点通信。 实施人员将安装事件转发属性中的扩展，配置身份验证凭据，并构建将XDM数据元素映射到扩展操作字段的规则。

此方法最大限度地减少了自定义开发，因为扩展可抽象出目标的API要求。 例如，Meta转化API扩展将XDM商业事件转换为Meta预期的格式，处理PII字段的哈希处理、重复数据删除参数和访问令牌管理。 同样，Google Cloud Platform或AWS扩展处理其各自云服务的身份验证和有效负载格式。

扩展可用性决定了支持的目标，这是一个权衡问题。 如果目标目标目标不存在扩展，则必须使用选项B（自定义Webhook）。

关键注意事项：

优点：

限制：

Experience League：

选项B：自定义webhook（获取API）事件转发

最适合：​需要将事件转发到没有预建扩展的目标，或需要完全控制HTTP请求有效负载、标头和身份验证机制的团队。

工作方式：

自定义基于webhook的事件转发使用Adobe Cloud Connector扩展（默认包含）向任何端点发出任意HTTP请求。 实施人员定义数据元素以提取和转换传入XDM事件的值，然后使用云连接器的“发出获取调用”操作类型配置规则操作。 此操作允许完全控制HTTP方法、URL、标头和请求正文。

请求正文通常使用数据元素和自定义代码构造，以根据目标的API规范设置有效负荷的格式。 此方法支持任何可通过HTTP访问的端点（REST API、Webhook、云函数或内部服务），使其成为最灵活的选项。

取舍是加大实施工作量和持续维护。 实施者必须了解目标API，手动处理身份验证（例如，设置授权标头，管理令牌刷新），并在目标API发展时保持有效负载格式。

关键注意事项：

优点：

限制：

Experience League：

选项C：混合（扩展+自定义Webhook）

最适合：​组织将事件转发到多个目标，其中某些目标具有预建扩展，而其他目标需要自定义集成。

工作方式：

混合方法结合了对支持良好的目标进行的基于扩展的转发，以及对缺少扩展的目标进行的自定义webhook操作。 单个事件转发属性包含多个规则 — 一些规则使用扩展操作（例如，用于广告转化跟踪的Meta转化API扩展），另一些规则使用Cloud Connector获取操作（例如，转发到内部数据湖端点）。

此方法可最大程度地扩大覆盖范围，同时最大限度地减少不必要的自定义开发。 每个规则都独立运行，因此基于扩展的规则受益于预建的有效负载格式，而自定义规则保持完全的灵活性。

关键注意事项：

优点：

限制：

Experience League：

选项比较

下表比较了三个实施选项。

选择正确的选项

首先，清点目标目标并检查每个目标中是否存在预建的事件转发扩展。

实施阶段

以下阶段描述了事件转发的端到端实施流程。

阶段1：数据流配置

应用程序函数： AEP：数据流配置

要配置的内容：​一个数据流，用于接收来自Web SDK、Mobile SDK或Server API实施的事件，并将它们路由到Edge Network，事件转发规则可以在其中处理它们。 如果要将事件转发添加到现有数据收集部署，则将在现有数据流上启用事件转发。

此阶段中的​决策点：

用户界面导航： Experience Platform >数据收集>数据流>选择或创建数据流

密钥配置详细信息：

Experience League文档：

阶段2：事件转发属性和扩展

应用程序函数： AEP：事件转发属性安装程序

您将配置的内容：​数据收集UI中的事件转发属性，以及目标目标所需的扩展。 事件转发属性是定义服务器端转发逻辑的所有规则、数据元素和扩展的容器。

此阶段中的​决策点：

UI导航： Experience Platform >数据收集>事件转发>创建属性（或选择现有）

密钥配置详细信息：

Experience League文档：

阶段3：事件规则定义

应用程序函数： AEP：事件规则定义，AEP：目标映射

您将配置的内容：​用于评估传入事件数据、应用条件以筛选应转发的事件，以及定义将数据发送到目标端点的操作的规则。 每个规则都包含条件（触发时间）和操作（要执行的操作）。 数据元素从XDM事件有效负载中提取并转换值，以在规则条件和操作配置中使用。

此阶段中的​决策点：

UI导航： Experience Platform >数据收集>事件转发>选择属性>数据元素/规则

密钥配置详细信息：

选项差异的位置：

选项A （基于扩展）的​：

使用目标扩展的预建操作类型配置规则操作。 例如，Meta转化API扩展提供了“发送事件”操作，可将XDM字段映射到Meta事件参数(event_name、event_time、user_data、custom_data)。 该扩展处理有效负载格式、散列和API通信。

选项B （自定义Webhook）的​：

使用Cloud Connector扩展的“发出获取调用”操作配置规则操作。 指定目标URL、HTTP方法（通常为POST）、请求标头（包括授权），并使用数据元素和/或自定义代码构建请求正文。 您负责精确匹配目标API的预期有效负载格式。

选项C （混合）的​：

为每个目标创建单独的规则。 基于扩展的规则使用扩展的操作类型；自定义规则使用云连接器获取调用。 所有规则都共存于同一属性中，并针对每个传入事件进行独立评估。

Experience League文档：

第4阶段：发布和激活

应用程序函数： AEP：转发执行

要配置的内容：​发布工作流程，用于提升从开发到暂存再到生产的事件转发规则。 事件转发使用与Tags相同的基于库的发布模型，以及环境和构建构件，这些构件可控制Edge Network中处于活动状态的配置。

此阶段中的​决策点：

UI导航： Experience Platform >数据收集>事件转发>选择属性>发布流

密钥配置详细信息：

Experience League文档：

第5阶段：监测和验证

应用程序函数： AEP：正在监视

您将配置哪些功能：​监视功能板和验证进程以确认事件转发成功、诊断故障以及维护事件转发部署的运行状况。

此阶段中的​决策点：

UI导航： Experience Platform >数据收集>事件转发>选择属性>监视

密钥配置详细信息：

Experience League文档：

实施注意事项

此部分涵盖在整个实施过程中要牢记的护栏、常见隐患、最佳实践和权衡取舍决策。

护栏和限制

常见陷阱

最佳实践

权衡决定

相关文档

以下资源提供了有关本指南涵盖的主题的更多详细信息。

事件转发

事件转发扩展

数据收集和Edge Network