Marketo 输出工具
Marketo 输出工具
使用 Marketo 输出调用 Marketo REST API 端点：创建/更新线索。数据将根据您在配置中选择的操作输出到 Marketo。
重要
此工具不会随 Alteryx Designer 自动安装。要使用此工具，请从 Alteryx 社区 进行下载。
配置工具
Marketo 凭证
URL ：用于从中检索记录的 Marketo REST 实例。此信息可在 Marketo（管理员 > 集成 > Web 服务 > REST API）中找到。
客户端 ID ：API 角色用户的客户端 ID。此信息可在 Marketo（管理员 > 集成 > 启动点）中找到。
客户端密码 ：API 角色用户的客户端密码。此信息可在 Marketo（管理员 > 集成 > 启动点）中找到。
有关设置 Web 服务和用于访问 Marketo REST API 的用户角色的详细信息，请参阅 Marketo REST 文档 网站。
选项
关键字段 ：此下拉列表显示您已用作工具输入的字段列表。Marketo 使用此字段查找任何重复记录。如果未指定字段，则默认情况下使用电子邮件。
如果记录中包含字段“id”，则必须选择“id”作为关键字段。
选择 输出操作 。
创建或更新（默认） ：根据关键字段，如果线索不存在，则创建线索，如果线索存在，则更新线索。
创建重复项 ：创建另一个线索（即使该线索已存在）。
仅更新 ：更新线索（如果已存在），如果不存在，则不执行任何操作。
仅创建 ：如果线索不存在，则创建新线索，如果存在，则跳过该线索。
分区名称 ：如果正在访问的 Marketo 实例设置了分区，则它们将列在下拉列表中。如果要写入的实例设置了线索分区，则需要选择此字段。如果没有可用分区，则使用“默认”。
数据注意事项
提交的记录的摘要状态在结果窗口中列为一条消息。
根据您提交的记录，跳过了 3 条记录，创建了 2 条记录。
错误消息（比如身份验证失败等）将显示在配置窗口中。工作流中的工具上将显示错误消息（比如缺少配置选择）。
该工具分批次发送记录（一批 300 条或更少），每个批次都将作为一个独立的 API 调用，计入 Marketo 设定的每日限制。有关每日限制的信息，请访问 Marketo REST API 文档 。对 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
两个时间相同，代表相同的时刻。