为 Marketo 创建或编辑端点

端点提供 Studio 和 Integration Appliance 用于连接到 Marketo 平台的配置信息。Marketo 连接器仅支持 OAuth 认证机制以授权用户执行操作。Marketo 连接器仅支持 HTTPS 连接。

选择或编辑 Marketo 端点

  1. 创建端点编辑端点窗格中,配置下表中所述的 Marketo 端点。
    注: 更改端点的配置属性会影响项目中使用该端点的所有编排。编辑是全局性的,而不是局部性的。
  2. 单击测试连接以确认连接详细信息有效,并且您能够成功连接到 Marketo。
  3. 单击确定
表 1. 连接属性
字段名 描述
主机名 Marketo 实例(云)的主机名
API 版本 Marketo 实例的 API 版本。缺省值:v1
客户机标识 用于访问 Marketo 实例的 OAuth 客户机标识
客户机密钥 用于访问 Marketo 实例的 OAuth 客户机密钥

端点测试连接屏幕上需要以下参数以通过代理建立连接:

字段名 描述
主机名 代理网络的主机名
端口 代理网络的端口号
用户名 用于通过代理网络访问服务的用户名
密码 用于通过代理网络访问服务的密码
注: 在每个活动的“映射输入”部分中,提供了端点面板的相关字段以便在运行时覆盖。用户可以向不同的参数组提供数据以进行覆盖,例如,“代理详细信息”、“连接详细信息”或“认证详细信息”。不允许在选中组中仅提供部分字段数据进行覆盖。

受 Marketo 连接器支持的对象

以下对象受 Marketo 连接器以及可用于受支持对象的 API 的支持:

表 2. CRUD 操作
Marketo 对象 创建 更新 增删改 删除 检索全部 检索 搜索
商机
列表
竞销活动
商机
公司
销售人员
定制对象
商机角色
商机活动
已删除商机
商机更改
活动类型
文件夹
文件夹内容
电子邮件模板
电子邮件模板内容
电子邮件
电子邮件内容
电子邮件动态内容
片段
片段内容
片段动态内容
文件
分段
分段

原子操作

  • 针对商机
    • 合并商机
    • 获取页面调度令牌
  • 针对列表
    • 从列表中除去商机
    • 将商机添加到列表中
    • 列表的成员
  • 商机的批量 API
    • 导入商机
    • 获取导入商机状态
    • 获取导入失败文件
    • 获取导入警告文件
  • 针对竞销活动
    • 安排竞销活动
    • 请求竞销活动
  • 针对电子邮件
    • 在可编辑部分中更新电子邮件内容
    • 发送样本电子邮件
  • 针对电子邮件、电子邮件模板和片段
    • 批准对象
    • 驳回对象
    • 丢弃草稿对象
    • 克隆对象

定制对象支持:

Marketo 支持定制对象。用户只能使用 Marketo UI 定义定制对象。一旦定义了定制对象,用户便可使用连接器来“创建”、“更新”、“增删改”、“删除”和“搜索”定制对象记录。

由于连接器使用的是基于 XML 的输入/输出,因此仅支持其名称符合以下条件的那些“定制对象”:
  • 以字母开头
  • 仅包含字母数字字符
  • 仅有特殊字符 _(下划线)
注: 活动的对象列表中将不会列出不符合上述条件的定制对象。

定制字段支持

Marketo 仅对商机对象和定制对象支持定制字段。

对于“创建”和“更新”活动,在商机的“映射输入”中,对象将针对定制字段具有其他节点,以便用户能够为其提供值。

对于“检索”、“检索全部”和“搜索”活动,响应对象将具有定制字段数据(如存在)。

例如,商机对象映射输入/输出:

 company
 billingStreet
 billingCity
 . .
 customField1
 customField2