数据收集端到端概述

Adobe Experience Platform收集您的数据并将这些数据传输到其他Adobe产品和第三方目标。 要将应用程序中的事件数据发送到Experience PlatformEdge Network,请务必了解这些核心技术以及如何配置这些技术,以在需要时将数据交付到所需的目的地。

本指南提供了有关如何使用Platform的数据收集功能通过Edge Network发送事件的高级教程。 具体而言,本教程将介绍在数据收集UI(以前称为Adobe Experience Platform Launch)中安装和配置Adobe Experience Platform Web SDK标记扩展的步骤。

NOTE
如果您不想使用标记,也可以选择手动安装和配置SDK,但周围的步骤仍必须按照以下所述完成。
所有涉及数据收集UI的步骤也可以在Experience PlatformUI中执行。

先决条件

本教程使用数据收集UI创建架构、配置数据流和安装Web SDK。 要在UI中执行这些操作,必须至少向您授予一个Web属性的访问权限以及以下属性权限

  • 开发
  • 管理扩展

请参阅有关管理数据收集的权限的指南,了解如何授予对属性和属性权限的访问权限。

要使用本指南中提到的各种数据收集产品,您还必须有权访问数据流,并能够创建和管理架构。 如果您需要访问其中任何一项功能,请联系您的Adobe帐户团队以帮助您获得必要的访问权限。 请注意,如果您尚未购买Adobe Experience Platform,Adobe将为您提供免费使用SDK所需的访问权限。

如果您已经有权访问Platform,则必须确保已启用以下类别下的所有权限

  • 数据建模
  • 标识

请参阅访问控制UI概述,了解如何向用户授予Platform功能的权限。

流程摘要

为您的网站配置数据收集的过程可概括如下:

  1. 创建架构以确定将数据发送到Edge Network时如何构建数据。
  2. 创建数据流以配置要将数据发送到哪些目标。
  3. 安装并配置Web SDK,以便在网站上发生某些事件时将数据发送到数据流。

如果贵组织拥有事件转发的许可证,则在能够向Edge Network发送数据后,您也可选择配置事件转发

创建架构 schema

体验数据模型(XDM)是一个开源规范,为架构形式的数据提供通用结构和定义。 换句话说,XDM是一种以可由Edge Network和其他Adobe Experience Cloud应用程序操作的方式构造和格式化您的数据的方式。

设置数据收集操作的第一步是创建XDM架构来表示您的数据。 在本教程的后一步中,您将将要发送的数据映射到此架构的结构。

NOTE
XDM架构非常可自定义。 下面列出的步骤不是过于规范化,而是专门针对Web SDK的架构要求。 在这些参数之外,您可以随意定义数据的其余结构。

在UI的左侧导航中选择​ 架构。 从这里,您可以看到以前创建的属于贵组织的架构列表。 若要继续,请选择​ 创建架构,然后从下拉菜单中选择​ XDM ExperienceEvent

架构工作区

将出现一个对话框,提示您开始向架构添加字段组。 要使用Web SDK发送事件,您必须添加字段组​ AEP Web SDK ExperienceEvent Mixin。 此字段组包含由Web SDK库自动收集的数据属性的定义。

使用搜索栏缩小列表范围有助于更轻松地查找此字段组。 找到后,请先从列表中选择它,然后选择​ 添加字段组

架构工作区

此时将显示架构画布,其中显示XDM架构的树结构,包括Web SDK字段组提供的字段。

模式结构

选择树中的根字段以打开右边栏中的​ 架构属性,您可以在其中提供架构的名称和可选描述。

命名架构

如果要向架构添加更多字段,可以通过选择左边栏中​ 字段组 ​部分下的​ 添加 ​来执行该操作。

添加字段组

NOTE
有关如何搜索不同的字段组以符合您的用例的详细步骤,请参阅XDM文档中有关添加字段组的指南。
最佳实践为计划通过Edge Network发送的数据仅添加字段。 将字段添加到架构并保存它后,只能对架构进行额外的更改。 有关详细信息,请参阅架构演化规则部分。

添加所需的字段后,选择​ 保存 ​以保存架构。

保存架构

创建数据流 datastream

数据流是一种配置,用于告知Edge Network您希望将数据发送到何处。 具体而言,数据流指定要将数据发送到哪些Experience Cloud产品,以及您希望如何处理和存储每个产品中的数据。

NOTE
如果要使用事件转发(假设您的组织已获得使用相关功能的许可),则必须以启用Adobe产品的相同方式,为数据流启用该功能。 有关此进程的详细信息,请参阅后面的部分

在左侧导航中选择​ 数据流。 在此处,您可以从列表中选择要编辑的现有数据流,也可以通过选择​ 新建数据流 ​来创建新的配置。

数据流

数据流的配置要求取决于要将数据发送到的产品和功能。 有关每个产品的配置选项的详细信息,请参阅数据流概述

安装和配置Web SDK install

创建架构和数据流后,下一步是安装和配置Platform Web SDK以开始向Edge Network发送数据。

NOTE
此部分使用数据收集UI来配置Web SDK标记扩展,但您也可以使用原始代码来安装和配置该扩展。 有关更多信息,请参阅以下指南:
另请注意,即使您只想使用事件转发,您仍必须按照相关说明安装和配置SDK,然后才能在后续步骤中配置事件转发。

该过程可概括如下:

  1. 在标记属性上安装Adobe Experience Platform Web SDK以访问其功能。
  2. 创建XDM对象数据元素以将网站上的变量映射到您之前创建的XDM架构的结构。
  3. 创建规则以告知SDK应何时将数据发送到Edge Network。
  4. 生成并安装库以在您的网站上实施该规则。

在标记属性上安装SDK install-sdk

在左侧导航中选择​ 标记 ​以显示标记属性列表。 您可以根据需要选择要编辑的现有属性,也可以选择​ 新建属性

属性

如果创建新属性,请提供描述性名称并将Platform设置为​ Web。 提供Web属性的完整域,然后选择​ 保存

创建属性

此时会显示该资产的概述页面。 在此处,在左侧导航中选择​ 扩展,然后选择​ 目录。 查找Platform Web SDK的列表(可以选择使用搜索栏缩小结果范围),然后选择​ 安装

安装Web SDK

此时将显示SDK的配置页面。 大多数必需值都会自动填充默认值,您可以根据需要选择更改这些默认值。

配置Web SDK

但是,在安装SDK之前,您必须选择一个数据流,以便它知道要将您的数据发送到何处。 在​ 数据流 ​下,使用下拉菜单选择您在之前的步骤中配置的数据流。 设置数据流后,选择​ 保存 ​以完成将SDK安装到资产。

设置数据流并保存

创建XDM数据元素 data-element

为了使SDK将数据发送到Edge Network,该数据必须映射到您在上一步中创建的XDM架构。 此映射通过使用数据元素来完成。

在UI中,选择​ 数据元素,然后选择​ 新建数据元素

创建新数据元素

在下一个屏幕上,选择扩展下拉菜单下的​ Adobe Experience Platform Web SDK,然后为数据元素类型选择​ XDM对象

XDM对象类型

此时会出现XDM对象类型的配置对话框。 该对话框会自动选择您的Platform沙盒,在这里,您可以看到在该沙盒中创建的所有架构。 从列表中选择您之前创建的XDM架构。

XDM对象类型

此时将显示架构的结构。 所有带有星号(*)的字段都表示事件触发时将自动填充的字段。 对于所有其他字段,您可以浏览架构的结构并填写其余数据。

将数据映射到XDM字段

NOTE
上面的屏幕截图演示了如何通过在值字段中引用全局可访问变量名称(由百分比符号(%)括起来),将其从网站(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 ​扩展,然后在​ 表单 ​类别下选择​ 提交 ​事件类型。

NOTE
有关AdobeWeb扩展提供的各种事件类型(包括如何配置它们)的更多信息,请参阅Adobe文档中的标记扩展引用

表单提交事件允许您使用CSS选择器引用要触发的规则的特定元素。 在下面的示例中,使用了ID add-to-cart-form,因此此规则仅在“添加到购物车”表单中触发。 选择​ Keep Changes ​以将事件添加到规则。

事件配置

此时将重新显示规则配置页面,其中显示该事件已添加。 您可以通过向规则添加更多条件来缩小"If"的范围。

否则,下一步是添加一个操作,以便规则在触发时执行。 选择​ 操作 ​下的​ 添加 ​以继续。

添加操作

此时将显示操作配置页面。 若要获取将数据发送到Edge Network的规则,请为扩展选择​ Adobe Experience Platform Web SDK,为操作类型选择​ 发送事件

操作类型

屏幕将更新,以显示用于配置发送事件操作的其他选项。 在​ 类型 ​下,您可以提供自定义类型值以填充eventType XDM字段。 在​ XDM数据 ​下,提供您之前创建的XDM数据类型的名称(由百分比符号括起来),或者选择数据库图标( 数据库图标 )以从列表中选择它。 这是最终将发送到Edge Network的数据。

完成时选择​ 保留更改

操作配置

配置完规则后,选择​ 保存 ​以完成该过程。

保存规则

生成并安装库 library

配置规则后,您可以将其添加到标记库,将该库构建到环境,并在您的网站上安装该版本。

NOTE
如果尚未在数据收集UI中设置环境,则必须先设置环境,然后才能创建内部版本。 有关详细信息,请参阅标记文档中有关为Web属性配置环境的部分。

要了解如何创建库、将扩展和规则添加到库以及将该库生成到环境,请参阅标记文档中的管理库指南。 创建库时,请确保包含Platform Web SDK扩展以及您之前创建的数据收集规则。

创建库并将其内部版本分配给环境后,便可以在网站的客户端上安装该环境。 有关详细信息,请参阅有关安装环境的部分。

在网站上安装环境后,您可以使用Adobe Experience Platform Debugger测试实施

配置事件转发(可选) event-forwarding

NOTE
事件转发仅适用于已获得相应许可的组织。

在将SDK配置为将数据发送到Edge Network后,您可以设置事件转发,以告知Edge Network您希望将数据发送到何处。

要使用事件转发,必须先创建事件转发属性。 在左侧导航中选择​ 事件转发,然后选择​ 新建属性。 在选择​ 保存 ​之前提供属性的名称。

创建事件转发属性后,下一步就是创建一个规则以确定发送数据的位置。 事件转发属性的规则的构建方式与标记属性非常相似,只是不能指定任何事件(因为事件转发仅处理它直接从数据流接收的事件)。 对于规则的操作,您可以使用某个可用的事件转发扩展,也可以使用自定义代码来交付事件。

事件转发规则

与之前类似,配置规则后,必须将其添加到库并将该库生成到环境。

生成完成后,最后一步是更新您之前配置的数据流并启用事件转发。 要开始,请导航到​ 数据流 ​并从列表中选择相关的数据流。 从此处,启用事件转发的切换开关,并提供刚刚配置的属性和环境的名称。

事件转发数据流

后续步骤

本指南提供了有关如何使用Platform Web SDK向Edge Network发送数据的高级端到端概述。 请参阅本指南中链接的文档,了解有关所涉及各种组件和服务的更多信息。

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1