MakeMeLook
Документация · для разработчика

Подключение виджета виртуальной примерки: код, JS API и фид каталога

Всё, что нужно разработчику, чтобы поставить примерку и подбор размера на сайт: код загрузчика, кнопка на карточке товара, каталог и проверка установки. Если сайт на Tilda, InSales, 1С-Битрикс, CS-Cart или OpenCart — начните со страницы своей платформы.

01

Код загрузчика

Вставьте перед закрывающим тегом body на всех страницах сайта:

HTML
<script src="https://widget.b2b.makemelook.ai/loader.js" data-project="ваш-id" defer></script>

id проекта — в кабинете, раздел «Установка». Загрузчик ждёт, пока страница отрисуется, и только потом подгружает виджет. На Tilda и CS-Cart он сам ставит кнопку «Примерить» в карточки товаров.

02

Кнопка на карточке товара

По умолчанию виджет показывает плавающую кнопку. Её положение (снизу или по центру, справа или слева), отступы, текст, цвета, размер, тень и анимация настраиваются в кабинете.

Чтобы примерка открывалась сразу на нужной вещи, поставьте свою кнопку и вызовите:

JS
makeMeLook.open({ productId: 'ID товара' })

productId — тот же идентификатор, что в каталоге (external_id в фиде или ID товара в выгрузке). Вызов можно делать до загрузки виджета — он дождётся загрузки и выполнится.

03

Каталог

CSV

Шаблон скачивается в кабинете. При загрузке можно выбрать разделитель и сопоставить колонки своей выгрузки. Фото скачиваются по ссылкам сами.

nameskucategorygenderpricediscount_pricecurrencyproduct_urlseasoncolormaterialbrandsizesdescriptionimage_url_1…image_url_5
categoryouterwear, tops, bottoms, shoes, accessories
genderfemale, male, unisex
currencyRUB, USD, EUR

JSON-фид

Отдайте каталог по HTTPS с авторизацией по Bearer-токену и подключите его в кабинете: «Настройки» → «Интеграции» → «Добавить интеграцию» → «Свой сайт (URL feed)». Каталог обновляется с выбранной частотой: от раза в 15 минут до раза в сутки.

JSON
{
  "products": [
    {
      "external_id": "54",
      "name": "Жакет из шерсти",
      "price": 12900,
      "currency": "RUB",
      "available": true,
      "category": "outerwear",
      "gender": "female",
      "brand": "Бренд",
      "color": "серый",
      "product_url": "https://shop.example/jacket-54",
      "images": [
        "https://shop.example/img/54-1.jpg"
      ],
      "sizes": [
        {
          "label": "S",
          "available": true
        },
        {
          "label": "M",
          "available": true
        }
      ]
    }
  ]
}

external_id можно передавать строкой или числом.

CS-CARTПодключение по API — на странице CS-Cart →
РАЗМЕРНЫЕ СЕТКИПрисылаете в любом виде, заводим мы.
04

Домены и CSP

Виджет работает только на доменах, добавленных в кабинете: «Настройки» → «Домены». localhost разрешён по умолчанию — можно проверить на локальной странице.

Если на сайте настроена политика CSP, добавьте https://widget.b2b.makemelook.ai в script-src, connect-src и img-src.

05

Проверка установки

Откройте товар в режиме инкогнито: кнопка на месте, примерка открывается. В кабинете запустите «Установка» → «Диагностика» — она проверит код на ваших доменах. Как примерка выглядит у покупателя — в демо-магазине.

06 · ФОТО ПОКУПАТЕЛЯ — ПОД ЕГО КОНТРОЛЕМ

Мы обрабатываем фото по вашему поручению

Согласие — отдельным экраномПокупатель соглашается на обработку фото до первой примерки, согласие записывается.
Удаление в один тапПокупатель удаляет своё фото сам, вы — все данные проекта.
Только для примеркиФото не используется в рекламе и не продаётся.
Всё написано в политикеКакие подрядчики участвуют в обработке и на каком основании — в политике обработки данных.
Одно действие

Пришлите ссылку на сайт — соберём примерку на ваших вещах до установки

Отвечаем в течение рабочего дня. Ничего не устанавливаем и не списываем, пока вы не увидите результат. Отправляя форму, вы соглашаетесь с политикой обработки персональных данных.
Другие платформы: TildaInSales1С-БитриксCS-CartOpenCart