数据收集端到端概述

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

本指南提供了有关如何使用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
请参阅指南,网址为 添加字段组 详细步骤,了解如何搜索不同的字段组以适合您的用例。
最佳实践为计划通过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

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

属性

如果创建新资产,请提供描述性名称并设置 平台 到 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中,选择 规则 在左侧导航中,然后选择 创建新规则.

规则

在下一个屏幕上,提供规则的名称。 在此,下一步是确定规则的事件(换句话说,规则将触发的时间)。 选择 添加 下 活动.

命名规则

此时将显示事件配置页面。 要配置事件,必须首先选择事件类型。 事件类型由扩展提供。 例如,要设置“表单提交”事件,请选择 核心 扩展,然后选择 提交 事件类型位于 表单 类别。

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

利用表单提交事件,可使用 CSS选择器 引用要触发的规则的特定元素。 在以下示例中,ID add-to-cart-form 使用此规则,以使其仅在“添加到购物车”表单中触发。 选择 保留更改 以将事件添加到规则。

事件配置

此时将重新显示规则配置页面,其中显示该事件已添加。 您可以缩小"如果”,向规则添加更多条件。

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

添加操作

此时将显示操作配置页面。 要获取将数据发送到边缘网络的规则,请选择 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