适用于GenStudio的Marketo

在同一IMS组织中使用Marketo Engage和GenStudio for Performance Marketing的组织可以从Adobe Exchange安装GenStudio的​ Marketo ​应用程序。 系统管理员批准应用程序并完成部署后,作者可以在GenStudio中创建电子邮件体验时选择Marketo模板,并选择直接上传到Content的模板旁边。

本主题适用于安装应用程序、从Marketo收集凭据并在Exchange中部署应用程序的​管理员。 有关AJO和Marketo模板语法如何与GenStudio配合使用的信息,请参阅AJO和Marketo中的模板

先决条件

  • 必须在部署扩展的组织中配置Marketo Engage。
  • 部署该应用程序的用户需要​Marketo凭据。 若要创建和检索这些凭据,您必须具有​ Marketo产品管理员 ​访问权限(打开Marketo时,管理员​区域必须可用)。

从Adobe Exchange安装应用程序

  1. 打开Adobe Exchange并转到​Experience Cloud
  2. 打开Marketo for GenStudio列表。
    Adobe Exchange上的 Marketo for GenStudio列表 {width="75%"}
  3. 选择​ 免费 ​为您的组织请求应用。
  4. 在您的组织​ 审核并批准 ​请求后,继续获取Marketo凭据从Exchange部署应用程序

获取Marketo凭据

您使用的是来自​ Marketo ​实例(而非Adobe Developer Console)的凭据。 在Exchange中部署之前,请使用以下步骤收集以下凭据。

NOTE
要生成和检索Marketo凭据,您需要具有Marketo产品管理员访问权限,否则“管理员”选项卡在Marketo中不可见。

创建仅限API的用户(如果重用现有API用户,则可选)

  1. 在Marketo中,转到​管理员
    Marketo“管理员”选项卡 {width="80%"}
  2. 在​ 安全性 ​下,打开​用户和角色,然后转到​ 角色 ​选项卡。
  3. 通过添加以下权限创建新角色或编辑现有角色: 访问API​和​访问Design Studio
  4. 对于新API用户,单击​创建仅API用户 (对每个API用户使用唯一的电子邮件)。
  5. 选中“角色”复选框,然后分配您创建的新角色。 如果您已有要使用的API用户,请跳至创建或选择LaunchPoint服务

用户和角色具有仅API用户和API角色 {width="80%"}

创建或选择LaunchPoint服务

  1. 在​ 管理员 ​中,在​ 集成 ​下,打开​LaunchPoint
  2. 单击​ 创建 ​以创建新服务(或使用现有的自定义服务)。
    LaunchPoint自定义服务 {width="80%"}
  3. 对于您的服务,请单击​ 查看详细信息 ​并复制​ 客户端ID ​和​客户端密钥。 您将在Adobe Exchange 配置​中输入这些内容。

记下Marketo REST API基本URL

  1. 在​ 管理员 ​中,在​ 集成 ​下,打开​Web服务
  2. 找到​ REST API ​终结点。 仅复制​基本URL (主机),格式为https://###-XXX-###.mktorest.com。 请​ ​包含路径区段,如/rest/identity。 此值在每个Marketo实例中是唯一的。

Web服务REST API终结点基本URL {width="80%"}

您还将需要Exchange部署屏幕请求的​Marketo Engage标识URL,以及REST基本URL和LaunchPoint的客户端ID和客户端密钥。

从Exchange部署应用程序

要使扩展在GenStudio中可用,请从Adobe Exchange部署应用程序。

  1. 返回至Adobe Exchange
  2. 选择​管理,然后打开适用于GenStudio 应用程序的 Marketo(例如,在​ App Builder应用程序 ​下或您组织的托管应用程序下)。
  3. 在​ 环境 ​下,从下拉列表中选择一个现有环境,或选择​ 添加环境 ​以创建环境。
  4. 为所选环境打开​配置
  5. 为Marketo Engage标识URL和Marketo Engage REST API基本URL输入LaunchPoint中的​ 客户端ID ​和​客户端密钥Marketo Engage标识URL​和​Marketo Engage REST API基本URL (来自Web服务的基本​主机)。
  6. 单击​部署。 部署成功后,操作将更改为​取消部署

更新配置

要更改环境的配置值,请先​取消部署,更新字段,然后重新​部署

Workspace配置(可选)

如果要使用默认工作区,则可以跳过此步骤。 默认情况下,Workspace ID​和​ 模板列表页面大小 ​字段已预配置。

但是,如果您需要从其他工作区获取模板:

  1. 在Marketo中,导航到​管理员安全性工作区和分区
  2. 默认情况下,Workspace ID​列是隐藏的。 要启用该功能,请右键单击标题行(其中显示列名称)。
  3. 选择​
  4. 从列表中启用​ID
    启用了Workspace ID列的工作区和分区 {width="80%"}

显示后,为您的配置使用相应的​Workspace ID

访问GenStudio中的Marketo模板

安装和配置Marketo for GenStudio后,当您在GenStudio中创建​ 电子邮件 ​体验时,会显示​ Marketo模板 ​选项卡。 使用该选项卡浏览Marketo Engage中的模板。

IMPORTANT
在GenStudio for Performance Marketing中的​ 标准电子邮件 ​体验流下创建电子邮件。 此集成不支持使用新电子邮件编辑器体验创建的电子邮件。

使用Marketo凭据的 Exchange配置 {width="80%"}

故障排除

Marketo“模板”选项卡不可见

  • 确认该应用在Exchange中是​已批准,并且环境是​已部署,具有有效的客户端ID、客户端密钥和Marketo基本URL。
  • 请要求您的管理员验证在创建凭据时是否使用了​ Marketo产品管理员 ​访问权限。

未加载模板

  • 重新加载页面或注销并重新登录到GenStudio。
  • 在浏览器开发人员工具​ 网络 ​面板中,查找对您的Marketo实例的失败API调用,并验证REST基本URL是否与Marketo中的​ Web服务 ​匹配(主机后面没有额外路径)。

“未找到模板”错误

如果扩展安装成功,并且Marketo Templates选项卡可见,但显示“No templates found”(未找到模板),则问题可能是由应用程序在呈现模板时超出大小限制导致“崩溃”所致。
要解决此问题:

  1. 从Exchange中取消部署应用程序。
  2. 减小模板列表页面大小(例如,将其设置为1或2)。
  3. 重新部署应用程序。
recommendation-more-help
genstudio-for-performance-marketing-help-extensibility