Интеграция сервиса [бета версия] Добавление кода на сайт Установка счетчика Счетчик необходимо добавить на каждую страницу сайта. При установке счетчика в HTML-код сайта, разместите код как можно ближе к началу страницы, в пределах тегов
или . Пример кода счетчика: Установка кода заказа Код заказа необходимо разместить на финальную страницу заказа, где пользователя информируют об успешном оформлении заказа. В код нужно передать данные о номере заказа, сумме и товарах. Пример кода заказа: Номер заказа Номер заказа укажите в переменной order_id, тип данных - string (строка)var order_id = 'ORDER_ID_HERE' Сумма заказа Сумму заказа укажите в переменной cart_sum, тип данных - string (строка)var cart_sum = 'CART_SUM_HERE' Формат суммы должен быть 200.00 - разделитель точка и 2 знака после точки. В случае несоблюдения этого правила, суммы заказа будут сохраняться некорректно, что приведет к ошибкам в данных. Товары Товары укажите в переменной order_offersvar order_offers = [] Товары представляют из себя массив объектов. Каждый объект товара содержит следующие атрибуты: url: URL товара. URL должен быть полным, с указанием префикса протокола (http://, https://) и доменом, а так же должен совпадать с URL этого же товара в YML файле (фиде). Типа данных - строка (string) name: Название товара. Тип данных - строка (string) price: Стоимость товара. Тип данных - число (number) count: Количество купленных экземпляров товара. Тип данных - число (number) currency: Код валюты в формате ISO 4217 (https://ru.wikipedia.org/wiki/ISO_4217). Тип данных - строка (string) Все атрибуты обязательны к заполнению. Пример массива с товарами: var order_offers = [ { 'url': 'https://medieval-shop.io/offers/broken_sword', 'name': 'Сломанный меч', 'price': 500, 'count': 1, 'currency': 'RUB' }, { 'url': 'https://medieval-shop.io/offers/excellent_helmet', 'name': 'Превосходный шлем', 'price': 2000, 'count': 3, 'currency': 'USD' } ] Импорт товаров интернет-магазина Подготовка фида (файла с товарами интернет-магазина) Для товаров магазина мы используем файл формата xml по стандарту Яндекс.Маркета (YML), при создании файла следуйте документации Яндекса. Не все элементы фида из стандарта YML используются в нашей системе, а так же присутствуют и те, которых нет в стандарте. Список используемых системой и доступных к использованию в шаблонизаторе писем элементов: Элемент Описание offer_id идентификатор товара picture ссылка на изображение товара name название товара price текущая цена товара oldprice старая цена товара economy экономия (разница между текущей и старой ценой) economy_percent экономия в процентах url ссылка на товар description описание товара type_prefix тип / категория товара vendor производитель model модель category_id идентификатор категории товара curr валюта available доступность товара / наличие Корректность формата файла можно проверить через валидатор XML-фидов, во вкладке “Маркет”.API Использование API Документация Документацию можно найти на сайте https://cp-documentation.leadhit.io Логин и пароль для авторизации в документации можно получить у аккаунт-менеджера. Авторизация и аутентификация Чтобы использовать API личного кабинета вам необходимо получить токен авторизации. Страница в документации: Получение токена авторизации. Токен долгоживущий, можно получить его один раз и использовать до тех пор, пока не получите в ответе код 401 Unauthorized, после этого нужно получить новый токен. Использование токена для аутентификации производится путем его передачи в заголовке. Страница в документации: Авторизация/аутентификация. Помимо токена вам также необходимо передавать в заголовке ваш site id. Его вы можете получить у аккаунт-менеджера или через API в методе получения информации о пользователе. Страница в документации: Получить информацию о пользователе. Предостережение Пожалуйста, не используйте ваш токен на фронтенде в открытом виде. Делайте все запросы через бэкэнд, чтобы никто не мог завладеть вашим токеном или логином и паролем от ЛК Leadhit и использовать его в своих целях.