创建 Marketo Engage UI中的源连接和数据流
本教程提供了用于创建 Marketo Engage (以下简称“Marketo") UI中的源连接器,用于将B2B数据引入Adobe Experience Platform。
快速入门
本教程需要对以下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 account on account(Experience Platform帐户),您必须提供以下值:
munchkinId
clientId
clientSecret
有关获取这些值的详细信息,请参阅 Marketo 身份验证指南.
收集所需的凭据后,您可以按照下一部分中的步骤操作。
连接您的 Marketo 帐户
在Platform UI中,选择 源 从左侧导航访问 源 工作区。 您可以从屏幕左侧的目录中选择相应的类别。 或者,您可以使用搜索选项查找您要使用的特定源。
在 Adobe应用程序 类别,选择 Marketo Engage,然后选择 添加数据.
此 连接Marketo Engage帐户 页面。 在此页面上,您可以使用新帐户或访问现有帐户。
要创建新帐户,请选择 新帐户 并提供名称、可选描述和您的凭据。
完成后,选择 连接到源 然后等待一段时间以建立新连接。
要使用现有帐户,请选择 现有帐户 然后从现有帐户目录中选择要使用的帐户。
选择 下一步 以继续。
选择数据集
创建之后 Marketo 帐户,下一步会为您提供一个浏览界面 Marketo 数据集。
界面的左半部分是一个目录浏览器,显示10 Marketo 数据集。 功能齐全的 Marketo 源连接需要摄取九个不同的数据集。 如果您还使用 Marketo 基于帐户的营销(ABM)功能,则还必须创建第10个数据流以摄取 指定帐户 数据集。
选择要摄取的数据集。 这将更新界面以显示数据集的预览。 完成后,选择 下一个.
提供数据集和数据流详细信息 provide-dataset-and-dataflow-details
接下来,您必须提供有关数据集和数据流的信息。
数据集详细信息 dataset-details
数据集是用于数据集合的存储和管理结构,通常是表格,其中包含架构(列)和字段(行)。成功引入Experience Platform的数据将作为数据集存储在数据湖中。 在此步骤中,您可以创建新数据集或使用现有数据集。
要使用新数据集,请选择 新数据集 然后为数据集提供名称和可选描述。 您还必须选择数据集所遵循的体验数据模型(XDM)架构。
如果您已经有一个现有数据集,请选择 现有数据集 然后使用 高级搜索 选项可查看贵组织中所有数据集的窗口,包括其各自的详细信息,如是否启用它们以摄取到Real-time Customer Profile。
数据流配置 dataflow-configurations
如果您的数据集启用了实时客户资料,那么在此步骤中,您可以切换 配置文件数据集 为配置文件摄取启用数据。 您还可以使用此步骤来启用 错误诊断 和 部分摄取.
- 错误诊断:选择 错误诊断 指示源生成错误诊断,以便以后在监视数据集活动和数据流状态时可以参考这些诊断。
- 部分摄取: 部分批次摄取 能够摄取包含错误的数据,最大程度达到特定可配置阈值。 此功能允许您成功地将所有准确的数据提取到Experience Platform中,同时所有不正确的数据将单独进行批处理并显示有关其无效原因的信息。
在此步骤中,您可以启用 示例数据流 以限制数据摄取,并避免摄取所有历史数据(包括人员身份)时产生的额外成本。
使用示例数据流的快速指南
示例数据流是可为设置的配置 Marketo 数据流以限制您的摄取率,然后尝试Experience Platform功能而不必摄取大量数据。
- 启用示例数据流,通过在回填作业期间摄取最多10万条记录(从最大的记录ID)或最多10天的活动,来限制历史数据。
- 为所有B2B实体使用示例数据流配置时,您必须考虑可能缺少某些相关记录,因为未摄取源数据的整个历史记录。
此外,如果您从公司数据集中摄取数据,则可以启用 排除无人认领的帐户 从引入中排除无人认领的帐户。
当个人填写表格时, Marketo 根据不包含其他数据的公司名称创建虚拟帐户记录。 对于新数据流,默认情况下会启用排除无人认领帐户的切换功能。 对于现有数据流,您可以启用或禁用该功能,所做的更改将应用于新摄取的数据,而不应用于现有数据。
映射您的 Marketo 数据集源字段到目标XDM字段
此 映射 此时会显示步骤,为您提供用于将源架构中的源字段映射到目标架构中相应的目标XDM字段的界面。
每个 Marketo 数据集有自己的特定映射规则要遵循。 有关如何映射的更多信息,请参阅以下内容 Marketo 数据集到XDM:
根据需要,您可以选择直接映射字段,或使用数据准备函数转换源数据以派生计算值或计算值。 有关使用映射界面的完整步骤,请参见 数据准备UI指南.
映射集准备就绪后,选择 下一个 并留出片刻时间创建新数据流。
查看您的数据流
此 审核 此时会显示步骤,允许您在创建新数据流之前对其进行查看。 详细信息分为以下类别:
- 连接:显示源类型、所选源实体的相关路径以及该源实体中的列数。
- 分配数据集和映射字段:显示要将源数据摄取到哪个数据集,包括数据集所遵循的架构。
查看数据流后,选择 保存并摄取 留出一段时间来创建数据流。
监测数据流
创建数据流后,您可以监视通过它摄取的数据,以查看有关摄取率、成功和错误的信息。 有关如何监视数据流的更多信息,请参阅关于的教程 在UI中监控数据流.
删除您的属性
无法以追溯方式隐藏或删除数据集中的自定义属性。 如果要从现有数据集中隐藏或移除自定义属性,则必须创建一个没有此自定义属性的新数据集和新的XDM架构,并为您创建的新数据集配置新数据流。 您还必须禁用或删除原始数据流,该数据流包含具有要隐藏或删除的自定义属性的数据集。
删除您的数据流
您可以删除不再必需的数据流或使用 删除 函数位于 数据流 工作区。 有关如何删除数据流的更多信息,请参阅关于的教程 在UI中删除数据流.
后续步骤
通过学习本教程,您已成功创建了一个数据流以从摄取B2B数据 Marketo Engage 要Experience Platform的源。
附录 appendix
以下部分提供了在使用时,您可以遵循的其他准则 Marketo 源。
UI中的错误消息 error-messages
当Platform检测到您的设置存在问题时,UI中会显示以下错误消息:
Munchkin ID 未映射到相应的组织
在以下情况下,身份验证将被拒绝: Munchkin ID 未映射到您正在使用的平台组织。 配置以下对象之间的映射: Munchkin ID 和您的组织使用 Marketo 界面.
缺少主要身份
如果缺少主标识,数据流将无法保存和摄取。 确保 您的XDM架构中存在主标识,然后尝试配置数据流。