通过Web SDK引入数据
本快速入门指南介绍了如何使用 Adobe Experience Platform Web SDK 和 Edge Network 将网站跟踪数据直接引入 Adobe Experience Platform,然后在 Customer Journey Analytics 中使用该数据。
要完成此实施,您需要:
-
在 Adobe Experience Platform 中 设置模式和数据集 ,以定义要收集的数据的模型(模式)以及实际收集数据的位置(数据集)。
-
设置数据流 以配置 Adobe Experience Platform Edge Network,将您收集的数据路由到您在 Adobe Experience Platform 中配置的数据集。
-
使用标签 可以根据网站数据层中的数据轻松配置规则和数据元素。然后确保数据发送到在 Adobe Experience Platform Edge Network 上配置的数据流。
-
部署和验证。拥有一个可以迭代标签开发的环境,一旦所有内容都经过验证,就可以在您的生产环境中实时发布。
-
在 Customer Journey Analytics 中 设置连接。此连接应(至少)包含 Adobe Experience Platform 数据集。
-
在 Customer Journey Analytics 中 设置数据视图 以定义要在 Analysis Workspace 中使用的量度和维度。
-
在 Customer Journey Analytics 中 设置一个项目 以构建报告和可视化图表。
设置模式和数据集
要将数据摄取到Adobe Experience Platform,您必须首先定义要收集的数据。 引入 Adobe Experience Platform 的所有数据都必须符合标准的非规范化结构,以便下游功能和特性对其进行识别和操作。体验数据模型 (XDM) 是以模式形式提供此结构的标准框架。
定义模式后,您可以使用一个或多个数据集来存储和管理数据集合。数据集是用于数据集合(通常是表)的存储和管理结构,其中包含架构(列)和字段(行)。
摄取到 Adobe Experience Platform 中的所有数据都必须符合预定义的模式,然后才能作为数据集保存。
设置模式
您希望从访问您网站的配置文件中跟踪一些最小数据,例如页面名称、标识。
您必须首先定义一个模式来模拟此数据。
设置您的模式:
-
在 Adobe Experience Platform UI 的左边栏中,选择数据管理中的 模式。
-
选择 创建架构。
. -
在“创建模式”向导的“选择类”步骤中:
-
选择 体验事件。
note info INFO 体验事件架构用于为配置文件的_行为_建模(如场景名称、要添加到购物车的按钮)。 个人配置档案模式用于对个人配置档案_属性_(如姓名、电子邮件、性别)建模。 -
选择 下一步。
-
-
在创建架构向导的名称和审核步骤中:
-
为您的架构输入 架构显示名称 和(可选)描述。
-
选择 完成。
-
-
在示例架构的结构选项卡中:
-
在字段组中选择 + 添加。
字段组是可重用的对象和属性集合,可让您轻松扩展模式。
-
在添加字段组对话框中,从列表中选择 AEP Web SDK ExperienceEvent 字段组。
您可以选择预览按钮,以查看属于该字段组的字段的预览,例如
web > webPageDetails > name
。选择 返回 关闭预览。
-
选择 添加字段组。
-
-
在结构面板中选择模式名称旁边的 +。
-
在 字段属性 面板中,输入
Identification
作为名称,Identification 作为 Display name,选择 Object 作为 Type 和选择 ExperienceEvent Core v2.1 作为 Field Group。note note NOTE 如果该字段组不可用,请查找另一个包含标识字段的字段组。 或者创建新的字段组和将新的标识字段(如 ecid
、crmId
和其他您需要的字段)添加到该字段组,并选择该新字段组。标识对象将标识功能添加到架构中。 对于您自己的网站,您需要使用Experience CloudID和电子邮件地址来识别访问您网站的用户档案。 还有许多其他属性可用于跟踪您的人员标识(例如客户ID、忠诚度ID)。
选择 应用 将此对象添加到您的模式中。
-
选择刚刚添加的标识对象中的 ecid 字段,选择 标识 和 主要标识 和 ECID 来自右侧面板中的 标识命名空间 列表。
您将 Experience Cloud Identity 指定为 Adobe Experience Platform Identity 服务可用于组合(缝合)具有相同 ECID 的配置文件行为的主要身份。
选择 应用。您会看到 ecid 属性中出现指纹图标。
-
选择刚刚添加的标识对象中的 邮件 字段,选择 标识 和 邮件 和 标识命名空间 列表中的 字段属性 面板。
您将电子邮件地址指定为 Adobe Experience Platform Identity 服务可用于组合(拼接)配置文件行为的另一个标识。
选择 应用。您会看到电子邮件属性中显示指纹图标。
选择 保存。
-
选择显示模式名称的模式的根元素,然后选择 配置文件 开关。
系统会提示您启用配置文件的模式。一旦启用,当数据被引入基于此模式的数据集中时,该数据将合并到实时客户配置文件。
有关详细信息,请参阅启用模式以在实时客户配置文件中使用。
note important IMPORTANT 一旦您保存了为配置文件启用的模式,就不能再为配置文件禁用它。 -
选择 保存 以保存模式。
您已经创建了一个最小模式,用于对您可以从您的网站捕获的数据进行建模。该模式允许使用 Experience Cloud Identity 和电子邮件地址来识别配置文件。通过启用配置文件模式,您可以确保从您的网站捕获的数据被添加到实时客户配置文件中。
除了行为数据之外,您还可以从您的站点捕获配置文件属性数据(例如订阅时事通讯的配置文件的详细信息)。
要捕获此配置文件数据,您需要:
-
基于 XDM 个人配置文件类创建模式。
-
将 Profile Core v2 字段组添加到模式中。
-
添加基于 Profile Core v2 字段组的标识对象。
-
将Experience CloudID定义为主标识符,将电子邮件定义为标识符。
-
为配置文件启用模式
请参阅在 UI 中创建和编辑模式,了解有关向模式添加和删除字段组和单个字段的更多信息。
设置数据集
使用您的模式,您已经定义了数据模型。现在,您必须定义构建来存储和管理这些数据,这通过数据集来完成。
设置您的数据集
-
在 Adobe Experience Platform UI 的左边栏中,选择数据管理中的 数据集。
-
选择 创建数据集。
-
选择 使用模式创建数据集。
。
-
选择您之前创建的模式,然后选择 下一个。
-
为您的数据集命名并(可选)提供描述。
-
选择 完成。
-
选择 配置文件 开关
系统会提示您启用配置文件的数据集。启用后,数据集会使用其摄取的数据丰富实时客户配置文件。
note important IMPORTANT 只有当数据集所依附的模式也为配置文件启用时,您才能为配置文件启用数据集。
有关如何查看、预览、创建和删除数据集的更多信息,请参阅数据集 UI 指南。以及如何为实时客户配置文件启用数据集。
设置数据流
数据流表示实施 Adobe Experience Platform Web 和移动 SDK 时的服务器端配置。使用 Adobe Experience Platform SDK 收集数据时,数据会发送到 Adobe Experience Platform Edge Network。它是确定数据转发到哪些服务的数据流。
在您的设置中,您希望将从网站收集的数据发送到 Adobe Experience Platform 中的数据集。
设置您的数据流
-
在 Adobe Experience Platform UI 的左边栏中,选择 数据收藏集 中的 数据流。
-
选择 新数据流。
-
命名并描述您的数据流。从 事件模式 列表中选择您的模式。
-
选择 保存。
-
选择 添加服务。
-
在 添加服务屏幕:
-
从 服务 列表中选择 Adobe Experience Platform。
-
确保选择 Enabled。
-
从 事件数据集 列表中选择您的数据集。
-
保留其他设置并选择 保存 以保存数据流。
-
您的数据流现已配置为将从您的网站收集的数据转发到 Adobe Experience Platform 中的数据集。
有关如何配置数据流和如何处理敏感数据的更多信息,请参阅数据流概述。
使用标签
要在您的网站上实施代码以实际收集数据,请使用Adobe Experience Platform中的标记功能。 这一款标记管理解决方案,可让您在满足其他标记要求的同时部署代码。标签使用 Adobe Experience Platform Web SDK 扩展提供与 Adobe Experience Platform 的无缝集成。
创建您的标记
-
在 Adobe Experience Platform UI 的左边栏中,选择 数据收藏集 中的 标签。
-
选择 新属性。
为标签命名,选择 Web 并输入域名。选择 保存 继续。
配置您的标签
创建标记后,必须使用正确的扩展对其进行配置,并根据要跟踪网站并将数据发送到Adobe Experience Platform的方式配置数据元素和规则。
从 标签属性 列表中选择您新创建的标签以将其打开。
扩展
为确保您能够将数据发送到Adobe Experience Platform(通过数据流),请将Adobe平台Web SDK扩展添加到您的标记中。
创建并配置 Adobe Experience Platform Web SDK。
-
选择左边栏中的 扩展。
-
在顶部栏中选择 目录。
-
搜索或滚动到 Adobe Experience Platform Web SDK 扩展,然后选择 安装 进行安装。
{width="35%"}
-
选择您的沙盒和您之前为您的生产环境和(可选)暂存环境和创建的数据流开发环境。
选择 保存。
有关详细信息,请参阅配置 Adobe Experience Platform Web SDK 扩展。
Web SDK本身包含Adobe Experience Cloud ID服务,因此您无需将ID服务扩展添加到标记中。
数据元素
数据元素是数据词典(或数据映射)的构建块。使用数据元素可跨市场营销和广告技术收集、组织和交付数据。您可以在标记中设置从数据层读取的数据元素,并可用于将数据传送到 Adobe Experience Platform。
有不同类型的数据元素。您首先设置一个数据元素来捕获访客在您的网站上查看的页面名称。
定义页面名称数据元素:
-
选择左边栏中的 数据元素。
-
选择 添加数据元素。
-
在创建数据元素对话框中:
-
为数据元素命名,例如,
Page Name
。 -
从扩展列表中选择 核心
-
从 数据元素类型列表中选择 页面信息。
-
从属性 列表中选择 标题
或者您可以使用数据层变量中的值,例如
pageName
和 JavaScript 变量数据元素类型来定义数据元素。 -
选择 保存。
-
您现在想要设置一个引用 Experience Cloud ID 的数据元素,该 ID 由 Adobe Experience Platform Web SDK 自动提供,可通过 Experience Cloud ID 服务扩展使用。
要定义 ECID 数据元素:
-
选择左边栏中的 数据元素。
-
选择 添加数据元素。
-
在创建数据元素对话框中:
-
为数据元素命名,例如,
ECID
。 -
从扩展 列表中选择 Experience Cloud ID 服务。
-
从 数据元素类型列表中选择 ECID。
-
选择 保存。
-
最后,您现在希望将任何特定的数据元素映射到先前定义的模式。您可以定义另一个数据元素,它提供 XDM 模式的表示。
要定义 XDM 对象数据元素:
-
选择左边栏中的 数据元素。
-
选择 添加数据元素。
-
在创建数据元素对话框中:
-
为数据元素命名,例如,
XDM - Page View
。 -
从 扩展列表中选择 Adobe Experience Platform Web SDK。
-
从数据元素类型列表中选择 XDM 对象。
-
从您的沙盒列表中选择沙盒。
-
从您的模式列表中选择模式。
-
将模式中定义的
identification > core > ecid
属性映射到 ECID 数据元素。选择圆柱体图标可以轻松地从数据元素列表中拾取 ECID 数据元素。 -
将模式中定义的
web > webPageDetails > name
属性映射到页面名称数据元素。 -
选择 保存。
-
规则
Adobe Experience Platform 中的标签遵循基于规则的系统。他们寻找用户交互和相关数据。如果满足您的规则中所列的标准,则规则会触发您已识别的扩展、脚本或客户端代码。您可以使用规则使用 Adobe Experience Platform Web SDK 扩展将数据(如 XDM 对象)发送到 Adobe Experience Platform。
去定义规则
-
选择左边栏中的 规则。
-
选择 创建新规则。
-
在创建规则对话框中:
-
命名规则,例如
Page View
。 -
选择并在事件下方 +添加
-
在事件配置对话框中:
-
从扩展列表中选择 核心
-
从事件类型 列表中选择 加载的窗口
-
选择 保留更改。
-
-
选择并在操作下方 +添加
-
在操作配置对话框中:
-
从 扩展列表中选择 Adobe Experience Platform Web SDK。
-
从操作类型 列表中选择 发送事件
-
从 类型列表中选择 web.webpagedetails.pageViews。
-
选择 XDM 数据旁边的圆柱体图标,然后从数据元素列表中选择 XDM - 页面视图。
- 选择 保留更改。
-
-
您的规则应如下所示:
-
选择 保存。
-
以上只是定义规则的一个示例,该规则会将XDM数据(包含来自其他数据元素的值)发送到Adobe Experience Platform。
您可以在标记中以各种方式使用规则来操作变量(使用数据元素)。
有关详细信息,请参阅规则。
生成并发布标签
定义数据元素和规则后,必须构建和发布标记。 创建库生成时,必须将其分配给环境。然后,将会编译该内部版本的扩展、规则和数据元素,并将这些内容放入分配的环境。每个环境都提供了一个唯一的嵌入代码,从而允许您将其分配的内部版本集成到网站中。
要生成并发布您的标签:
-
从左边栏中选择 发布流。
-
选择 选择工作库,然后选择 添加库…。
-
在创建库对话框中:
-
命名库。
-
选择 开发(开发) 环境 列表。
-
选择 + 添加所有更改的资源。
-
选择 保存并生成到开发。
您的标记已保存,并为开发环境构建。 绿色圆点表示在开发环境中成功构建了标记。
-
-
您可以选择 … 重建库或将库移动到临时或生产环境。
Adobe Experience Platform 标签支持简单到复杂的发布工作流,这些工作流应适合您部署 Adobe Experience Platform Web SDK。
有关详细信息,请参阅 发布概述 。
检索您的标签代码
最后,您必须在要跟踪的网站上安装标记,这表示要在网站模板的标题标记中放置代码。
要获取引用标签的代码,请执行以下操作:
-
选择左边栏中的 环境。
-
从环境列表中,选择正确的安装(框)按钮。
在 Web 安装说明对话框中,选择脚本代码旁边的复制按钮,其内容如下:
code language-none <script src="https://assets.adobedtm.com/2a518741ab24/.../launch-...-development.min.js" async></script>>
-
选择 关闭。
您可以根据部署 Adobe Experience Platform Web SDK 的位置选择另一个环境(暂存、生产),而不是开发环境的代码。
有关详细信息,请参阅 环境 。
部署和验证
现在,您可以在<head>
标签内的网站开发版本上部署代码。部署后,您的网站开始将数据收集到 Adobe Experience Platform 中。
验证您的实现,在必要时进行更正,更正后,使用标签的发布工作流功能将其部署到您的暂存和生产环境中。
设置连接
要在 Customer Journey Analytics 中使用 Adobe Experience Platform 数据,您需要创建一个连接,其中包含因设置模式、数据集和工作流所产生的数据。
通过创建连接,您可以将 Adobe Experience Platform 中的数据集集成到工作区中。要报告这些数据集,您必须首先在Adobe Experience Platform和Workspace中的数据集之间建立连接。
创建您的连接:
-
在 Customer Journey Analytics UI 中,选择顶部导航中的 连接。
-
选择 创建新连接。
-
在无标题连接屏幕中:
在连接设置中命名并描述您的连接。
从数据设置中的沙盒列表中选择正确的沙盒,并从平均每日事件数列表中选定每日事件数。
选择 添加数据集。
在添加数据集的选择数据集步骤中:
-
选择先前(
Example dataset
)创建的数据集以及要包含在连接中的任何其他数据集。 -
选择 下一步。
在添加数据集的设置数据集步骤中:
-
对于每个数据集:
-
在 Adobe Experience Platform 中,从在数据集模式中定义的可用身份中选择人员 ID。
-
从数据源类型列表中选择正确的数据源。如果指定 其他,则为您的数据源添加描述。
-
根据您的首选项设置 导入所有新数据 和 数据集回填现有数据。
-
-
选择 添加数据集。
选择 保存。
-
有关如何创建和管理连接以及如何选择和组合数据集的更多信息请参阅连接概述。
设置数据视图
数据视图是 Customer Journey Analytics 专属的容器,通过它,可决定如何解释来自连接的数据。 它指定所有可在 Analysis Workspace 中找到的维度和量度,以及这些维度和量度从哪些列获取其数据。为准备 Analysis Workspace 中的报告而定义数据视图。
创建您的数据视图:
-
在 Customer Journey Analytics UI 中,选择顶部导航中的 数据视图。
-
选择 创建新数据视图。
-
在配置步骤中:
从连接列表中选择您的连接。
名称并(可选)描述您的连接。
选择 保存并继续。
-
在组件步骤中:
将要包含的任何模式字段和/或标准组件添加到量度或维度组件框中。
选择 保存并继续。
-
在设置步骤中:
保持设置不变并选择 保存并完成。
请参阅数据视图概述,了解有关如何创建和编辑数据视图、哪些组件可供您在数据视图中使用以及如何使用过滤器和会话的更多信息设置。
设置项目
Analysis Workspace 是一个灵活的浏览器工具,允许您快速构建分析并基于数据共享见解。您可以使用工作区项目来组合数据组件、表和可视化,以制作分析并与组织中的任何人共享。
要创建您的项目:
-
在 Customer Journey Analytics UI 中,选择顶部导航中的 项目。
-
选择左侧导航中的 项目。
-
选择 创建项目。
选择 空白项目。
-
从列表中选择您的数据视图。
-
要创建您的第一个报告,请在面板的自由格式表上开始拖放维度和量度。 例如,拖动
Program Points Balance
以及Page View
作为量度和email
作为维度,以快速查看访问过您的网站并已加入忠诚度计划收集忠诚度点的个人资料。
请参阅 Analysis Workspace 概述,了解有关如何使用组件、可视化和面板创建项目和构建分析的更多信息。