(测试版)在UI中创建Marketo Engage源连接器

重要

Marketo Engage源当前处于测试阶段。 功能和文档属于主题更改。 此外,在测试版计划期间使用连接器时,还必须确保使用非生产沙盒。 有关沙箱的更多信息,请参阅沙箱文档

本教程提供了在UI中创建Marketo Engage(以下称“Marketo”)源连接器以将消费者数据导入Adobe Experience Platform的步骤。

快速入门

本教程需要对Adobe Experience Platform的以下组件有一定的了解:

  • 来源:Experience Platform允许从各种源摄取数据,同时让您能够使用Platform服务来构建、标记和增强传入数据。
  • 体验数据模型(XDM):Experience Platform组织客户体验数据的标准化框架。
  • 身份命名空间:身份命名空间是的组 Identity Service 件,用作与身份相关的上下文的指示器。完全限定的标识包括ID值和命名空间。
  • Real-time Customer Profile:根据来自多个来源的汇总数据提供统一的实时客户资料。
  • 沙盒:Experience Platform提供将单个Platform实例分区为单独虚拟环境的虚拟沙盒,以帮助开发和改进数字体验应用程序。

收集所需的凭据

要在Platform上访问您的Marketo帐户,必须提供以下值:

凭据 描述
munchkinId Munchkin ID是特定Marketo实例的唯一标识符。
clientId Marketo实例的唯一客户端ID。
clientSecret Marketo实例的唯一客户端密钥。

有关获取这些值的更多信息,请参阅Marketo 身份验证指南

收集所需的凭据后,即可执行下一节中的步骤。

连接Marketo帐户

在平台UI中,从左侧导航栏中选择​Sources​以访问Sources工作区。 Catalog屏幕显示可为其创建帐户的各种源。

您可以从屏幕左侧的目录中选择相应的类别。 或者,您也可以使用搜索栏找到要使用的特定源。

在Adobe应用程序类别下,选择​Marketo Engage。 然后,选择​添加数据​以创建新的Marketo数据流。

目录

出现​连接到Marketo Engage​页面。 在此页面上,您可以使用新帐户或访问现有帐户。

新帐户

如果要创建新帐户,请选择​新建帐户。 在显示的输入窗体中,提供帐户名称、可选描述和您的Marketo身份验证凭据。 完成后,选择​连接到源,然后允许一些时间建立新连接。

新帐户

现有帐户

要使用现有帐户创建数据流,请选择​现有帐户,然后选择要使用的Marketo帐户。 选择​下一步​以继续。

现有

选择数据集

创建Marketo帐户后,下一步会提供一个界面,供您浏览Marketo数据集。

界面的左半部分是目录浏览器,显示10个Marketo数据集。 要实现Marketo源连接的完全正常运行,需要摄取九个不同的数据集。 如果您还使用Marketo基于帐户的营销(ABM)功能,则还必须创建第10个数据流以摄取命名帐户数据集。

注意

为简便起见,以下教程以命名帐户为例,但下面概述的步骤适用于10个Marketo数据集中的任意一个。

选择要先摄取的数据集,然后选择​Next

select-data

将Marketo架构映射到平台

将显示映射步骤,提供一个接口将Marketo架构映射到平台。

为要摄取到的入站数据选择数据集。 您可以使用现有数据集或创建新数据集。

使用现有数据集

要将数据摄取到现有数据集,请选择​现有数据集,然后选择数据集图标。

现有数据集

出现​选择数据集​对话框。 找到包含您要使用的相应架构的数据集,将其选中,然后选择​Confirm

select-existing-dataset

使用新数据集

要将数据摄取到新数据集,请选择​New dataset ,然后在提供的字段中输入数据集的名称和说明。

您可以在​选择架构​搜索栏中输入其名称,以搜索架构。 您还可以选择下拉图标以查看现有架构的列表。 或者,您也可以选择​高级搜索​以访问现有架构的页面,包括其各自的详细信息。

切换​配置文件数据集​按钮以为Profile启用目标数据集,从而允许您创建实体属性和行为的整体视图。 所有启用Profile的数据集中的数据都将包含在Profile中,并在保存数据流时应用更改。

create-new-dataset

选择架构后,向下滚动以查看映射对话框,以开始将Marketo数据集字段映射到相应的目标XDM字段。

将Marketo数据集源字段映射到XDM字段

每个Marketo数据集都有其自己的特定映射规则要遵循。 有关如何将Marketo数据集映射到XDM的更多信息,请参阅以下内容:

选择​预览数据​以查看基于选定数据集的映射结果。

映射

预览弹出窗口提供了一个界面,用于浏览来自选定数据集的最多100行示例数据的映射结果。

预览

将源字段映射到相应的目标字段后,请选择​关闭

提供数据流详细信息

出现数据流详细信息步骤,允许您提供有关新数据流的名称和简要说明。

数据流详细信息

启用​错误诊断​切换开关,以允许为新摄取的批次生成详细的错误消息,您可以使用API下载这些消息。 有关更多信息,请参阅检索数据摄取错误诊断的教程。

错误

Marketo连接器使用批量摄取来摄取所有历史记录,并使用流式摄取来进行实时更新。 这允许连接器在摄取任何错误记录时继续流式传输。 启用​部分摄取​切换开关,然后将错误阈值%设置为最大值,以防止数据流失败。

部分 摄取提供了摄取包含错误且达到特定阈值的数据的功能。有关更多信息,请参阅部分批量摄取概述

提供数据流详细信息并将错误阈值设置为max后,请选择​Next

部分摄取

查看数据流

此时会出现​Review​步骤,允许您在创建新数据流之前查看新数据流。 详细信息按以下类别分组:

  • 连接:显示源类型、所选源实体的相关路径以及该源实体中的列数。
  • 分配数据集和映射字段:显示源数据被摄取到的数据集,包括该数据集附加的架构。

审核数据流后,选择​完成​并为创建数据流留出一些时间。

审查

监控数据流

创建数据流后,您可以监控通过其摄取的数据,以查看有关摄取率、成功和错误的信息。 有关如何监控数据流的更多信息,请参阅关于在UI中监控数据流的教程。

删除属性

数据集中的自定义属性不能以追溯方式隐藏或删除。 如果要隐藏或删除现有数据集中的自定义属性,则必须创建一个没有此自定义属性的新数据集、一个新的XDM架构,并为您创建的新数据集配置新的数据流。 您还必须禁用或删除原始数据流,该数据流包含具有您要隐藏或删除的自定义属性的数据集。

删除数据流

您可以删除不再需要或使用数据流工作区中提供的​Delete​函数错误地创建的数据流。 有关如何删除数据流的更多信息,请参阅有关在UI中删除数据流的教程。

后续步骤

在本教程中,您已成功创建了一个数据流以导入Marketo数据。 现在,下游Platform服务(如Real-time Customer Profile和Data Science Workspace)可以使用传入数据。 有关更多详细信息,请参阅以下文档:

在此页面上