# Мультиязычность и мультирегиональность

В случае, если сайт или приложение работают в разных локациях, где те или иные параметры товаров различаются, возможность настройки мультиязычности / мультирегиональности позволяет выводить товары в рекомендательных виджетах с корректным языком, корректной валютой и правильной ценой. Ниже можно найти несколько примеров, в каких случаях наши клиенты используют данный функционал:

Сайт компании А работает в 3-х разных странах и рекомендательные виджеты должны выводить товары на местном языке и с ценой в местной валюте в зависимости от страны. Для рекомендаций используется один фид на всех версиях сайта. Функционал мультиязычности / мультирегиональности используется для вывода названий товаров на разных языках и цен в разных валютах.
Компания Б работает с клиентами со всей России и для поддержания высокого уровня обслуживания клиентов в любой точке страны имеет 8 распределительных центов. В силу особенностей бизнес-процессов цены и наличие для клиентов, обслуживаемых каждым из распределительных центров отличаются. Функционал мультиязычности /мультирегиональности используется для вывода соответствующих цен и наличия для каждого из пользователей в зависимости от их расположения.

Все значения должны экранироваться двойными кавычками.

Чтобы данный функционал платформы персонализации корректно работал, необходимо добавить параметр lng в контекстах сайта и в товарном фиде.

ℹ️ Регистр значений параметра lng в контекстах страниц и в фиде должен совпадать. Рекомендуется использовать нижний регистр в обоих случаях.

Параметр lng в контекстах сайта:

SL.pageContext = {"type":"OTHER","lng":"en_en"};

или

SL.pageContext = {"type":"OTHER","lng":"spb"};

В фиде необходимо введение дополнительных колонок для отличающихся от базовых параметров в формате lng:<кодировка языка/региона>:<параметр>:<значение>.

Важно: добавление колонки lng необходимо для каждого изменяемого параметра: название, URL страницы, цена и другие. Любая колонка в фиде, кроме sku и group_id может иметь языковые / региональные варианты. Базовые колонки (без дополнительных параметров) должны оставаться в фиде и будут использоваться, если значение в дополнительной колонке не найдено.

Например - название товара на другом языке:

"name": "Белые ботинки" // название товара на языке по умолчанию
"lng:en_en:name": "White shoes" // название товара на английском 

или цена товара в другом регионе:

"price": "150.00" // цена товара по умолчанию
"lng:spb:price": "155.00" // цена товара в Санкт-Петербурге

Где используется:

Подготовка Продуктового Фида: общие требования

# 🗺 Пример: Разные цены по регионам при общей структуре

В этом примере фида значения всех полей (название, категории, URL и т.д.) — едины для всех регионов, но цена товара зависит от региона. Это достигается с помощью колонок вида lng:<регион>:price. Платформа автоматически подставляет цену по региону, основываясь на значении context.lng.

sku,group_id,name,price,currency,url,image_url,in_stock,categories,
lng:msk:price,lng:spb:price,lng:ekb:price

DRESS001,DRESSES,Платье вечернее,7990.00,RUB,https://shop.ru/product/dress001,https://cdn.example.com/images/dress001.jpg,true,Одежда|Платья,8290.00,7590.00,7890.00
SHOES001,SHOES,Кроссовки спортивные,5990.00,RUB,https://shop.ru/product/shoes001,https://cdn.example.com/images/shoes001.jpg,true,Обувь|Кроссовки,6190.00,5890.00,5790.00
JACKET001,JACKETS,Куртка демисезонная,9990.00,RUB,https://shop.ru/product/jacket001,https://cdn.example.com/images/jacket001.jpg,true,Одежда|Куртки,10490.00,9690.00,9490.00
TSHIRT001,TOPS,Футболка с принтом,1990.00,RUB,https://shop.ru/product/tshirt001,https://cdn.example.com/images/tshirt001.jpg,true,Одежда|Футболки,2090.00,1890.00,1990.00
BAG001,BAGS,Сумка кожаная,7490.00,RUB,https://shop.ru/product/bag001,https://cdn.example.com/images/bag001.jpg,true,Аксессуары|Сумки,7790.00,7190.00,7290.00
DRESS002,DRESSES,Сарафан летний,5290.00,RUB,https://shop.ru/product/dress002,https://cdn.example.com/images/dress002.jpg,true,Одежда|Платья,5590.00,5090.00,5190.00
SHOES002,SHOES,Туфли на каблуке,6590.00,RUB,https://shop.ru/product/shoes002,https://cdn.example.com/images/shoes002.jpg,true,Обувь|Туфли,6990.00,6390.00,6490.00
COAT001,OUTER,Пальто зимнее,13990.00,RUB,https://shop.ru/product/coat001,https://cdn.example.com/images/coat001.jpg,true,Одежда|Пальто,14500.00,13400.00,13200.00
HAT001,ACCESSORIES,Шапка вязаная,990.00,RUB,https://shop.ru/product/hat001,https://cdn.example.com/images/hat001.jpg,true,Аксессуары|Головные уборы,1090.00,890.00,950.00
BELT001,ACCESSORIES,Ремень кожаный,1790.00,RUB,https://shop.ru/product/belt001,https://cdn.example.com/images/belt001.jpg,true,Аксессуары|Ремни,1890.00,1690.00,1590.00
JEANS001,BOTTOMS,Джинсы прямого кроя,4990.00,RUB,https://shop.ru/product/jeans001,https://cdn.example.com/images/jeans001.jpg,true,Одежда|Джинсы,5290.00,4790.00,4890.00
HOODIE001,TOPS,Худи oversize,4490.00,RUB,https://shop.ru/product/hoodie001,https://cdn.example.com/images/hoodie001.jpg,true,Одежда|Толстовки,4690.00,4390.00,4290.00
BACKPACK001,BAGS,Рюкзак городской,3890.00,RUB,https://shop.ru/product/backpack001,https://cdn.example.com/images/backpack001.jpg,true,Аксессуары|Рюкзаки,4090.00,3790.00,3690.00