Marketo 输入工具
Marketo 输入工具
Marketo 输入工具根据特定参数读取 Marketo 记录。如果没有任何数据可供开始使用，或者要从 Marketo 实例中采样数据，请使用 Marketo 输入工具。如果您有要加入 Marketo 附加数据的数据，则 Marketo 追加工具是更好的选择。
重要
此工具不会随 Designer 自动安装。要使用此工具，请从 Alteryx 社区 进行下载。
工具配置
Marketo 凭证
URL ：用于从中检索记录的 Marketo REST 实例。此信息可在 Marketo（管理员 > 集成 > Web 服务 > REST API）中找到。
客户端 ID ：API 角色用户的客户端 ID。此信息可在 Marketo（管理员 > 集成 > 启动点）中找到。
客户端密码 ：API 角色用户的客户端密码。此信息可在 Marketo（管理员 > 集成 > 启动点）中找到。
有关设置 Web 服务和用于访问 Marketo REST API 的用户角色的详细信息，请参阅 Marketo REST 文档 网站。
选项
可以检索两种类型的 Marketo 记录：
线索记录 ：这些是线索记录，每个线索将有一个记录。
线索活动记录 ：这些记录跟踪每个线索的活动。每个线索记录可能有许多线索活动记录。
根据记录类型的选择，可以使用不同的选项，根据选择，将有可配置的参数 - 有些是可选的，有些是必需的。下表详细说明了根据您选择的配置需要哪些参数。
记录类型 | 选项类型 | 列表 | 活动类型 (1-10) | 输出字段 | 开始日期/时间 |
|---|---|---|---|---|---|
Lead Records（潜在客户记录） | 按活动类型 | 可选 | 必填 | 可选 | 必填 |
Lead Records（潜在客户记录） | 按列表 ID | 必填 | N/A | 可选 | N/A |
Lead Records（潜在客户记录） | 按前导更改 | 可选 | N/A | N/A | 必填 |
前导活动 | 按活动类型 | N/A | 必填 | N/A | 必填 |
前导活动 | 按前导更改 | N/A | N/A | N/A | 必填 |
参数
列表 ：配置中指定的 Marketo 实例的所有静态列表都在此处列出（智能列表当前不能通过 API 提供）- 每个请求只允许 1 个列表选择。
活动类型 ：此处列出了 Marketo 中可用的所有活动类型，每个请求最多有 10 个活动类型选择。
输出字段 ：将列出 Marketo 实例中的所有可用字段。如果没有选择，将返回默认字段列表：电子邮件、线索 ID、名字、姓氏、更新时间、创建时间。
开始日期/时间 ：指定数据库中开始检索记录的起点。
数据注意事项
错误消息（比如身份验证失败等）将显示在配置窗口中。工作流中的工具上将显示错误消息（比如缺少配置选择）。
该工具分批次发送记录（一批 300 条或更少），每个批次都将作为一个独立的 API 调用，计入 Marketo 设定的每日限制。
Marketo REST API 每天限制为 10,000 个请求，而对 REST API 的请求不计入 SOAP API 每日限制。
您希望确保在 Alteryx 中维护 Marketo 字段结构，然后再响应 Marketo，以避免出错。只要字段名称有效，Marketo 连接器将在将数据输出到 Marketo 之前将数据转换为正确的数据类型。如果在 Marketo 中找不到字段名称，输出将失败。
日期时间字段
Marketo 中的所有日期在存储时带有 UTC 偏移。此格式由本地时间组成，附加的偏移可以是正数或负数。例如，Marketo 中的日期时间值可能如下所示，其中，插入 Marketo 的日期来自的时区早于 UTC 时间（山地夏令时）6 小时：
2012-02-28 14:00:00-06:00
从 Marketo 读取数据
为了让 Alteryx Artisan 更轻松地使用这些日期时间值，Alteryx 会把从 Marketo 读取的日期时间值转换为机器本地日期时间值。这使得 Artisan 可以使用采用本地时间的日期时间值。例如，假设您的时间也比 UTC 时间早 6 小时，那么，上述日期时间值在 Alteryx 工作流或应用程序中将如下所示：
2012-02-28 14:00:00
或者，如果您只比 UTC 早 4 小时，则会为您返回以下格式的日期时间：
2012-02-28 16:00:00
将日期写入 Marketo
使用“插入”或“更新”操作将日期时间值写入 Marketo 时，Alteryx 会将该值转换回 Marketo 所期望的格式。通过计算本地机器 UTC 偏移并将其附加到日期时间值的末尾来完成此操作。如上例所示，Alteryx 将在日期时间值的日期和时间部分之间放置一个“T”。
在以上示例中，如果写入的日期时间值来自的时区具有 -6:00 的偏移，如下所示：
2012-02-28 14:00:00-06:00
然后从 UTC 偏移为 -4:00 小时的计算机写回到 Marketo（未经修改），它写回 Marketo 时的格式如下所示：
2012-02-28 16:00:00-04:00
两个时间相同，代表相同的时刻。