Setting Up Your Marketo Connector

The Smartling Marketo connector allows you to translate Marketo content with context. Translations are requested from within the Smartling platform, and translated content is automatically sent to your Marketo instance. Smartling’s Marketo Connector currently ingests all assets and related assets* within the following Marketo content types, including dynamic content where it is supported

• Emails (template and detached)
• Landing pages
• Forms
• Snippets

Step One: Create a Connector Project in Smartling

Step one in setting up a Connector in Smartling is always to set up a Connector Project in Smartling. Read about how to create a Project here.

Create an API User Role in Marketo

To use the connector, you first need to create the following in Marketo:

1. A dedicated API user
   • Required user permissions:
     1. Read-Write Assets
     2. Edit and approve Assets
   • We recommend creating a custom API role with this access for this API user.
     
     
2. A LaunchPoint service in the Marketo dashboard 

To complete the above, follow the steps in the Quickstart Guide for Marketo REST API.

Connect Marketo to Smartling

1. Log into Marketo.
2. Log into Smartling.
3. Create a Marketo Connector project type in your Smartling Account.
   • Ensure all required target languages are added to the project
4. From within this project, click the Project Settings tab > Marketo Settings
5. Click Connect to Marketo.
6. Enter the following credentials:
   1. Client ID: Available from Marketo Admin Dashboard in Integration > Launchpoint.
   2. Client Secret: Available from Marketo Admin Dashboard in Integration > Launchpoint.
   3. Endpoint: Available from Marketo Admin Dashboard in Integration > Web Services.
   4. Identity: Available from Marketo Admin Dashboard in Integration > Web Services.
7. Click Save.

Your Marketo instance will now be connected to your Smartling project.

Configure the Marketo Connector

When you have successfully completed connecting Marketo to Smartling, the Marketo Setting page has the following configurations

• General
• Language Configuration

General

You can configure the behavior of the connector when source content that has previously been translated in Smartling changes:

1. From within your Smartling Marketo Project, click on Project Settings > Marketo Settings
2. Click the Automation of Prior Request for Translation dropdown to select your desired behavior.
3. Configure publishing options for delivered translations in Marketo
4. To apply changes, click Save

Automation of Prior Request for Translation

• Auto: The Marketo Connector will detect changes to source content every 3 hours. Any changes detected to the source content will be submitted to Smartling for translation, batched into a Job and sit in awaiting authorization. However, if auto-authorize is enabled under Smartling Settings, the updated content will be batched into a Job and automatically authorized for translation. Smartling will not detect net new content, only updates to content that have been submitted for translation in the past.
• Manual: The Marketo Connector will detect changes to source content every 3 hours, but will not submit new content for translation.
• Disabled: The Marketo Connector will not detect changes to source content or automatically submit new changes.

3 hours is the recommended shortest time duration between checks. Talk to your Solutions Architect about changing the frequency to longer wave periods using cron.

We recommend that you do not combine Jobs Automation rules with automation of prior requests for translation settings, as doing so may result in unexpected behavior.

Language Configuration 

The Smartling Marketo Connector allows you to set custom locale codes (ie. fr-FR vs. fr vs. French) in the File Name generated when we return translated assets back to Marketo. You must enter a value in this section otherwise the connector will not pick up that target language.

To enter locale values:

1. From within this project, click Project Settings > Marketo Settings.
2. Enter your desired locale code in the Target Languages column.
3. Click on the checkmark that appears to save.

Smartling Settings

Talk to your Customer Success Manager or Solutions Architect about options on auto-authorization, visual context, translation retrieval states, namespace, and placeholder formats.

Ready to translate Marketo content? See our Marketo translation guide.