准备数据以在Intelligent Services中使用

为了Intelligent Services从营销事件数据中发现洞察信息,必须在语义上对数据进行扩充并以标准结构进行维护。 Intelligent Services 利 Experience Data Model 用(XDM)模式来实现此目的。具体而言,Intelligent Services中使用的所有数据集都必须符合消费者体验事件(CEE)XDM架构或使用Adobe Analytics连接器。 此外, Customer AI还支持Adobe Audience Manager连接器。

本文档就将营销事件数据从多个渠道映射到CEE架构提供了一般指导,概述了架构内重要字段的信息,以帮助您确定如何将数据有效映射到其结构。 如果您计划使用Adobe Analytics数据,请查看Adobe Analytics数据准备的部分。 如果您计划使用Adobe Audience Manager数据(仅限Customer AI),请查看AdobeAudience Manger数据准备的部分。

数据要求

Intelligent Services 根据您创建的目标,需要不同数量的历史数据。无论如何,您为​all Intelligent Services准备的数据必须同时包含正面和负面的客户历程/事件。 同时具有负事件和正事件可提高模型精度和准确性。

例如,如果您使用Customer AI来预测购买产品的倾向,则Customer AI的模型需要成功购买路径的示例和失败路径的示例。 这是因为在模型培训期间, Customer AI会了解哪些事件和历程会导致购买。 此外,还包括未购买的客户执行的操作,例如在将项目添加到购物车时停止其历程的个人。 这些客户可能表现出类似的行为,但是, Customer AI可以提供洞察并深入分析导致倾向得分较高的主要差异和因素。 同样,Attribution AI需要同时使用事件类型和历程类型,才能按接触点位置显示接触点有效性、热门转化路径和划分等量度。

有关历史数据要求的更多示例和信息,请访问输入/输出文档中的Customer AIAttribution AI历史数据要求部分。

拼合数据的准则

建议您尽可能将用户的事件拼合到通用ID中。 例如,您可能有10个事件中的“id1”用户数据。 之后,同一用户删除了Cookie ID,并在接下来的20个事件中记录为“id2”。 如果您知道id1和id2对应于同一用户,则最佳实践是将所有30个事件与一个通用id拼合在一起。

如果这不可能,则在创建模型输入数据时,应将每组事件视为不同的用户。 这可确保在模型培训和评分期间获得最佳结果。

工作流摘要

准备过程会因数据是存储在Adobe Experience Platform中还是存储在外部而异。 此部分概述了在两种情况下需要采取的必要步骤。

外部数据准备

如果您的数据存储在Experience Platform之外,则需要将数据映射到消费者体验事件架构中的必需字段和相关字段。 可以使用自定义字段组扩展此模式,以更好地捕获客户数据。 映射后,您可以使用消费者ExperienceEvent架构创建数据集,并将数据摄取到Platform。 然后,在配置Intelligent Service时,可以选择CEE数据集。

根据您希望使用的Intelligent Service,可能需要不同的字段。 请注意,如果您有可用的数据,则最好将数据添加到字段。 要了解有关必填字段的更多信息,请访问Attribution AICustomer AI输入/输出指南。

Adobe Analytics数据准备

Customer AI和Attribution AI本地支持Adobe Analytics数据。 要使用Adobe Analytics数据,请按照文档中所述的步骤设置Analytics源连接器

在源连接器将您的数据流式传输到Experience Platform后,您便能够在实例配置期间选择Adobe Analytics作为数据源,后跟一个数据集。 连接设置期间,将自动创建所有必需架构字段组和单个字段。 您无需对数据集进行ETL(提取、转换、加载)操作,即可将其转换为CEE格式。

重要

Adobe Analytics连接器最多需要四周时间才能回填数据。 如果您最近设置了连接,则应验证数据集是否具有客户或Attribution AI所需的最小数据长度。 请查看Customer AIAttribution AI中的历史数据部分,并验证您的预测目标有足够的数据。

Adobe Audience Manager数据准备(仅限Customer AI)

Customer AI本地支持Adobe Audience Manager数据。 要使用Audience Manager数据,请按照文档中所述的步骤设置Audience Manager源连接器

在源连接器将您的数据流式传输到Experience Platform后,您便能够在Customer AI配置期间选择Adobe Audience Manager作为数据源,后跟一个数据集。 连接设置期间,将自动创建所有架构字段组和单个字段。 您无需对数据集进行ETL(提取、转换、加载)操作,即可将其转换为CEE格式。

重要

如果您最近设置了一个连接器,则应验证数据集是否具有所需的最小数据长度。 请查看输入/输出文档中有关Customer AI的历史数据部分,并验证您是否有足够的数据来实现预测目标。

Experience Platform 数据准备

如果您的数据已存储在Platform中,并且没有通过Adobe Analytics或Adobe Audience Manager(仅限Customer AI)源连接器进行流式传输,请执行以下步骤。 我们仍建议您了解CEE模式。

  1. 查看消费者体验事件架构的结构,并确定数据是否可以映射到其字段。
  2. 请联系Adobe咨询服务部门,以帮助将您的数据映射到架构并将其摄取到Intelligent Services中,或者,如果您希望自己映射数据,请按照本指南🔗中的步骤操作。

了解CEE架构

消费者体验事件架构描述个人的行为,因为它与数字营销事件(Web或移动设备)以及在线或离线商务活动相关。 Intelligent Services需要使用此架构,因为其语义上定义得很好的字段(列),从而避免出现任何未知名称,否则这些名称会使数据变得不那么清晰。

与所有XDM ExperienceEvent架构一样,CEE架构可在发生事件(或事件集)时捕获系统基于时间序列的状态,包括所涉及主题的时间点和身份。 体验事件是所发生事件的事实记录,因此它们不可更改,不经聚合或解释即表示所发生事件。

Intelligent Services 利用此架构中的几个关键字段从营销事件数据生成分析,所有这些数据均可在根级别找到并展开以显示其必需子字段。

与所有XDM架构一样,CEE架构字段组也是可扩展的。 换言之,可以将其他字段添加到CEE字段组,并且如有必要,可以将不同的变体包含在多个架构中。

可在公共XDM存储库中找到字段组的完整示例。 此外,您还可以查看和复制以下JSON文件的示例,以了解如何构建数据以符合CEE架构。 在了解下面章节中概述的关键字段时,请参阅这两个示例,以确定如何将您自己的数据映射到架构。

关键字段

CEE字段组中有几个关键字段,应使用这些字段来生成有用的分析。 Intelligent Services此部分介绍这些字段的用例和预期数据,并提供指向参考文档的链接以获取更多示例。

必填字段

尽管强烈建议使用所有键字段,但有两个字段是​必填,以便Intelligent Services正常工作:

主标识

架构中的其中一个字段必须设置为主标识字段,该字段允许Intelligent Services将时间序列数据的每个实例链接到个人。

您必须根据数据的来源和性质确定要用作主标识的最佳字段。 标识字段必须包含​标识命名空间,以指示字段期望作为值的身份数据类型。 一些有效的命名空间值包括:

  • "电子邮件"
  • "phone"
  • "mcid"(用于Adobe Audience Manager ID)
  • "aaid"(用于Adobe Analytics ID)

如果不确定应将哪个字段用作主标识,请联系Adobe咨询服务部门以确定最佳解决方案。 如果未设置主标识,则Intelligent Service应用程序会使用以下默认行为:

默认 Attribution AI 客户人工智能
标识列 endUserIDs._experience.aaid.id endUserIDs._experience.mcid.id
命名空间 AAID ECID

要设置主标识,请从​架构​选项卡中导航到您的架构,然后选择架构名称超链接以打开​Schema Editor

导航到架构

接下来,导航到要作为主标识的字段,并将其选中。 将打开该字段的​字段属性​菜单。

选择字段

在​字段属性​菜单中,向下滚动,直到找到​Identity​复选框。 选中该框后,将显示将所选标识设置为​主标识​的选项。 也选中此框。

选中复选框

接下来,您必须从下拉列表中预定义的命名空间列表中提供​Identity namespace。 在此示例中,选择ECID名称空间是因为正在使用Adobe Audience Manager ID mcid.id。 选择​Apply​以确认更新,然后选择右上角的​Save​以保存对架构所做的更改。

保存更改

xdm:timestamp

此字段表示事件发生的日期时间。 此值必须作为字符串提供,符合ISO 8601标准。

xdm:channel

注意

只有在使用Attribution AI时,此字段才是必填字段。

此字段表示与ExperienceEvent相关的营销渠道。 该字段包含有关渠道类型、媒体类型和位置类型的信息。

示例架构

{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

有关xdm:channel每个必需子字段的完整信息,请参阅体验渠道架构规范。 有关某些示例映射,请参阅🔗下的表。

渠道映射示例

下表提供了映射到xdm:channel架构的营销渠道的一些示例:

渠道 @type mediaType mediaAction
付费搜索 https://ns.adobe/com/xdm/channel-types/search 已付 点击
社交 — 营销 https://ns.adobe/com/xdm/channel-types/social 挣得 点击
显示 https://ns.adobe/com/xdm/channel-types/display 已付 点击
电子邮件 https://ns.adobe/com/xdm/channel-types/email 已付 点击
内部反向链接 https://ns.adobe/com/xdm/channel-types/direct 自有 点击
显示显示显示到达 https://ns.adobe/com/xdm/channel-types/display 已付 展示次数
QR代码重定向 https://ns.adobe/com/xdm/channel-types/direct 自有 点击
移动设备 https://ns.adobe/com/xdm/channel-types/mobile 自有 点击

推荐字段

本节概述了其余的关键字段。 虽然Intelligent Services不一定需要这些字段才能正常工作,但强烈建议您尽可能多地使用这些字段,以便获得更丰富的洞察信息。

xdm:productListItems

此字段是表示客户选择的产品的项目数组,包括产品SKU、名称、价格和数量。

示例架构

[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

有关xdm:productListItems每个必需子字段的完整信息,请参阅商务详细信息架构规范。

xdm:commerce

此字段包含有关ExperienceEvent的特定于商务的信息,包括采购订单编号和付款信息。

示例架构

{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

有关xdm:commerce每个必需子字段的完整信息,请参阅商务详细信息架构规范。

xdm:web

此字段表示与ExperienceEvent相关的Web详细信息,如交互、页面详细信息和反向链接。

示例架构

{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

有关xdm:productListItems的每个必需子字段的完整信息,请参阅ExperienceEvent Web详细信息架构规范。

xdm:marketing

此字段包含与接触点处于活动状态的营销活动相关的信息。

示例架构

{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

有关xdm:productListItems每个必需子字段的完整信息,请参阅营销部门规范。

映射和摄取数据

确定营销事件数据是否可以映射到CEE架构后,下一步是确定要将哪些数据引入Intelligent Services。 Intelligent Services中使用的所有历史数据都必须在四个月数据的最小时间范围内,另外还要加上预期作为回顾期的天数。

在确定要发送的数据范围后,请联系Adobe咨询服务部门,以帮助将您的数据映射到架构并将其摄取到服务中。

如果您拥有Adobe Experience Platform订阅,并且想要自行映射和摄取数据,请按照以下部分中所述的步骤操作。

使用Adobe Experience Platform

注意

以下步骤需要订阅Experience Platform。 如果您无权访问平台,请跳到后续步骤部分。

本节概述了将数据映射和摄取到Experience Platform中以在Intelligent Services中使用的工作流,包括指向教程的详细步骤链接。

创建CEE架构和数据集

当您准备好开始准备数据以进行摄取时,第一步是创建一个新的XDM架构,该架构将采用CEE字段组。 以下教程将指导在UI或API中创建新架构的过程:

重要

上述教程遵循创建模式的通用工作流。 为架构选择类时,必须使用​XDM ExperienceEvent类。 选择此类后,您可以将CEE字段组添加到架构中。

将CEE字段组添加到架构后,您可以根据数据中其他字段的需要,添加其他字段组。

创建并保存架构后,您便可以基于该架构创建新数据集。 以下教程将演示在UI或API中创建新数据集的过程:

创建数据集后,您可以在​Datasets​工作区的Platform UI中找到该数据集。

向数据集添加标识字段

如果从Adobe Audience Manager、Adobe Analytics或其他外部源导入数据,则可以选择将架构字段设置为标识字段。 要将架构字段设置为标识字段,请查看有关在UI教程API教程中设置标识字段的部分,以创建架构。

如果要从本地CSV文件摄取数据,则可以跳到映射中的下一部分,然后摄取数据

映射和摄取数据

创建CEE架构和数据集后,您可以开始将数据表映射到架构,并将该数据摄取到平台。 有关如何在UI中执行此操作的步骤,请参阅有关将CSV文件映射到XDM架构的教程。 在使用您自己的数据之前,您可以使用以下示例JSON文件来测试摄取流程。

填充数据集后,可以使用同一数据集摄取其他数据文件。

如果您的数据存储在受支持的第三方应用程序中,您还可以选择创建源连接器以将营销事件数据实时摄取到Platform中。

后续步骤

本文档就准备数据以在Intelligent Services中使用提供了一般指导。 如果您需要根据您的用例进行其他咨询,请联系Adobe咨询支持。

成功使用客户体验数据填充数据集后,可以使用Intelligent Services生成分析。 请参阅以下文档以开始操作:

在此页面上