You can display different languages in your recommendation widgets by adding localized values to your product feed (e.g. name of each product in each language) and specifying the page language in the page context.
Additionally, you can fire events with different currencies for each site language (e.g. $ in your purchase events in your American site, and € in your German site).
Adding Translations to Product Feeds
To add localized values of any product property (e.g. price, name, description), add a column 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 RTL languages, the order of any values (e.g. parent and child categories) should be right-to-left.
Site Language in Page Context
To notify Dynamic Yield what language to display, add a lng parameter in the page context of every page that is not in your default language. The lng value must match the locale column translations used in the Data Feed, as detailed above.
Example page context with language setting:
DY.recommendationContext = {type: 'HOMEPAGE', lng: 'en_GB'};Currency Support in Events
Some websites which cater to different countries support multiple currencies (e.g. $ for the US site, and € for the German site). When firing events with a monetary value (e.g. price in purchase or add to cart events), you can specify a different price and currency depending on the location. For example:
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
Some currencies are supported for conversion. See list of supported currencies:
| USD($) | BYR(BYR) | IDR(Rp) | PHP(₱) | UYU($U) |
| EUR(€) | CAD($) | INR(₹) | PKR(Rp) | VND(₫) |
| GBP(£) | CHF(CHF) | ISK(kr) | RON(lei) | ZAR(R) |
| JPY(¥) | CLP($) | JOD(JD) | RSD(РСД) | COP($) |
| ILS(₪) | CNY(¥) | KRW(₩) | RUB(руб) | PLN(zł) |
| ARS($) | CZK(Kč) | KWD(ك) | SAR(SR) | BHD(.د.ب) |
| AED(AED) | DKK(kr) | KZT(KZT) | SEK(kr) | OMR(ر.ع.) |
| AUD($) | EGP(E£) | LKR(Rs) | SGD($) |
QAR(QR) |
| BAM(KM) | GEL(ლ) | MYR(RM) | THB(฿) | AOA (Kz) |
| BGN(лв) | HKD(HK$) | NOK(kr) | TRKas TRY | MXN ($) |
| BND($) | HRK(kn) | NZD($) | TWD(NT$) | MZN (MT) |
| BRL(R$) | HUF(Ft) | PEN(S/.) | UAH(₴) |
Note: The exchange rate uses the external service OAnda. The rates are updated once per day at 4am (GMT) and are used for conversions until the following update. 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.Contact your Customer Success Manager if you require a currency that is not on this list.