摄取流数据

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

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

  • 我们必须在Luma网站上实施Web SDK,以将有关访客活动的数据从该网站发送到Adobe Edge网络。 We will do a simple implementation using tags (formerly Launch)

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

Data Engineers will need to ingest streaming data outside of this tutorial. 实施Adobe Experience Platform的Web SDK或移动SDK时,通常由Web或移动开发人员参与数据层创建和标记属性配置。

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

注意

While this tutorial focuses on streaming ingestion from websites with Web SDK, you can also stream data using the Adobe Mobile SDK, Apache Kafka Connect, and other mechanisms.

所需权限

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

配置数据流

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

要创建数据流,请执行以下操作:

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

  2. 在左侧导航中选择​Datastreams

  3. 选择右上角的​新建数据流​按钮

    在左侧导航中选择数据流

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

  5. 选择​Save​按钮

    命名数据并保存

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

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

  2. 对于​Sandbox,选择Luma Tutorial

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

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

  5. 选择​Save

    配置数据流并保存

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

安装Web SDK扩展

添加资产

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

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

  1. 在左侧导航中,转到​Properties

  2. 选择​New Property​按钮
    添加新资产

  3. 对于​Name,输入Luma Platform Tutorial(如果您公司的多位人员参加了本教程,请将您的姓名添加到结尾)

  4. 对于​Domains,请输入enablementadobe.com(稍后介绍)

  5. 选择​Save

    属性详细信息

添加Web SDK扩展

现在,您已拥有资产,可以使用扩展添加Web SDK。 An extension is a package of code that extends the Data Collection interface and functionality. 添加该扩展:

  1. Open your tag property
  2. Go to Extensions in the left navigation
  3. 转到​Catalog​选项卡
  4. There are many extensions available for tags. Filter the catalog with the term Web SDK
  5. 在​Adobe Experience Platform Web SDK​扩展中,选择​Install​按钮
    安装Adobe Experience Platform Web SDK扩展
  6. Web SDK扩展有多种可用配置,但我们仅将在本教程中配置两种。 Update the Edge Domain to data.enablementadobe.com. 此设置允许您使用Web SDK实施设置第一方Cookie,我们鼓励您这样做。 在本课程的后面,您会将enablementadobe.com域上的网站映射到您的标记资产。 The CNAME for the enablementadobe.com domain has already been configured so that data.enablementadobe.com will forward to Adobe servers. 在您自己的网站上实施Web SDK时,您将需要创建一个CNAME以用于您自己的数据收集,例如data.YOUR_DOMAIN.com
  7. 从​数据流​下拉列表中,选择Luma Platform Tutorial数据流。
  8. 请随时查看其他配置选项(但不要更改它们!) and then select Save

创建用于发送数据的规则

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

  1. Go to Rules in the left navigation
  2. 选择​Create New Rule​按钮
    创建规则
  3. 将规则命名为 All Pages - Library Loaded
  4. 在​Events​下,选择​Add​按钮
    命名规则并添加事件
  5. 使用​Core Extension​并选择​Library Loaded(Page Top)​作为​Event Type。 此设置意味着,每当页面上加载Launch库时,都会触发我们的规则。
  6. 选择​Keep Changes​以返回到主规则屏幕
    添加Library Loaded事件
  7. 将​Conditions​留空,因为我们希望此规则在所有页面上触发,就像我们为其提供的名称一样
  8. 在​Actions​下,选择​Add​按钮
  9. 使用​Adobe Experience Platform Web SDK Extension​并选择​Send Event​作为​Action Type
  10. 在右侧的​类型​下拉列表中,选择​web.webpagedetails.pageViews。 这是Luma Web Events Schema中的XDM字段之一
  11. 选择​Keep Changes​以返回到主规则屏幕
    添加Send Event操作
  12. 选择​Save​以保存规则
    保存规则

在库中发布规则

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

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

  1. 在左侧导航中,转到​发布流量
  2. 选择​Add Library
    选择添加库
  3. 对于​Name,输入Luma Platform Tutorial
  4. 对于​Environment,选择Development
  5. 选择​Add All Changed Resources​按钮。 (除了Adobe Experience Platform Web SDK扩展和All Pages - Library Loaded规则之外,您还将看到添加的Core扩展,其中包含所有Launch Web属性所需的基本JavaScript。)
  6. 选择​Save & Build for Development​按钮
    创建和构建库

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

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

验证请求中的数据

添加Adobe Experience Platform Debugger

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

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

打开Luma网站

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

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

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

Luma homepage

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

The Experience Platform Debugger has a cool feature that allows you to replace an existing tag property with a different one. 这对于验证非常有用,它允许我们在本教程中跳过许多实施步骤。

  1. Make sure you have the Luma site open and select the Experience Platform Debugger extension icon

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

  3. 确认Debugger为“已连接到Luma”(如下图所示),然后选择“锁定”图标以将Debugger锁定到Luma网站。

  4. 选择右上方的​登录​按钮进行身份验证。

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

  6. 选择配置选项卡

  7. 在显示​页面嵌入代码​的右侧,打开​操作​下拉列表,然后选择​替换

    Select Actions > Replace

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

  9. Select your Development environment

  10. Select the Apply button
    选择替代标记属性

  11. 现在,Luma网站将使用您的标记属性​重新加载。 Help, I've been hacked! 开个玩笑。
    tag property replaced

  12. 在左侧导航中,转到​Summary,以查看Launch属性的详细信息
    Summary tab

  13. 现在,转到左侧导航中的​AEP Web SDK ,以查看​Network Requests

  14. 打开​events​行

    Adobe Experience Platform Web SDK请求

  15. 请注意,如何查看我们在Send Event操作中指定的web.webpagedetails.pageView事件类型,以及遵循AEP Web SDK ExperienceEvent Mixin格式的其他现成变量
    事件详细信息

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

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

验证Experience Platform中的数据

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

验证数据:

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

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

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

向事件添加自定义数据

为页面名称创建数据元素

  1. 在数据收集标记界面的Luma Platform Tutorial属性右上角,打开​选择工作库​下拉列表,然后选择Luma Platform Tutorial库。 通过此设置,可以更轻松地将其他更新发布到我们的库。

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

  3. 选择​Create New Data Element​按钮

    创建新数据元素

  4. 对于​Name,输入Page Name

  5. 对于​数据元素类型,请选择JavaScript Variable

  6. 对于​JavaScript变量名称,请输入digitalData.page.pageInfo.pageName

  7. 要帮助标准化值的格式,请选中​强制小写值​和​清除文本​复选框

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

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

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

Now we will map our page name to the Web SDK.

重要

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

在​数据元素​页面上:

  1. 创建新数据元素

  2. As the Name, enter XDM Object

  3. As the Extension, select Adobe Experience Platform Web SDK

  4. 对于​数据元素类型,请选择XDM object

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

  6. 对于​Schema,请选择Luma Web Events Schema

  7. Select the web.webPageDetails.name field

  8. As the Value, select the icon to open the data element selection modal and choose your Page Name data element

  9. 选择​保存到库

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

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

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

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

  1. 转到​Rules​屏幕
  2. 打开All Pages - Library Loaded规则
  3. 打开Adobe Experience Platform Web SDK - Send Event操作
  4. 对于​XDM数据,选择用于打开数据元素选择模式窗口的图标,然后选择XDM Object数据元素
  5. 选择​Keep Changes​按钮
    将XDM数据添加到“发送事件”操作
  6. 现在,由于您在前几个练习中选择了Luma Platform Tutorial作为工作库,因此最近所做的更改已直接保存到库。 您无需通过“发布流程”屏幕发布更改,只需打开蓝色按钮上的下拉菜单,然后选择​Save to Library and Build​即可
    保存到库并构建

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

验证XDM数据

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

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

发送其他标识

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

如果您还记得,我在映射标识课程中提到,我们将使用ECID和CRM ID作为Web数据的标识。 那么,让我们使用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值,则必须将其与名为Identity Map数据元素的特殊数据元素类型关联:

  1. 添加名为Identities的数据元素

  2. 对于​Extension,请选择​Adobe Experience Platform Web SDK

  3. 对于​数据元素类型,选择​身份映射

  4. 作为​Namespace,输入Luma CRM Id,这是我们在前面的课程中创建的namespace

    警告

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

  5. 对于​ID,选择用于打开数据元素选择模式窗口的图标,然后选择CRM Id数据元素

  6. 对于​Authenticated State,选择​Authenticated

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

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

注意

您可以使用Identity map数据类型传递多个标识符。

Add the Identity map data element to the XDM Object

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

  1. 打开XDM对象数据元素
  2. 打开IdentityMap XDM字段
  3. 对于​Data element,选择用于打开数据元素选择模式窗口的图标,然后选择Identities数据元素
  4. 现在,由于您在前几个练习中选择了Luma Platform Tutorial作为工作库,因此最近所做的更改已直接保存到库。 您无需通过“发布流程”屏幕发布更改,而是可以打开蓝色按钮上的下拉菜单,然后选择​Save to Library and Build
    将IdentityMap数据元素添加到XDM对象

验证身份

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

  1. 打开Luma网站
  2. 按照前面的说明,使用Debugger将其映射到您的标记属性
  3. 选择Luma网站右上角的​Login​链接
  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产品配置文件中删除Prod沙盒

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

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

在此页面上