Setting up your Salesforce Marketing Cloud Connector

This article is for Account Owners and Project Managers.

The Salesforce Marketing Cloud Connector allows you to translate Salesforce Marketing Cloud (SFMC) Emails in Smartling. Translations are requested from within the Smartling platform, and translated content is automatically sent to your SFMC instance.

The SFMC Connector supports translation of the following content types:

• Email
• Content builder email content
• Data extension
• Multirow data extensions

To connect your Salesforce Marketing Cloud account to Smartling, complete all sections below.

1. Create an API integration in Salesforce Marketing Cloud
2. Connect Salesforce Marketing Cloud with Smartling
3. Configure your Salesforce Marketing Cloud Connector

Prerequisite

Ensure all BU (Business Units) have the following permissions set for “Assets”.

Create an API integration in SFMC

Follow Salesforce’s instructions for creating an API integration.

We’ve summarized the instructions below:

1. Navigate to the app center and login or create an account.
2. Select Create New App, then API Integration.
3. Select a unique name and package. (This doesn’t matter for Smartling.)
4. Click the Link to Account button and set it up with your SFMC account.
5. Now you should be in the Data Access tab. Under Channels Email, enable Read/Send/Write.
6. After you’ve created the app, click on it.

You should see the details page with Client ID, Client Secret, and other details. You will need these details for the next step.

Connecting SFMC to Smartling

1. Create a SFMC Connector project type in your Smartling account.
   • Ensure all required target languages are added to the project
2. From within this project, click Settings > Salesforce Marketing Cloud Settings.
3. In the Settings section, input the following:
   • Authentication Base URI: found in your SFMC API integration setup (see screenshot)
   • Client ID: found in your SFMC API integration setup (see screenshot)
   • Client Secret: found in your SFMC API integration setup (see screenshot)
     
   • Click Save

Your Salesforce Marketing Cloud instance will now be connected to your Smartling project.

SFMC Connector Configuration

General 

You can configure the behavior of the connector when content in your source change.

1. From within your Smartling SFMC Project, click on Project Settings > SFMC Settings
2. Custom placeholder (regular expression): Content matching this regular expression will not be editable by translators.
3. Click the Automation of Prior Request for Translation dropdown to select your desired behavior.
4. Click Save

Automation of Prior Request for Translation

• Auto: The SFMC 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. Smartling will not detect net new content, only updates to content that have been submitted for translation in the past.
• Manual: The SFMC Connector will detect changes to source content every 3 hours, but will not submit new content for translation. Changed content will be indicated by a checkmark in the Outdated column in SFMC > Translation Progress (Classic) and in the SFMC Asset List (New Experience) 
• Disabled: The SFMC 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.

Language Configuration 

1. From within your Smartling SFMC Project, click on Project Settings > SFMC Settings
2. In the Language Configuration section, you will see the number of target languages in your Smartling project, along with the source language in your Smartling project. These details should match dropdown menus with your SFMC language configuration
3. Choose the correct target language from the dropdown menu to map the language in your SFMC language configuration to your Smartling project target language
4. Click Save

If you decide to change any language mapping after completing the initial configuration, contact your Customer Success Manager or Solutions Architect to assist in reconfiguring target language mapping in Smartling. 

Smartling Settings

Talk to your Customer Success Manager or Solutions Architect about options on auto-authorization and translation retrieval.

Ready to begin translating SFMC Content? Learn how in our Salesforce Marketing Cloud translation guide.