Back to top image

Setting up your Salesforce Marketing Cloud Connector

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.

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

Create an API integration in SFMC

Follow Salesforce's instructions for creating an Install Package.

We've summarized the instructions below:

  1. In Marketing Cloud, go to Setup > Apps > Installed Packages
  2. Click New
  3. Give the package a name and description (this is not visible in Smartling)
  4. Under Components, click Add Component, and select an "API Integration" componentadd-component.png
  5. Click the Next
  6. Select "Server-to-Server" as the Integration Type
    integration-type.png
  7. Click Next
  8. Select the following options on the "Set Server-to-Server Properties:
    1. Email: Read, Write
    2. Documents and Images: Read, Write
    3. Saved Content: Read, Write
    4. Data Extensions: Read, Write
    5. Accounts: Readproperties.png

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:

  1. Navigate to the "Access" tab
  2. 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
  3. Click Save
    package-access.png

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

  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)
      image.png
    • 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 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 

  1. From within your Smartling SFMC Project, click on the Settings tab > 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 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.

Table of Contents