This article is for Account Owners and Project Managers.
Please note that this Connector is a paid product. For pricing information, please reach out to your Smartling Customer Success Manager.
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.
Create an API integration in SFMC
Follow Salesforce's instructions for creating an Install Package.
We've summarized the instructions below:
In Marketing Cloud, go to Setup > Apps > Installed Packages
Click New
Give the package a name and description (this is not visible in Smartling)
Under Components, click Add Component, and select an "API Integration" component
Click the Next
Select "Server-to-Server" as the Integration Type
Click Next
Select the following options on the "Set Server-to-Server Properties:
Email: Read, Write
Documents and Images: Read, Write
Saved Content: Read, Write
Data Extensions: Read, Write
Tags: Read
Accounts: Read
Configure Access to Business Units
If you plan to use "Shared Content" folders for translating "Content Block" or "Content Builder Email" then you need to configure access to Business Units in Salesforce. Do the following:
Navigate to the "Access" tab
Select each BU from which you intend to translate assets.
For example, if you intend to translate emails from the "EU Unit" then enable it
Click Save
Here you can find the details page with Client ID, Client Secret, and other details. You will need these details to connect SFMC to Smartling.
Connecting SFMC to Smartling
Create a SFMC Connector project type in your Smartling account.
Ensure all required target languages are added to the project
From within this project, click Settings > Salesforce Marketing Cloud Settings.
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.
From within your Smartling SFMC Project, click on Project Settings > SFMC Settings
Custom placeholder (regular expression): Content matching this regular expression will not be editable by translators.
Click the Automation of Prior Request for Translation dropdown to select your desired behavior.
Click Save
Automation of Prior Request for Translation
Auto: The SFMC Connector will detect changes to previously submitted source content every three hours. Any detected updates are batched into a Job and sit in awaiting authorization. However, if auto-authorize is enabled under Smartling Settings, the updated content is automatically authorized for translation. This feature does not detect content in new assets—only updates to content from assets previously submitted for translation. In other words, if an asset is brand new and has never been requested for translation, its content will not be picked up by this automation. See additional details here.
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 the SFMC Asset List.
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
From within your Smartling SFMC Project, click on the Settings tab > SFMC Settings
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
Choose the correct target language from the dropdown menu to map the language in your SFMC language configuration to your Smartling project target language
Click Save
If you plan to translate Multirow Data extensions, please provide the following information to your Customer Success Manager or Smartling representative:
The name of the Data extension column that stores the locale code (e.g.,
User_Language＿c).The locale code in the Data extension that should be used as source content (e.g.,
en).
For more info, see Multirow Data Extensions in Salesforce Marketing Cloud.
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.