Translating with Oracle Eloqua

This article is for Account Owners and Project Managers.

The Smartling Eloqua connector allows you to translate Eloqua content with context. Translations are requested from within Eloqua, and translated content is automatically sent back to your Eloqua instance.

The connector supports translation of emails, landing pages, and dynamic content.

Request Translations (New Experience)

Once you've linked your Eloqua account, you can begin submitting content for translation.

1. From your Smartling Eloqua project, click the Eloqua tab. 
2. On the left, choose an Asset Type from the menu. 
3. Select the assets you want to translate and click Actions > Request Translation. 
4. Select the languages you'd like to translate to.
5. Click Authorize. 

Content will be authorized into the Default Workflow for each selected language.

If you are translating an email, the connector will automatically pick up any related dynamic content items.

Request Translations (Classic)

Once you've linked your Eloqua account, you can begin submitting content for translation to Smartling.

1. From within your Smartling Eloqua Project, click Eloqua > Translate Content.
2. Toggle between email, landing page, and single file dynamic content using the buttons in the upper right-hand corner of the screen to locate the content you want to translate.
3. Once in your desired Eloqua content area, select the items you want to translate. Select individual items using the checkbox next to the item name. Select all items from the content area by using the checkbox next to Request Translations.
4. Click Request Translation.
5. Choose the languages to which you'd like to translate, or use the Select All checkbox to translate to all languages available in your project.
6. Click Request Translation.

The content will be authorized into the Default Workflow for each selected language.

If you are translating an email, the connector will automatically pick up any related dynamic content items.

Include Visual Context with your Translation Request

Visual context helps linguists get your translations right the first time - reducing translation cost and time to market. Visual context is automatically captured by the Eloqua connector for landing pages and emails.

Check Translation Status (New Experience)

To check the status of your translations, from your Eloqua project, click the cog wheel and select Eloqua Progress. Translation progress is indicated with a progress bar next to each asset. 

Check Translation Status (Classic)

Status of your Eloqua translation requests can be tracked in the Translation Progress tab.

1. From within your Smartling Eloqua project, click on Eloqua > Translation Progress.
2. Translation completion is indicated as a percent next to each article.

Download Translations to Eloqua (New Experience)

As translation are completed, they are automatically sent to your Eloqua instance every three hours.

To perform a manual download of translated content to Eloqua:

1. From your Eloqua project, click the Eloqua tab.
2. Select the translated assets to download.
3. Click Actions and select Export Translation.

Download Translations to Eloqua (Classic)

Once translation are completed for a given asset, the translations are automatically sent to your Eloqua instance every 3-hours.

To initiate a manual download of translated content to Eloqua:

1. From within your Smartling Eloqua Project, click on Eloqua > Translation Progress.
2. Select individual items using the checkbox next to the item name. Select all items from the list by using the checkbox next to the Title field.
3. Click Export to Eloqua.

Handling Updates to Eloqua Content

Your Smartling Administrator can configure your connector to automatically submit new content when changes are made to your source Eloqua content. The connector will check your Eloqua instance for updated source content every three hours.

If your connector is set to Manual or Disabled mode, you'll need to resubmit Eloqua content manually using the steps described above when changes are made to your source content.

Translate Dynamic Content (New Experience)

Dynamic content is a filetype within Eloqua that makes it possible to show variable content to different email recipients. Eloqua users can create multiple rules within dynamic content to control who sees what based on a recipient attribute, such as their city. Dynamic content can be used as an alternative for managing translated emails. Rather than duplicating an email for each additional language, you can use dynamic content to manage any translations needed in a single email. For example, this is useful if you want to make HTML changes to an email, but don't want to have it update in multiple locations.

To translate dynamic content:

1. In your Eloqua project, click the Eloqua tab. 
2. From Asset Type, select Single File Dynamic Content. 
3. Find the files you'd like to translate and request translation as usual. Your dynamic content should only contain a single default rule. Smartling will extract the content from this default rule and create a new rule for each language once it's been translated. When creating the rule, you'll need to define the contact field that Smartling should use. 

For example, you may have a Language contact field that defines what language a recipient’s email should be in. You can select this by going to:

1. Click the gear icon and select Project Settings > Eloqua Settings. Under Contact Field for Dynamic Content Rules, select which attribute to use. Let’s say your default rule is, Mutant turtles typically prefer pizza, and you’ve selected Language as the contact field to use.
2. After requesting translation for this dynamic content in Brazilian Portuguese and fully translating the content, if you open this dynamic content file in Eloqua, you should see a new rule called “pt-BR". The content should be Tartarugas mutantes costumam preferir pizza, and the Compare Contact Fields setting should be set to Language with the value “pt-BR”.

Translate Dynamic Content (Classic)

Dynamic content is a filetype within Eloqua that makes it possible to show variable content to different email recipients. Eloqua users can create multiple rules within dynamic content to control who sees what based on a recipient attribute, such as their city. Dynamic content can be used as an alternative for managing translated emails. Rather than duplicating an email for each additional language, you can use dynamic content to manage any translations needed in a single email. For example, this is useful if you want to make HTML changes to an email, but don't want to have it update in multiple locations.

To translate dynamic content:

1. Go to Eloqua > Translate Content.
2. Select the Single File Dynamic Content tab.
3. Find the files you'd like to translate and request translation as usual. Your dynamic content should only contain a single default rule. Smartling will extract the content from this default rule and create a new rule for each language once it's been translated. When creating the rule, you'll need to define the contact field that Smartling should use. 

For example, you may have a Language contact field that defines what language a recipient’s email should be in. You can select this by going to:

1. Project Settings > Eloqua Settings > Contact Field for Dynamic Content Rules, select which attribute to use. Let’s say your default rule is, Mutant turtles typically prefer pizza, and you’ve selected Language as the contact field to use.
2. After requesting translation for this dynamic content in Brazilian Portuguese and fully translating the content, if you open this dynamic content file in Eloqua, you should see a new rule called “pt-BR". The content should be Tartarugas mutantes costumam preferir pizza, and the Compare Contact Fields setting should be set to Language with the value “pt-BR”.

Rewrite Rules

Use the connector's Rewrite Rules feature to localize content such as URLs and phone numbers in Eloqua content.

Create Rewrite Rules (New Experience)

1. From within your Eloqua project in Smartling, click the gear icon and select Project Settings > Eloqua Settings.
2. On the left, click Eloqua Rewrite Rules. 
3. Click Create Rule.
4. In the Pattern field, type the exact text you would like to replace in your source Eloqua content in the text box that appears at the top of your screen.
5. In the Order field to the right, type the desired order for the rule to fire.
6. In the Rewrite section, type the exact text you would like to replace the source text with for each language.
7. Click Save to save your rule or Cancel to exit the menu.

The rewrite rule will be applied across all assets you translate from Eloqua, in the order you have configured your rules to be executed.

Create Rewrite Rules (Classic)

1. From within your Eloqua project in Smartling, click on Eloqua > Rewrite Rules.
2. Click Create.
3. In the Enter Rewrite Rule field, type the exact text you would like to replace in your source Eloqua content in the text box that appears at the top of your screen.
4. In the Enter field to the right, type the desired order for the rule to fire.
5. In the Replacements section, type the exact text you would like to replace the source text with for each language.
6. Click Save to save your rule or Cancel to exit the menu.

The rewrite rule will be applied across all assets you translate from Eloqua, in the order you have configured your rules to be executed.

Edit or Delete Rewrite Rules (New Experience)

1. From your Eloqua project, click the gear icon and select Project Settings > Eloqua Settings.
2. On the left, click Eloqua Rewrite Rules. 
3. On the left, next to the rule you would like to edit or remove, click the three dots and select Edit or Remove. 

Edit or Delete Rewrite Rules (Classic)

1. From within your Eloqua project in Smartling, click Eloqua > Rewrite Rules.
2. Click on the rewrite rule you would like to edit or delete.
3. Click the Edit button to update the existing rule, or click the Trash icon to delete the rule.