数据收集端到端概述
Adobe Experience Platform收集您的数据并将这些数据传输到其他Adobe产品和第三方目标。 要将应用程序中的事件数据发送到Experience PlatformEdge Network,请务必了解这些核心技术以及如何配置这些技术,以在需要时将数据交付到所需的目的地。
本指南提供了有关如何使用Platform的数据收集功能通过Edge Network发送事件的高级教程。 具体而言,本教程将介绍在数据收集UI(以前称为Adobe Experience Platform Launch)中安装和配置Adobe Experience Platform Web SDK标记扩展的步骤。
先决条件
本教程使用数据收集UI创建架构、配置数据流和安装Web SDK。 要在UI中执行这些操作,必须至少向您授予一个Web属性的访问权限以及以下属性权限:
- 开发
- 管理扩展
请参阅有关管理数据收集的权限的指南,了解如何授予对属性和属性权限的访问权限。
要使用本指南中提到的各种数据收集产品,您还必须有权访问数据流,并能够创建和管理架构。 如果您需要访问其中任何一项功能,请联系您的Adobe帐户团队以帮助您获得必要的访问权限。 请注意,如果您尚未购买Adobe Experience Platform,Adobe将为您提供免费使用SDK所需的访问权限。
如果您已经有权访问Platform,则必须确保已启用以下类别下的所有权限:
- 数据建模
- 标识
请参阅访问控制UI概述,了解如何向用户授予Platform功能的权限。
流程摘要
为您的网站配置数据收集的过程可概括如下:
- 创建架构以确定将数据发送到Edge Network时如何构建数据。
- 创建数据流以配置要将数据发送到哪些目标。
- 安装并配置Web SDK,以便在网站上发生某些事件时将数据发送到数据流。
如果贵组织拥有事件转发的许可证,则在能够向Edge Network发送数据后,您也可选择配置事件转发。
创建架构 schema
体验数据模型(XDM)是一个开源规范,为架构形式的数据提供通用结构和定义。 换句话说,XDM是一种以可由Edge Network和其他Adobe Experience Cloud应用程序操作的方式构造和格式化您的数据的方式。
设置数据收集操作的第一步是创建XDM架构来表示您的数据。 在本教程的后一步中,您将将要发送的数据映射到此架构的结构。
在UI的左侧导航中选择 架构。 从这里,您可以看到以前创建的属于贵组织的架构列表。 若要继续,请选择 创建架构,然后从下拉菜单中选择 XDM ExperienceEvent。
将出现一个对话框,提示您开始向架构添加字段组。 要使用Web SDK发送事件,您必须添加字段组 AEP Web SDK ExperienceEvent Mixin。 此字段组包含由Web SDK库自动收集的数据属性的定义。
使用搜索栏缩小列表范围有助于更轻松地查找此字段组。 找到后,请先从列表中选择它,然后选择 添加字段组。
此时将显示架构画布,其中显示XDM架构的树结构,包括Web SDK字段组提供的字段。
选择树中的根字段以打开右边栏中的 架构属性,您可以在其中提供架构的名称和可选描述。
如果要向架构添加更多字段,可以通过选择左边栏中 字段组 部分下的 添加 来执行该操作。
添加所需的字段后,选择 保存 以保存架构。
创建数据流 datastream
数据流是一种配置,用于告知Edge Network您希望将数据发送到何处。 具体而言,数据流指定要将数据发送到哪些Experience Cloud产品,以及您希望如何处理和存储每个产品中的数据。
在左侧导航中选择 数据流。 在此处,您可以从列表中选择要编辑的现有数据流,也可以通过选择 新建数据流 来创建新的配置。
数据流的配置要求取决于要将数据发送到的产品和功能。 有关每个产品的配置选项的详细信息,请参阅数据流概述。
安装和配置Web SDK install
创建架构和数据流后,下一步是安装和配置Platform Web SDK以开始向Edge Network发送数据。
该过程可概括如下:
- 在标记属性上安装Adobe Experience Platform Web SDK以访问其功能。
- 创建XDM对象数据元素以将网站上的变量映射到您之前创建的XDM架构的结构。
- 创建规则以告知SDK应何时将数据发送到Edge Network。
- 生成并安装库以在您的网站上实施该规则。
在标记属性上安装SDK install-sdk
在左侧导航中选择 标记 以显示标记属性列表。 您可以根据需要选择要编辑的现有属性,也可以选择 新建属性。
如果创建新属性,请提供描述性名称并将Platform设置为 Web。 提供Web属性的完整域,然后选择 保存。
此时会显示该资产的概述页面。 在此处,在左侧导航中选择 扩展,然后选择 目录。 查找Platform Web SDK的列表(可以选择使用搜索栏缩小结果范围),然后选择 安装。
此时将显示SDK的配置页面。 大多数必需值都会自动填充默认值,您可以根据需要选择更改这些默认值。
但是,在安装SDK之前,您必须选择一个数据流,以便它知道要将您的数据发送到何处。 在 数据流 下,使用下拉菜单选择您在之前的步骤中配置的数据流。 设置数据流后,选择 保存 以完成将SDK安装到资产。
创建XDM数据元素 data-element
为了使SDK将数据发送到Edge Network,该数据必须映射到您在上一步中创建的XDM架构。 此映射通过使用数据元素来完成。
在UI中,选择 数据元素,然后选择 新建数据元素。
在下一个屏幕上,选择扩展下拉菜单下的 Adobe Experience Platform Web SDK,然后为数据元素类型选择 XDM对象。
此时会出现XDM对象类型的配置对话框。 该对话框会自动选择您的Platform沙盒,在这里,您可以看到在该沙盒中创建的所有架构。 从列表中选择您之前创建的XDM架构。
此时将显示架构的结构。 所有带有星号(*)的字段都表示事件触发时将自动填充的字段。 对于所有其他字段,您可以浏览架构的结构并填写其余数据。
%
)括起来),将其从网站(cartAbandonsTotal
)的客户端映射到XDM字段。完成将数据映射到架构后,请先提供数据元素的名称,然后再选择 保存。
创建规则
保存数据元素后,下一步是创建一个规则,每当网站上发生特定事件(例如,当客户将产品添加到购物车时)时,该规则就会将其发送到Edge Network。
您可以为网站上发生的几乎任何事件设置规则。 例如,本节将演示如何创建客户提交表单时将触发的规则。 以下HTML表示具有“添加到购物车”表单的简单网页,该表单将是规则的主题:
<!DOCTYPE html>
<html>
<body>
<form id="add-to-cart-form">
<label for="item">Product:</label><br>
<input type="text" id="item" name="item"><br>
<label for="amount">Amount:</label><br>
<input type="number" id="amount" name="amount" value="1"><br><br>
<input type="submit" value="Add to Cart">
</form>
</body>
</html>
在数据收集UI中,在左侧导航中选择 规则,然后选择 创建新规则。
在下一个屏幕上,提供规则的名称。 在此,下一步是确定规则的事件(换句话说,规则将触发的时间)。 选择事件下的 添加。
此时将显示事件配置页面。 要配置事件,必须首先选择事件类型。 事件类型由扩展提供。 要设置“表单提交”事件,例如,选择 Core 扩展,然后在 表单 类别下选择 提交 事件类型。
表单提交事件允许您使用CSS选择器引用要触发的规则的特定元素。 在下面的示例中,使用了ID add-to-cart-form
,因此此规则仅在“添加到购物车”表单中触发。 选择 Keep Changes 以将事件添加到规则。
此时将重新显示规则配置页面,其中显示该事件已添加。 您可以通过向规则添加更多条件来缩小"If"的范围。
否则,下一步是添加一个操作,以便规则在触发时执行。 选择 操作 下的 添加 以继续。
此时将显示操作配置页面。 若要获取将数据发送到Edge Network的规则,请为扩展选择 Adobe Experience Platform Web SDK,为操作类型选择 发送事件。
屏幕将更新,以显示用于配置发送事件操作的其他选项。 在 类型 下,您可以提供自定义类型值以填充eventType
XDM字段。 在 XDM数据 下,提供您之前创建的XDM数据类型的名称(由百分比符号括起来),或者选择数据库图标(
)以从列表中选择它。 这是最终将发送到Edge Network的数据。
完成时选择 保留更改。
配置完规则后,选择 保存 以完成该过程。
生成并安装库 library
配置规则后,您可以将其添加到标记库,将该库构建到环境,并在您的网站上安装该版本。
要了解如何创建库、将扩展和规则添加到库以及将该库生成到环境,请参阅标记文档中的管理库指南。 创建库时,请确保包含Platform Web SDK扩展以及您之前创建的数据收集规则。
创建库并将其内部版本分配给环境后,便可以在网站的客户端上安装该环境。 有关详细信息,请参阅有关安装环境的部分。
在网站上安装环境后,您可以使用Adobe Experience Platform Debugger测试实施。
配置事件转发(可选) event-forwarding
在将SDK配置为将数据发送到Edge Network后,您可以设置事件转发,以告知Edge Network您希望将数据发送到何处。
要使用事件转发,必须先创建事件转发属性。 在左侧导航中选择 事件转发,然后选择 新建属性。 在选择 保存 之前提供属性的名称。
创建事件转发属性后,下一步就是创建一个规则以确定发送数据的位置。 事件转发属性的规则的构建方式与标记属性非常相似,只是不能指定任何事件(因为事件转发仅处理它直接从数据流接收的事件)。 对于规则的操作,您可以使用某个可用的事件转发扩展,也可以使用自定义代码来交付事件。
与之前类似,配置规则后,必须将其添加到库并将该库生成到环境。
生成完成后,最后一步是更新您之前配置的数据流并启用事件转发。 要开始,请导航到 数据流 并从列表中选择相关的数据流。 从此处,启用事件转发的切换开关,并提供刚刚配置的属性和环境的名称。
后续步骤
本指南提供了有关如何使用Platform Web SDK向Edge Network发送数据的高级端到端概述。 请参阅本指南中链接的文档,了解有关所涉及各种组件和服务的更多信息。