Marketo for GenStudio

Organizations that use Marketo Engage and GenStudio for Performance Marketing in the same IMS organization can install the Marketo for GenStudio app from Adobe Exchange. After a system administrator approves the app and completes deployment, authors can choose Marketo templates while creating email experiences in GenStudio, next to templates uploaded directly to Content.

This topic is for administrators who install the app, gather credentials from Marketo, and deploy the app in Exchange. For how AJO and Marketo template syntax works with GenStudio, see Templates from AJO and Marketo.

Prerequisites

  • Marketo Engage must be provisioned in the organization where you deploy the extension.
  • Users who deploy the application need Marketo credentials. To create and retrieve those credentials, you must have Marketo Product Admin access (the Admin area must be available when you open Marketo).

Install the app from Adobe Exchange

  1. Open Adobe Exchange and go to Experience Cloud.
  2. Open the Marketo for GenStudio listing.
    Marketo for GenStudio listing on Adobe Exchange {width="75%"}
  3. Select Free to request the app for your organization.
  4. After your organization reviews and approves the request, continue with Get Marketo credentials and Deploy the application from Exchange.

Get Marketo credentials

You use credentials from your Marketo instance (not the Adobe Developer Console). Collect the following before you deploy in Exchange.

Create an API-only user (optional if you reuse an existing API user)

  1. In Marketo, go to Admin.
  2. Under Security, open Users & Roles.
  3. For a new API user, click Create API Only User (use a unique email for each API user). Assign the API Roles (all Workspaces) role (or the roles your organization requires). If you already have an API user you want to use, skip to Create or select a LaunchPoint service.

Users & Roles with API Only User and API roles {width="80%"}

Create or select a LaunchPoint service

  1. In Admin, under Integration, open LaunchPoint.
  2. Click Create to create a new Service (or use an existing custom service).
    LaunchPoint custom service {width="80%"}
  3. For your service, click View Details and copy the Client ID and Client Secret. You will enter these in Adobe Exchange Configuration.

Note your Marketo REST API base URL

  1. In Admin, under Integration, open Web Services.
  2. Find the REST API endpoint. Copy only the base URL (host), in the form https://###-XXX-###.mktorest.com. Do not include path segments such as /rest or /identity. This value is unique per Marketo instance.

Web Services REST API endpoint base URL {width="80%"}

You will also need the Marketo Engage Identity URL that your Exchange deployment screen requests, alongside the REST base URL and the Client ID and Client Secret from LaunchPoint.

Deploy the application from Exchange

To make the extension available in GenStudio, deploy the app from Adobe Exchange.

  1. Return to Adobe Exchange.
  2. Select Manage and open the Marketo for GenStudio app (for example under App Builder applications or your organization’s managed apps).
  3. Under Environments, choose an existing environment from the dropdown or select Add Environment to create one.
  4. Open Configuration for the selected environment.
  5. Enter the Client ID and Client Secret from LaunchPoint, the Marketo Engage Identity URL, and the Marketo Engage REST API Base URL (the base host from Web Services).
  6. Click Deploy. When deployment succeeds, the action changes to Undeploy.

Update configuration

To change configuration values for an environment, Undeploy first, update the fields, then Deploy again.

Access Marketo templates in GenStudio

After Marketo for GenStudio is installed and configured, a Marketo Templates tab appears when you create an Email experience in GenStudio. Use that tab to browse templates from Marketo Engage.

IMPORTANT
Create emails under the standard Email experience flow in GenStudio for Performance Marketing. This integration does NOT support emails created with the new email editor experience.

Exchange Configuration with Marketo credentials {width="80%"}

Troubleshooting

Marketo Templates tab is not visible

  • Confirm the app is Approved in Exchange and the environment is deployed with valid Client ID, Client Secret, and Marketo base URLs.
  • Ask your administrator to verify Marketo Product Admin access was used when creating credentials.

Templates do not load

  • Reload the page or sign out and back in to GenStudio.
  • In the browser developer tools Network panel, look for failed API calls to your Marketo instance and verify the REST base URL matches Web Services in Marketo (no extra path after the host).
recommendation-more-help
genstudio-for-performance-marketing-help-extensibility