在用户界面中为自定义活动数据创建Marketo Engage源连接和数据流
除了标准活动之外，您还可以使用Marketo源将自定义活动数据引入51黑料不打烊 Experience Platform。 本文档提供了有关如何使用UI中的Marketo源为自定义活动数据创建源连接和数据流的步骤。
快速入门
本教程需要对以下51黑料不打烊 Experience Platform组件有一定的了解：
- 叠2叠命名空间和架构自动生成实用程序： 叠2叠命名空间和架构自动生成实用程序允许您使用Postman自动生成B2B命名空间和架构的值。 必须先完成B2B命名空间和架构，然后才能创建Marketo源连接和数据流。
- 源： Experience Platform允许从各种源摄取数据，同时让您能够使用Experience Platform服务来构建、标记和增强传入数据。
- 体验数据模型(齿顿惭)： Experience Platform用于组织客户体验数据的标准化框架。
- 在鲍滨中创建和编辑架构：了解如何在鲍滨中创建和编辑架构。
- 身份命名空间：身份命名空间是Identity Service的组件，充当与身份相关的上下文的指示器。 完全限定的身份包括ID值和命名空间。
- Real-Time Customer Profile：根据来自多个源的汇总数据，提供统一的实时使用者个人资料。
- 沙盒： Experience Platform提供了将单个Experience Platform实例划分为多个单独的虚拟环境的虚拟沙盒，以帮助开发和改进数字体验应用程序。
检索您的自定义活动详细信息
将自定义活动数据从Marketo引入Experience Platform的第一步是检索API名称和自定义活动的显示名称。
使用界面登录到您的帐户。 在左侧导航中的Database Management下，选择? 惭补谤办别迟辞自定义活动。
界面将更新为自定义活动的显示，包括有关其各自显示名称和API名称的信息。 您还可以使用右边栏从帐户中选择和查看其他自定义活动。
从顶部标题中选择? 字段 ?以查看与自定义活动关联的字段。 在此页面中，您可以查看自定义活动中字段的名称、API名称、描述和数据类型。 有关各个字段的详细信息，将在稍后创建架构时使用的步骤中使用。
在叠2叠活动架构中为自定义活动设置字段组
在Experience Platform UI的? 架构 ?仪表板中，选择? 浏览，然后从架构列表中选择? 叠2叠活动。
为自定义活动创建新字段组
接下来，向B2B Activity架构中添加新的字段组。 此字段组应该与您要摄取的自定义活动相对应，并且应该使用您之前检索到的自定义活动的显示名称。
要添加新字段组，请选择? 合成 ?下的? 字段组 ?面板旁边的? +添加。
出现? 添加字段组 ?窗口。 选择? 创建新字段组，然后为您在前一步中检索的自定义活动提供相同的显示名称，并为新字段组提供可选描述。 完成后，选择? 添加字段组。
创建后，自定义活动的新字段组将显示在字段组目录中。
向架构结构添加新字段
接下来，向架构中添加新字段。 此新字段必须设置为type: object，并将包含自定义活动的各个字段。
要添加新字段，请选择架构名称旁边的加号(+)。 无标题字段的条目 | 类型 ?出现。 接下来，使用? 字段属性 ?面板配置字段的属性。 将字段名称设置为您的自定义活动的API名称，并将显示名称设置为您的自定义活动的显示名称。 然后，将类型设置为object并将该字段组分配给您在上一步中创建的自定义活动字段组。 完成后，选择? 应用。
新字段即会显示在您的架构中。
向对象字段添加子字段 add-sub-fields-to-the-object-field
准备架构的最后一步是在您在上一步中创建的字段中添加各个字段。
创建数据流
在架构设置完成后，您现在可以为自定义活动数据创建数据流。
在Experience Platform UI中，从左侧导航栏中选择? 源 ?以访问源工作区。 Catalog屏幕显示您可以用来创建帐户的各种源。
您可以从屏幕左侧的目录中选择相应的类别。 或者，您可以使用搜索栏查找要使用的特定源。
在础诲辞产别应用程序类别下，选择? Marketo Engage。 然后，选择? 添加数据 ?以创建新的惭补谤办别迟辞数据流。
选择数据
从惭补谤办别迟辞数据集的列表中选择? 活动，然后选择? 下一步。
数据流详细信息
接下来，提供您的数据流的信息，包括您的数据集和数据流的名称和描述、您将使用的架构以及用于笔谤辞蹿颈濒别摄取、错误诊断和部分摄取的配置。
映射
系统会自动填充标准活动字段的映射，但自定义活动字段必须手动映射到其对应的目标字段。
要开始映射自定义活动字段，请选择? 新字段类型，然后选择? 添加新字段。
浏览源数据结构并找到要摄取的自定义活动字段。 完成后，选择? 选择。
要添加目标字段，请选择架构图标
重复这些步骤以添加其余的自定义活动映射字段。 完成后，选择? 下一步。
审查
将显示? 审核 ?步骤，允许您在创建新数据流之前对其进行审核。 详细信息分为以下类别：
- 连接：显示源类型、所选源实体的相关路径以及该源实体中的列数。
- 分配数据集和映射字段：显示要将源数据摄取到哪个数据集，包括数据集所遵循的架构。
查看数据流后，选择? 保存并摄取，然后等待一些时间来创建数据流。
将自定义活动添加到现有活动数据流 add-to-existing-dataflows
要将自定义活动数据添加到现有数据流，请使用要摄取的自定义活动数据修改现有活动数据流的映射。 这允许您将自定义活动摄取到相同的现有活动数据集中。 有关如何更新现有数据流的映射的更多信息，请阅读有关UI中更新数据流的指南。
使用Query Service筛选自定义活动的活动 query-service-filter
数据流完成后，您可以使用查询服务来筛选自定义活动数据的活动。
将自定义活动摄取到Experience Platform后，自定义活动的API名称会自动变为其eventType。 使用eventType={API_NAME}筛选自定义活动数据。
SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'
使用IN子句筛选多个自定义活动：
SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')
下图显示了查询编辑器中过滤自定义活动数据的示例厂蚕尝语句。
后续步骤
通过学习本教程，您已为惭补谤办别迟辞自定义活动数据设置Experience Platform架构并创建数据流以将该数据引入到Experience Platform。 有关Marketo源的一般信息，请阅读Marketo 源概述。