Marketo 追加工具
Marketo 追加工具可使用您指定的传入数据流从您的 Marketo 实例检索相应记录。在以下情况下,使用追加工具非常有用:您已有电子邮件地址列表或已在使用的其他数据,并希望将这些数据与来自 Marketo 的其他信息结合起来,或查看它们是否已经存在于您的 Marketo 实例中。
工具配置
Marketo 凭证
URL :用于从中检索记录的 Marketo REST 实例。此信息可在 Marketo(管理员 > 集成 > Web 服务 > REST API)中找到。
客户端 ID :API 角色用户的客户端 ID。此信息可在 Marketo(管理员 > 集成 > 启动点)中找到。
客户端密码 :API 角色用户的客户端密码。此信息可在 Marketo(管理员 > 集成 > 启动点)中找到。
有关设置 Web 服务和用于访问 Marketo REST API 的用户角色的详细信息,请参阅 Marketo REST 文档 网站。
选项
此下拉列表将显示您已用作工具输入的字段列表。Marketo 将使用此字段查找 Marketo 实例中具有此字段值的线索记录。
传入字段是哪种类型的记录(电子邮件、SFDC ID 等)。
您想要从 Marketo 数据库检索的字段。这些字段以及传递到工具中的字段将在输出数据流中返回。
如果您选择的输出字段也包含在传入数据流中,则来自 Marketo 的输出字段将在末尾被重命名为 2。
数据注意事项
错误消息(比如身份验证失败等)将显示在配置窗口中。工作流中的工具上将显示错误消息(比如缺少配置选择)。
该工具分批次发送记录(一批 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
两个时间相同,代表相同的时刻。