Multi-language Support

Dynamic Yield supports multi-language sites by enabling you to:

• Fire events in various currencies on the same site
• Localize variations based on language/country
• Localize recommended products based on language/country

Currency support in events

If your visitors can make purchases using more than one currency, add a currency property to your events (purchase, add to cart, or any event with monetary value). Dynamic Yield converts the amount to the currency used in your Dynamic Yield reports.
See our Developer Docs for implementation information.

Supported currencies

Dynamic Yield currently supports the following currencies. If you require a currency that is not on this list, speak to your Customer Success Manager.

Note: The exchange rate uses the external service currencylayer and updates once every day at 4 am (UTC). If you require a real-time conversion, you must do the conversion on your end, and fire events using the site's default currency.

Localizing content

You can serve different content to users depending on the user's locale. This is currently available only for API campaigns, dynamic content emails, and web personalization campaigns that are not based on a variation feed. 

Add language context on every page

If your site supports multiple languages (or versions of the same language in multiple countries), have your developer add a locale (lng) parameter to the page context of every page on your site. This lng code enables us to serve the correct language.

See our Developer Docs for implementation details.

Add language context for email

To support multiple languages in Experience Email, see the Configure ESP parameters section in the main Experience Email article.

Supported languages codes

Localizing variations

Web personalization

For campaigns created using either the script-based implementation or API, you can serve a localized version of variations to your site visitors, as follows:

1. Make sure the page context is properly defined as detailed in the previous section.
2. Define your section languages.
3. Define localized values for individual variables in each variation.
   
4. For API campaigns, send the user's locale in the request under the page context (for example, "locale":"fr.*"). Make sure to reference the correct language codes.

Experience Email 

For email campaigns, you can serve a localized version of variations to your email users, at open time, as follows:

1. Define your languages
2. Configure the locale ESP parameter. Use a merge tag that inserts the locale value.
3. Define localized values for individual variables in each variation.

Manage your section languages

1. Go to General Setting › Manage Languages.
2. Click Add Languages and select the relevant languages your site supports.
   • Select a language (for example, en, es) if you want to localize content per language, regardless of the country.
   • Select a language and country combination (en_US, es_MX) if you want to localize content for languages in a specific country.
3. The order defines how the languages are displayed in variations and templates. Drag and drop languages to adjust the order. You can delete a language by clicking the X next to it.
   
   

Localize variation content

When you create a new template or variation, you can see the various language symbols in the Variable tab. Each is a tab for the languages you selected in the Manage Languages section.

The first tab contains your default values. To localize variables for a different language:

1. Click the desired language symbol.
2. Check the variable you want to localize.
3. Enter the localized variable value.

A variation that's served on a page that has this language in its page context, or in an email for which the locale code is received through the ESP merge tag, displays localized content for the selected variables, and the default content for all other variables.

If a variable is checked for a given language but left empty, we will render the empty text.

To see what the variation will look like to the user:

• On your site: Click Preview on Site. The variation is displayed based on the page context defined for that page.
• In an email: See the Preview your email section of the Experience Email article. The variation is displayed based on the ESP locale parameter.

Localizing recommended products

You can adapt your product recommendation campaigns based on the user locale as follows:

• Display localized product properties
• Filter products based on the user's locale

Display localized product properties 

See our Developer Docs for implementation information.

In your product feed, add language columns with localized values for product properties (such as price, name, or description) to personalize recommendations based on locale. For example, different product names in different languages. 

Filter products based on user locale 

This feature is available for Experience Email, web recommendation campaigns, and API recommendation campaigns.

If you have different feed values for each locale, you can create a rule to exclude or include (not pin) products and filter products in the campaign based on the user's location. For example, you can choose to include only items that are in sale their area.

For example, if the feed has the following columns:

sku	discounted	lng:FR:discounted
123	Yes	No
234	No	Yes

You can create a rule that includes only discounted products, but filters out 123 for users with FR locale, and filters out 234 for the rest of the users.

When you create the filter rule, after you choose the property (in this case, "discounted"), choose "By the user's locale":