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