摄取流数据

在本课程中,您将使用Adobe Experience Platform Web SDK来传输数据。

必须在数据收集界面中完成以下两个主要任务:

  • 我们必须在Luma网站上实施Web SDK,以将有关访客活动的数据从该网站发送到Adobe Edge网络。 我们将使用标记(以前称为Launch)进行简单的实施

  • 我们必须配置数据流,该数据流告知边缘网络将数据转发到何处。 我们将对其进行配置,以将数据发送到我们的 Luma Web Events 数据集。

数据工程师 将需要在本教程之外引入流数据。 实施Adobe Experience Platform的Web SDK或移动SDK时,通常由Web或移动开发人员参与数据层创建和标记属性配置。

在开始练习之前,请观看以下两个简短视频,以了解有关流数据摄取和Web SDK的更多信息:

注意

虽然本教程重点介绍使用Web SDK流式引入网站,但您也可以使用 AdobeMobile SDK, Apache Kafka Connect和其他机制。

所需权限

配置权限 课程中,您将设置完成本课程所需的所有访问控制。

配置数据流

首先,我们将配置数据流。 数据流在从Web SDK调用中接收数据后,会告知Adobe Edge网络要将其发送到何处。 例如,您要将数据发送到Experience Platform、Adobe Analytics还是Adobe Target? 数据流在数据收集用户界面(以前称为Launch)中进行管理,对于使用Web SDK进行数据收集至关重要。

创建 数据流:

  1. 登录 Experience Platform数据收集用户界面

  2. 选择 数据流 在左侧导航中

  3. 选择 新数据流 按钮

    在左侧导航中选择数据流

  4. 对于 友好名称,输入 Luma Platform Tutorial (如果您公司的多个人员参加了本教程,请将您的姓名添加到结尾)

  5. 选择 保存 按钮

    命名数据并保存

在下一个屏幕中,您可以指定要将数据发送到的位置。 要将数据发送到Experience Platform,请执行以下操作:

  1. 打开 Adobe Experience Platform 显示其他字段

  2. 对于 沙盒,选择 Luma Tutorial

  3. 对于 事件数据集,选择 Luma Web Events Dataset

  4. 如果您使用其他Adobe应用程序,请随时浏览其他部分,以了解这些其他解决方案的“边缘配置”中需要哪些信息。 请记住,Web SDK的开发不仅用于将数据流式传输到Experience Platform中,还用于替换其他Adobe应用程序使用的所有以前的JavaScript库。 边缘配置用于指定要将数据发送到的每个应用程序的帐户详细信息。

  5. 选择 保存

    配置数据流并保存

保存边缘配置后,生成的屏幕将显示已为开发、暂存和生产创建了三个环境。 可以添加其他开发环境:
每个边缘配置可以有多个环境
所有三个环境都包含您刚刚输入的平台详细信息。 但是,这些详细信息可以按环境进行不同的配置。 例如,您可以让每个环境将数据发送到不同的Platform沙盒。 在本教程中,我们不会对数据流进行任何其他自定义。

安装Web SDK扩展

添加资产

首先,我们必须创建标记属性(以前称为标记属性)。 资产是一个容器,可容纳从网页收集详细信息并将其发送到不同位置所需的所有JavaScript、规则和其他功能。

要创建资产,请执行以下操作:

  1. 转到 属性 在左侧导航中

  2. 选择 新建资产 按钮
    添加新资产

  3. 作为 名称,输入 Luma Platform Tutorial (如果您公司的多个人员参加了本教程,请将您的姓名添加到结尾)

  4. 作为 ,输入 enablementadobe.com (稍后解释)

  5. 选择 保存

    属性详细信息

添加Web SDK扩展

现在,您已拥有资产,可以使用扩展添加Web SDK。 扩展是用于扩展数据收集界面和功能的代码包。 添加该扩展:

  1. 打开标记资产
  2. 转到 扩展 在左侧导航中
  3. 转到 目录 选项卡
  4. 标记有许多可用的扩展。 使用术语筛选目录 Web SDK
  5. Adobe Experience Platform Web SDK 扩展中,选择 安装 按钮
    安装Adobe Experience Platform Web SDK扩展
  6. Web SDK扩展有多种可用配置,但我们仅将在本教程中配置两种。 更新 边缘域 to data.enablementadobe.com. 此设置允许您使用Web SDK实施设置第一方Cookie,我们鼓励您这样做。 在本课程的后面,您将在 enablementadobe.com 域。 的CNAME enablementadobe.com 域已配置为 data.enablementadobe.com 将转发到Adobe服务器。 在您自己的网站上实施Web SDK时,您需要创建一个CNAME以用于您自己的数据收集,例如, data.YOUR_DOMAIN.com
  7. 数据流 下拉菜单,选择 Luma Platform Tutorial 数据流。
  8. 请随时查看其他配置选项(但不要更改它们!) 然后选择 保存

创建用于发送数据的规则

现在,我们将创建一个规则以将数据发送到Platform。 规则是事件、条件和操作的组合,用于告知标记执行一些操作。 创建规则:

  1. 转到 规则 在左侧导航中
  2. 选择 创建新规则 按钮
    创建规则
  3. 将规则命名为 All Pages - Library Loaded
  4. 事件,选择 添加 按钮
    命名规则并添加事件
  5. 使用 核心 扩展 选择 Library Loaded(Page Top) 作为 事件类型. 此设置意味着,每当页面上加载Launch库时,都会触发我们的规则。
  6. 选择 保留更改 返回主规则屏幕
    添加Library Loaded事件
  7. 离开 条件 为空,因为我们希望此规则在所有页面上触发,就像我们为其提供的名称一样
  8. 操作,选择 添加 按钮
  9. 使用 Adobe Experience Platform Web SDK 扩展 选择 发送事件 作为 操作类型
  10. 在右侧,选择 web.webpagedetails.pageViews类型 下拉列表。 这是我们 Luma Web Events Schema
  11. 选择 保留更改 返回主规则屏幕
    添加Send Event操作
  12. 选择 保存 保存规则
    保存规则

在库中发布规则

接下来,我们将将该规则发布到我们的开发环境,以便我们能够验证该规则是否有效。

要创建库,请执行以下操作:

  1. 转到 发布流程 在左侧导航中
  2. 选择 添加库
    选择添加库
  3. 对于 名称,输入 Luma Platform Tutorial
  4. 对于 环境,选择 Development
  5. 选择 Add All Changed Resources 按钮。 (除 Adobe Experience Platform Web SDK 扩展和 All Pages - Library Loaded 规则中,您还将看到 核心 添加了扩展,其中包含所有Launch Web属性所需的基本JavaScript。)
  6. 选择 保存并构建以用于开发 按钮
    创建和构建库

库可能需要几分钟时间才能构建完成,它会在库名称左侧显示一个绿色圆点:
构建完成

如您在 发布流程 屏幕上,发布流程还有许多内容不在本教程的涵盖范围内。 我们将在开发环境中使用单个库。

验证请求中的数据

添加Adobe Experience Platform Debugger

Experience Platform调试器是适用于Chrome和Firefox浏览器的扩展,可帮助您查看在网页中实施的Adobe技术。 下载首选浏览器的版本:

如果您以前从未使用过Debugger(并且此调试器与旧版Adobe Experience Cloud Debugger不同),则可能需要观看此五分钟的概述视频:

打开Luma网站

在本教程中,我们使用公开托管的Luma演示网站版本。 让我们打开它并将其加入书签:

  1. 在新的浏览器选项卡中,打开 Luma网站.
  2. 将页面加入书签以在教程的其余部分中使用

此托管网站就是我们使用 enablementadobe.com 在 域 初始标记属性配置的字段以及使用原因 data.enablementadobe.com 作为 Adobe Experience Platform Web SDK 扩展。 看,我有计划!

Luma主页

使用Experience Platform调试器映射到您的标记属性

Experience Platform调试器具有一项酷炫的功能,允许您将现有标记属性替换为其他属性。 这对于验证非常有用,它允许我们在本教程中跳过许多实施步骤。

  1. 确保已打开Luma网站,并选择Debugger扩展图标Experience Platform

  2. Debugger将打开并显示硬编码实施的一些详细信息,这些信息与本教程无关(您可能需要在打开Debugger后重新加载Luma网站)

  3. 确认Debugger为“已连接到Luma“ ”,然后选择““ ”图标,将Debugger锁定到Luma网站。

  4. 选择 登录 按钮进行身份验证。

  5. 现在,转到 Launch 在左侧导航中

  6. 选择配置选项卡

  7. 右边显示 页面嵌入代码,打开 操作 下拉菜单,然后选择 替换

    选择“操作”>“替换”

  8. 自您通过身份验证后,Debugger将提取您可用的Launch资产和环境。 选择 Luma Platform Tutorial 属性

  9. 选择 Development 环境

  10. 选择 应用 按钮
    选择替代标记属性

  11. Luma网站现在将重新加载 使用标记属性. 救命,我被黑了! 开个玩笑。
    已替换标记属性

  12. 转到 概要 在左侧导航中,查看 Launch 属性
    “摘要”选项卡

  13. 现在,转到 AEP Web SDK ,以查看 网络请求

  14. 打开 事件 row

    Adobe Experience Platform Web SDK请求

  15. 请注意,如何查看 web.webpagedetails.pageView 我们在 发送事件 操作,以及 AEP Web SDK ExperienceEvent Mixin 格式
    事件详细信息

  16. 浏览器的Web开发人员工具中还会显示这些类型的请求详细信息 网络 选项卡。 打开它并重新加载页面。 筛选具有 interact 要找到调用,请选择它,然后查看 标题 选项卡, 请求有效负载 的上界。
    “网络”选项卡

  17. 转到 响应 选项卡,并记下ECID值是如何包含在响应中的。 复制此值,以便在下一个练习中使用该值验证用户档案信息。
    “网络”选项卡

验证Experience Platform中的数据

您可以通过查看 Luma Web Events Dataset. (我知道,这叫流数据摄取,但现在我说它是分批到达的! 它以实时方式流式传输到Profile,以便用于实时分段和激活,但每15分钟会批量发送到数据湖。)

验证数据:

  1. 在Platform用户界面中,转到 数据集 在左侧导航中
  2. 打开 Luma Web Events Dataset 并确认批次已到达。 请记住,系统每15分钟发送一次这些批次,因此您可能需要等待批次显示完成。
  3. 选择 预览数据集 按钮
    打开数据集
  4. 在预览模式中,请注意如何选择左侧架构的不同字段以预览这些特定数据点:
    预览字段

您还可以确认显示新配置文件:

  1. 在Platform用户界面中,转到 用户档案 在左侧导航中
  2. 选择 ECID 命名空间并搜索您的ECID值(从响应中复制它)。 该用户档案将有其自己的ID,与ECID分开。
  3. 选择 配置文件ID 打开用户档案
    查找并打开用户档案
  4. 选择 事件 选项卡,以查看您查看的页面
    用户档案事件

向事件添加自定义数据

为页面名称创建数据元素

  1. 在数据收集标记界面中,位于 Luma Platform Tutorial 属性,打开 选择工作库 下拉菜单,选择 Luma Platform Tutorial 库。 通过此设置,可以更轻松地将其他更新发布到我们的库。

  2. 现在,转到 数据元素 在左侧导航中

  3. 选择 创建新数据元素 按钮

    创建新数据元素

  4. 作为 名称,输入 Page Name

  5. 作为 数据元素类型,选择 JavaScript Variable

  6. 作为 JavaScript变量名称,输入 digitalData.page.pageInfo.pageName

  7. 为帮助标准化值的格式,请选中 强制使用小写值清理文本

  8. 确保 Luma Platform Tutorial 选作工作库

  9. 选择 保存到库
    为页面名称创建数据元素

将页面名称映射到XDM对象数据元素

现在,我们将页面名称映射到Web SDK。

重要

要完成此任务,我们需要确保用户首先有权访问生产沙盒。 如果您尚未从其他产品配置文件访问“生产”沙盒,请快速打开 Luma Tutorial Platform 配置文件和添加权限项 沙箱 > 生产. 执行此操作后,在“数据元素”页面上执行SHIFT — 重新加载以清除缓存
添加生产沙盒

数据元素 页面:

  1. 创建新数据元素

  2. 作为 名称,输入 XDM Object

  3. 作为 扩展,选择 Adobe Experience Platform Web SDK

  4. 作为 数据元素类型,选择 XDM object

  5. 作为 沙盒,选择 Luma Tutorial 沙盒

  6. 作为 架构,选择 Luma Web Events Schema

  7. 选择 web.webPageDetails.name 字段

  8. 作为 ,选择图标以打开数据元素选择模式并选择 Page Name 数据元素

  9. 选择 保存到库

    将页面名称映射到XDM对象数据元素

同一过程用于将网站上的其他自定义数据映射到XDM字段。

将XDM数据添加到“发送事件”操作

现在,您已将数据映射到XDM字段,接下来可以将其包含在“发送事件”操作中:

  1. 转到 规则 屏幕
  2. 打开 All Pages - Library Loaded 规则
  3. 打开 Adobe Experience Platform Web SDK - Send Event 操作
  4. 作为 XDM数据,选择图标以打开数据元素选择模式并选择 XDM Object 数据元素
  5. 选择 保留更改 按钮
    将XDM数据添加到“发送事件”操作
  6. 既然你 Luma Platform Tutorial 已选择作为最近几个练习的工作库,则最近所做的更改已直接保存到库。 您无需通过“发布流程”屏幕发布更改,只需打开蓝色按钮上的下拉菜单并选择 保存到库并构建
    保存到库并构建

这会开始使用您刚才所做的三项更改来构建新标记库。

验证XDM数据

现在,您应该能够重新加载Luma主页,同时像之前学习到的那样使用Debugger映射到您的标记属性,并查看请求中填充的页面名称字段!
验证XDM数据

您还可以通过预览数据集和配置文件来验证在Platform中收到的页面名称数据。

发送其他标识

您的Web SDK实施现在正在发送将Experience CloudID(ECID)作为主标识符的事件。 ECID由Web SDK自动生成,并且每个设备和浏览器都是唯一的。 根据客户使用的设备和浏览器,一个客户可以拥有多个ECID。 那么,我们如何才能统一地了解此客户,并将其在线活动与我们的CRM、忠诚度和离线购买数据关联起来? 为此,我们在其会话期间收集其他身份,并通过身份拼合确定性链接其用户档案。

如果您还记得,我曾提到,我们将在 映射标识 课程。 那么,让我们使用Web SDK收集CRM ID!

为CRM Id添加数据元素

首先,我们将CRM ID存储在数据元素中:

  1. 在标记界面中,添加一个名为 CRM Id
  2. 作为 数据元素类型,选择 JavaScript变量
  3. 作为 JavaScript变量名称,输入 digitalData.user.0.profile.0.attributes.username
  4. 选择 保存到库 按钮(Luma Platform Tutorial 仍然是您的工作库)
    为CRM Id添加数据元素

将CRM ID添加到Identity Map数据元素

既然我们已捕获到CRM ID值,则必须将其与名为 身份映射 数据元素:

  1. 添加名为 Identities

  2. 作为 扩展,选择 Adobe Experience Platform Web SDK

  3. 作为 数据元素类型,选择 身份映射

  4. 作为 命名空间,输入 Luma CRM Id,这是 命名空间 我们在前面的课程中

    警告

    Adobe Experience Platform Web SDK扩展版本2.2允许您使用Platform帐户中的实际值,从预填充的下拉列表中选择“命名空间”。 遗憾的是,此功能尚未“感知沙盒”,因此 Luma CRM Id 值可能不会显示在下拉菜单中。 这可能会阻止您完成本练习。 确认后,我们将发布解决方法。

  5. 作为 ID,选择图标以打开数据元素选择模式并选择 CRM Id 数据元素

  6. 作为 身份验证状态,选择 已验证

  7. 离开 主要 未选中. 由于CRM ID不存在于Luma网站的大多数访客,因此您肯定 不希望将ECID作为主标识符覆盖. 将ECID以外的任何内容用作主标识符的用例非常少见。 通常我不会提及这些说明中的默认设置,但我会调用此设置,以帮助您在以后的实施中避免头疼。

  8. 选择 保存到库 按钮(Luma Platform Tutorial 仍然是您的工作库)
    将CRM ID添加到Identity Map数据元素

注意

您可以使用 身份映射 数据类型。

将身份映射数据元素添加到XDM对象

我们还必须更新一个数据元素 — XDM对象数据元素。 必须更新三个单独的数据元素才能传递此身份似乎很奇怪,但此过程旨在针对多个身份进行扩展。 别担心,这课快结束了!

  1. 打开XDM对象数据元素
  2. 打开IdentityMap XDM字段
  3. 作为 数据元素,选择图标以打开数据元素选择模式并选择 Identities 数据元素
  4. 既然你 Luma Platform Tutorial 已选择作为最近几个练习的工作库,则最近所做的更改已直接保存到库。 您无需通过“发布流程”屏幕发布更改,而是可以打开蓝色按钮上的下拉菜单并选择 保存到库并构建
    将IdentityMap数据元素添加到XDM对象

验证身份

要验证Web SDK是否正在发送CRM ID,请执行以下操作:

  1. 打开 Luma网站
  2. 按照前面的说明,使用Debugger将其映射到您的标记属性
  3. 选择 登录 Luma网站右上角的链接
  4. 使用凭据登录 test@adobe.com/test
  5. 验证后,在Debugger中检查Experience PlatformWeb SDK调用(Adobe Experience Platform Web SDK > 网络请求 > 事件 ),您应会看到 lumaCrmId:
    在Debugger中验证身份
  6. 再次使用ECID命名空间和值查找用户配置文件。 在用户档案中,您将看到CRM ID以及会员ID和用户档案详细信息,如姓名和电话号码。 所有身份和数据已拼合到一个实时客户用户档案中!
    在平台中验证身份

其他资源

干得好! 这是有关Web SDK和Launch的大量信息。 全面实施涉及的内容要多得多,但是这些是帮助您开始在平台中查看结果的基础知识。

注意

现在,您已完成流摄取课程,接下来可以删除 生产 来自您的沙盒 Luma Tutorial Platform 产品配置文件

数据工程师,如果您愿意,请跳到 运行查询课程.

数据架构师,您可以 合并策略!

在此页面上