# Дополнительные настройки отдельных инструментов



# Виджет "Бустер среднего чека"

Для корректной работы этого виджета сервису необходимо иметь доступ к актуальной сумме корзины. 

Для этого мы просим вас передавать значение суммы корзины пользователя в локальное хранилище данных браузера (LocalStorage) в виде ключ/значение. 
Это значение должно изменяться в зависимости от действий пользователя (добавления товаров в корзину, изменение их количества, удаление товаров) даже без перезагрузки страницы.

Имя ключа - `lh_cart_sum`. 

Вот простой пример JavaScript кода, который устанавливает значение ключа LocalStorage:
``` js
localStorage.setItem('lh_cart_sum', cart_sum_variable_name);
```
где `cart_sum_variable_name` - сумма корзины пользователя.

[Подробнее про LocalStorage](https://developer.mozilla.org/ru/docs/Web/API/Window/localStorage)

# Рассылка "Брошенный просмотр категории товаров"

Для работы триггерной рассылки "Брошенный просмотр категории товаров" необходимо предоставить файл со списком категорий товаров.

Список должен содержать название, URL и ID категории.

ID категорий в списке должны совпадать с ID категорий в фиде, так как исходя из сопоставления ID категорий система будет понимать, из какой категории нужно запросить товары для добавления в рассылку. Категория товара указывается в параметре \<categoryId>.

Пример списка:

| Название | URL | ID |
| ------ | ----------- | ----------- |
| Одежда | https://example.com/catalog/clothes/ | 1 |
| Обувь | https://example.com/catalog/shoes/ | 2 |

Пример фида:
```html
<categories>
  <category id="1">Одежда</category>
  <category id="2">Обувь</category>
</categories>
<offers>
  <offer id="784" available="true">
    <name>Пальто</name>
    <url>https://example.com/catalog/clothes/item-784/</url>
    <categoryId>1</categoryId> <!--категория товара-->
  </offer>
  <offer id="265" available="true">
    <name>Свитер</name>
    <url>https://example.com/catalog/clothes/item-265/</url>
    <categoryId>1</categoryId> <!--категория товара-->
  </offer>
  <offer id="591" available="true">
    <name>Ботинки</name>
    <url>https://example.com/catalog/shoes/item-591/</url>
    <categoryId>2</categoryId> <!--категория товара-->
  </offer>
  <offer id="803" available="true">
    <name>Кроссовки</name>
    <url>https://example.com/catalog/shoes/item-803/</url>
    <categoryId>2</categoryId> <!--категория товара-->
  </offer>
<offers>
```

В данном примере, если визит пользователя закончится на просмотре категорий (и просмотра карточек товара не было за визит), а последняя просмотренная будет https://example.com/catalog/shoes, то пользователь получит письмо с товарами, которые относятся к категории с идентификатором "2" - \<categoryId>2\</categoryId>.

---
Если вы используете подкатегории товаров, то важно учитывать, что дочерние категории товаров не будут учитываться, если в \<categoryId> товара указана родительская.

Пример фида:
```html
<categories>
  <category id="1">Одежда</category>
    <category id="11" parentId="1">Верхняя одежда</category>
    <category id="12" parentId="1">Брюки</category>
  <category id="2">Обувь</category>
    <category id="21" parentId="2">Ботинки</category>
    <category id="22" parentId="2">Кроссовки</category>
</categories>
<offers>
  <offer id="784" available="true">
    <name>Пальто</name>
    <url>https://example.com/catalog/clothes/outerwear/item-784/</url>
    <categoryId>11</categoryId> <!--категория товара-->
  </offer>
  <offer id="591" available="true">
    <name>Ботинки</name>
    <url>https://example.com/catalog/shoes/boots/item-591/</url>
    <categoryId>21</categoryId> <!--категория товара-->
  </offer>
<offers>
```

В данном случае список категорий должен выглядеть следующим образом:
| Название | URL | ID |
| ------ | ----------- | ----------- |
| Верхняя одежда | https://example.com/catalog/clothes/outerwear/ | 11 |
| Брюки | https://example.com/catalog/clothes/trouseres/ | 12 |
| Ботинки | https://example.com/catalog/shoes/boots/ | 21 |
| Кроссовки | https://example.com/catalog/shoes/sneakers/ | 22 |

# Виджет "Брошенная корзина"

Для работы виджета “Брошенная корзина” нужно хранить актуальные данные о состоянии корзины пользователя в [local storage](https://developer.mozilla.org/ru/docs/Web/API/Window/localStorage) в формате **JSON**, название ключа: `_lh_abandoned_cart_widget_data`.

Содержимое ключа:
- **Общая сумма корзины**, формат - число(number);
- **Список товаров**:
  - **название товара**, формат - строка(string);
  - **ссылка на изображение товара**, формат - строка(string);
  - **ссылка на товар**, формат - строка(string);
  - **количество товаров**, формат - число(number);
  - **сумма стоимости товаров**, формат - число(number).

❗ Если корзина пользователя пуста, данный ключ должен быть удален из local storage.

Пример:
```js
{
  "total_cart_sum": 5000,
  "cart_items": [
    {
      "name": "Смартфон",
      "img": ".../smartphone.png",
      "link": ".../catalog/smartphone/",
      "count": 1,
      "price": 3000
    },
    {
      "name": "Наушники",
      "img": ".../headphones.png",
      "link": ".../catalog/headphones/",
      "count": 2,
      "price": 2000
    }
  ]
}
```