Multi-Lingual Support

Dynamic Yield supports multilingual sites by allowing 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 purchase using more than one currency - you should add a currency property to your events (purchase, add to cart, or any event with monetary value). Dynamic Yield will convert the amount to the currency that is used in the your Dynamic Yield reports.

DY.API("event", {
  name: "Purchase",
  properties: {
    uniqueTransactionId: "123456",
    dyType: "purchase-v1",
    value: 90.55,
    currency: "EUR",
    cart: [
        productId: "item-34454",
        quantity: 1,
        itemPrice: 65.87,
        size: "XL" // Size is *optional and a customer-specific string*
      }
    ]
  }
});

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 OAnda, and updates once per day at 4 am (GMT). If you require a real-time conversion, you will need to 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 language of each page. This is currently only available for site personalization campaigns that are not based on a variation feed.

Defining Each Page Language on Your Site

If your site supports multiple languages (or versions of the same language in multiple countries), add a locale parameter to the page context of every page on your site. For example:

DY.recommendationContext = {type: 'HOMEPAGE', lng: 'en_GB'};

Localizing Site Personalization Variations

To serve a localized version of variations to your site visitors you need to:

1. Make sure the page context is properly defined as detailed above
2. Define your site languages
3. Define localized values for individual variables in each variation
   

Manage your Site Languages

1. Go to General Setting › Manage Languages.
2. Click Add Languages and select the relevant languages your site supports.
3. The order defines how they will be displayed in variation and templates. Drag and drop languages to adjust the order. You can delete languages by clicking the X next to each language.
   
   

Localize Variation Content

When creating a new template or variation, you will see different language tabs under the Variable tab. These are the languages you chose in the Manage Languages section.

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

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

A variation that is served on a page that has this language in its Page Context will show the localized content for variables that are “checked”, 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 view how the variation will look on your site, click Preview on Site. The variation will be displayed based on the page context defined for that page.

Localizing Recommended Products

Localized versions of Recommendations are served based on the page context, and the values in your product feed.

To add localized values of any product property (e.g. price, name, description), add a column to your Product Feed with the following format

“lng:<language code>:<column name>”: “<value>”.

For example, if your default language is English and you would like to add a French version of the product name, add a column called "lng:fr_FR:name", and set the French value for it as seen below.

"name":"White Pants"
"lng:fr_FR:name":"Pantalon Blanc"

For translations of attributes that have multiple values (e.g. parent and child categories), the order of the values should match the language order. For LTR languages, the values should be LTR, and for RTL languages the values should be RTL.