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