使用Web SDK流式传输数据以Experience Platform

了解如何使用 Platform Web SDK 将 Web 数据传输到 Adobe Experience Platform。

Experience Platform是所有新Experience Cloud应用程序(如Adobe Real-time Customer Data Platform、Adobe Customer Journey Analytics和Adobe Journey Optimizer)的支柱。 这些应用程序旨在使用Platform Web SDK作为它们的最佳的Web数据收集方法。

Web SDK和Adobe Experience Platform图

Experience Platform使用您之前创建的相同XDM架构从Luma网站捕获事件数据。 当该数据被发送到PlatformEdge Network时,数据流配置可以将其转发到Experience Platform。

学习目标

在本课程结束后,您将能够:

  • 在Adobe Experience Platform中创建数据集
  • 配置数据流以将Web SDK数据发送到Adobe Experience Platform
  • 为实时客户个人资料启用流Web数据
  • 验证数据是否已抵达Platform数据集和实时客户资料中
  • 将样本忠诚度计划数据摄取到Platform
  • 构建简单的平台受众

先决条件

要完成本课程,您必须首先:

  • 有权访问Adobe Experience Platform应用程序,如Real-time Customer Data Platform、Journey Optimizer或Customer Journey Analytics
  • 完成本教程的初始配置和标记配置部分中之前的课程。
NOTE
如果您没有任何Platform应用程序,则可以跳过本课程或阅读。

创建数据集

所有成功引入Adobe Experience Platform的数据将作为数据集保留在数据湖中。 A 数据集 是用于数据集合的存储和管理结构,通常是包含架构(列)和字段(行)的表。 数据集还包含描述其存储的数据的各个方面的元数据。

让我们为您的Luma Web事件数据设置一个数据集:

  1. 转到 Experience PlatformJourney Optimizer 界面

  2. 确认您使用的是本教程所用的开发沙盒

  3. 打开 数据管理>数据集 从左侧导航

  4. 选择 创建数据集

    创建架构

  5. 选择 从架构创建数据集 option

    从架构创建数据集

  6. 选择 Luma Web Event Data 在中创建的模式 早先的教训 然后选择 下一个

    数据集,选择架构

  7. 提供 名称 和可选 描述 用于数据集。 在本练习中,请使用 Luma Web Event Data,然后选择 完成

    数据集名称

数据集现在配置为开始从Platform Web SDK实施中收集数据。

配置数据流

现在,您可以配置 数据流 以将数据发送到 Adobe Experience Platform. 数据流是标记属性、PlatformEdge Network和Experience Platform数据集之间的链接。

  1. 打开 数据收集 界面

  2. 选择 数据流 从左侧导航

  3. 打开您在中创建的数据流 配置数据流 教训, Luma Web SDK

    选择Luma Web SDK数据流

  4. 选择 添加服务
    向数据流添加服务

  5. 选择 Adobe Experience Platform 作为 服务

  6. 选择 Luma Web Event Data 作为 事件数据集

  7. 选择​ 保存

    数据流配置

当您在 Luma演示站点 映射到您的标记属性时,数据会在Experience Platform中填充数据集!

验证数据集

此步骤对于确保数据已载入数据集至关重要。 验证发送到数据集的数据有两个方面。

  • 使用进行验证 Experience Platform调试程序
  • 使用进行验证 预览数据集
  • 使用进行验证 查询服务

Experience Platform Debugger

这些步骤与您在中所执行的操作大致相同 调试器课程. 但是,由于只有在数据流中启用数据后才会将数据发送到Platform,因此您必须生成一些更多示例数据:

  1. 打开 Luma演示站点 并选择 Experience Platform调试程序 扩展图标

  2. 配置Debugger以将标记属性映射到 您的 开发环境,如 使用Debugger进行验证 课程

    Debugger 中显示的 Launch 开发环境

  3. 使用凭据 test@adobe.com/test 登录 Luma 网站

  4. 返回 Luma 主页

  5. 在调试器显示的Platform Web SDK网络信标中,选择“事件”行以在弹出窗口中展开详细信息

    Debugger中的Web SDK

  6. 在弹出窗口中搜索“identityMap”。 在这里,您应该会看到包含authenticatedState、id和primary三个键的lumaCrmId
    Debugger中的Web SDK

现在,数据应填充到 Luma Web Event Data 数据集,并准备好进行“预览数据集”验证。

预览数据集

要确认数据已抵达Platform的数据湖,一个快速选项是使用 预览数据集 功能。 将Web SDK数据微批次发送到数据湖,并定期在Platform界面中刷新。 查看生成的数据可能需要10-15分钟。

  1. Experience Platform 界面,选择 数据管理>数据集 在左侧导航栏中打开 数据集 仪表板。

    仪表板列出您组织的所有可用数据集。 会显示每个列出数据集的详细信息,包括其名称、数据集所遵循的架构以及最近摄取运行的状态。

  2. 选择您的 Luma Web Event Data 要打开其的 数据集活动 屏幕。

    数据集Luma Web事件

    活动屏幕包括一个可视化消息使用率的图表,以及一个成功和失败批次的列表。

  3. 数据集活动 屏幕,选择 预览数据集 在屏幕的右上角附近,可预览最多100行数据。 如果数据集为空,则停用预览链接。

    数据集预览

    在预览窗口中,数据集的架构的分层视图显示在右侧。

    数据集预览1

查询数据

  1. Experience Platform 界面,选择 数据管理>查询 在左侧导航栏中打开 查询 屏幕。
  2. 选择 创建查询
  3. 首先,运行查询以查看数据湖中表的所有名称。 输入 SHOW TABLES 在查询编辑器中,单击播放图标以运行查询。
  4. 在结果中,请注意表的名称类似于 luma_web_event_data
  5. 现在,使用引用表的简单查询来查询表(请注意,默认查询将限制为100个结果): SELECT * FROM "luma_web_event_data"
  6. 片刻后,您应该会看到Web数据的示例记录。
ERROR
如果您收到“未配置表”错误,请仔细检查表的名称。 也有可能是微量的数据尚未进入数据湖。 请在10-15分钟后重试。
INFO
有关Adobe Experience Platform查询服务的更多详细信息,请参阅 浏览数据 在平台教程部分中。

为实时客户个人资料启用数据集和架构

对于Real-time Customer Data Platform和Journey Optimizer的客户,下一步是为实时客户个人资料启用数据集和架构。 来自Web SDK的数据流将是流入Platform的众多数据源之一,您希望将Web数据与其他数据源连接以构建360度客户档案。 要了解有关Real-time Customer Profile的更多信息,请观看此短视频:

CAUTION
在使用您自己的网站和数据时,我们建议先对数据进行更强大的验证,然后再启用它以用于实时客户档案。

要启用数据集,请执行以下操作:

  1. 打开您创建的数据集, Luma Web Event Data

  2. 选择 配置文件切换 以打开它

    配置文件切换

  3. 确认您希望 启用 数据集

    配置文件启用切换

要启用架构,请执行以下操作:

  1. 打开您创建的架构, Luma Web Event Data

  2. 选择 配置文件切换 以打开它

    配置文件切换

  3. 选择 此架构的数据将在identityMap字段中包含主标识。

    note important
    IMPORTANT
    发送到Real-Time Customer Profile的每个记录都需要主身份。 通常,架构中会标记身份字段。 但是,在使用身份映射时,身份字段在架构中不可见。 此对话框用于确认您有一个主要身份,并且您将在发送数据时在身份映射中指定该身份。 如您所知,Web SDK使用将Experience CloudID (ECID)作为默认主标识且经过身份验证的ID作为主标识(如果可用)的标识映射。
  4. 选择 启用

    配置文件启用切换

  5. 选择 保存 保存更新的架构

现在还为配置文件启用了该架构。

IMPORTANT
为配置文件启用架构后,如果不重置或删除整个沙盒,则无法禁用或删除该架构。 此外,此后无法从架构中删除字段。
在处理您自己的数据时,我们建议您按照以下顺序执行操作:
  • 首先,将一些数据摄取到数据集中。
  • 解决在数据摄取过程中出现的任何问题(例如,数据验证或映射问题)。
  • 为配置文件启用数据集和架构
  • 如果需要,重新摄取数据

验证用户档案

您可以在Platform界面(或Journey Optimizer界面)中查找客户配置文件,以确认数据已载入实时客户配置文件。 顾名思义,用户档案会实时填充,因此不会像验证数据集中的数据那样延迟。

首先,必须生成更多示例数据。 重复本课程中前面介绍的步骤,在网站被映射到您的标记资产时登录到Luma网站。 Inspect Platform Web SDK请求,以确保其发送数据的同时 lumaCRMId.

  1. Experience Platform 界面,选择 客户 > 配置文件 在左侧导航中

  2. 作为 身份命名空间 使用 lumaCRMId

  3. 复制并粘贴的值 lumaCRMId 传入了您在Experience Platform调试器中检查的调用,在本例中 112ca06ed53d3db37e4cea49cc45b71e.

    个人资料

  4. 如果配置文件中存在有效的值, lumaCRMId,控制台中会填充配置文件ID:

    个人资料

  5. 查看完整的 客户配置文件 对于每个ID,选择 配置文件ID 在主窗口中。

    note note
    NOTE
    请注意,您可以选择“配置文件ID”的超链接,或者如果您选择了行,则会打开一个右菜单,您可以在其中选择“配置文件ID”超链接
    客户配置文件

    在这里,您可以看到链接到 lumaCRMId,例如 ECID.

    客户配置文件

您现在已为Experience Platform启用了Platform Web SDK(和Real-Time CDP! 还有Journey Optimizer! 还有Customer Journey Analytics!)。

创建忠诚度模式并摄取示例数据

Real-time Customer Data Platform和Journey Optimizer的客户可望完成本练习。

将Web SDK数据摄取到Adobe Experience Platform中后,可以通过已摄取到Platform中的其他数据源来扩充这些数据。 例如,当用户登录到Luma网站时,将在Experience Platform中构建身份图,并且所有其他启用配置文件的数据集可能会连接在一起,以构建实时客户配置文件。 要查看其实际效果,请快速在Adobe Experience Platform中创建另一个包含一些忠诚度数据示例的数据集,以便您可以将实时客户配置文件与Real-time Customer Data Platform和Journey Optimizer结合使用。 由于您已经进行了类似的练习,因此会提供简短的说明。

创建忠诚度模式:

  1. 创建新架构

  2. 选择 个人资料 作为 基类

  3. 命名架构 Luma Loyalty Schema

  4. 添加 忠诚度详细信息 字段组

  5. 添加 人口统计详细信息 字段组

  6. 选择 Person ID 字段并将其标记为 标识 和 主要身份 使用 Luma CRM Id 身份命名空间.

  7. 为以下对象启用架构 个人资料. 如果找不到配置文件切换开关,请尝试单击左上角的架构名称。

  8. 保存架构

    忠诚度模式

要创建数据集并摄取示例数据,请执行以下操作:

  1. 从创建新数据集 Luma Loyalty Schema

  2. 命名数据集 Luma Loyalty Dataset

  3. 为以下项启用数据集 个人资料

  4. 下载样例文件 luma-loyalty-forWeb.json

  5. 将文件拖放到数据集中

  6. 确认已成功摄取数据

    忠诚度模式

创建受众

受众会根据常见特征将用户档案分组在一起。 构建可在Web营销活动中使用的快速受众:

  1. 在Experience Platform或Journey Optimizer界面中,转到 客户 > 受众 在左侧导航中

  2. 选择 创建受众

  3. 选择 生成规则

  4. 选择 创建

    创建受众

  5. 选择 属性

  6. 查找 忠诚度 > 字段并将其拖动到 属性 部分

  7. 将受众定义为用户,其 tiergold

  8. 为受众命名 Luma Loyalty Rewards – Gold Status

  9. 选择 Edge 作为 评估方法

  10. 选择 保存

    定义受众

由于这是一个非常简单的受众,因此我们可以使用边缘评估方法。 Edge受众会在边缘进行评估,因此在Web SDK向PlatformEdge Network发出的相同请求中,我们可以评估受众定义并立即确认用户是否符合条件。

下一步:

NOTE
感谢您投入时间学习Adobe Experience Platform Web SDK。 如果您有疑问、希望分享一般反馈或有关于未来内容的建议,请在此共享它们 Experience League社区讨论帖子
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4