Решение Where-to-Buy Online компании 24TTL позволяет брендам-производителям запрашивать предложения товаров из онлайн-магазинов (ритейлеров далее) и выводить их в виде ссылок-логотипов на виджет у себя на сайте. Это позволяет перенаправить покупателей с карточки товара на сайте бренда прямо в карточку товара на сайт ритейлера без ухода со страницы, обеспечивая бесшовный путь покупки.
Когда пользователь заходит на продуктовую страницу на сайте бренда и нажимает кнопку “Где купить”, виджет посылает запрос к API 24WTB, который возвращает в ответ json с предложениями по данному продукту на разных сайтах ритейлеров, в котором хранится информация о цене, валюте, наличии в интернет-магазине, ссылке на продуктовую страницу и прочих параметрах. Если предложения доступны для отображения, система даёт ответ «200», и виджет визуализирует Json файл в виде ссылок-логотипов различных ритейлеров. Если предложения отсутствуют, система даёт ответ «204» и на виджет выводится фраза об отсутствии предложений.
Виджет 24WTB-Online предназначен для визуализации предложений онлайн-ритейлеров для конкретного товара бренда.
Виджет подключается как скрипт на торговую площадку и предоставляет метод для поиска соответствующих предложений и их отображения.
Предложения отображаются, когда посетитель торговой площадки нажимает кнопку "Где купить" (либо любое другое название). Вызов виджета содержит параметры, определяющие бренд, productID товара и тип маппинга товаров, по которому делается запрос в систему и выдается список доступных предложений.
Функции виджета заключаются в следующем:
В методе инициализации виджета в его настройки передаются параметры, которые описывают внешний вид виджета, а также данные товара, предложения для которого должны быть отображены на странице. При инициализации виджета происходит запрос на серверную часть сервиса, в котором содержатся данные о товаре, в ответе возвращается JSON-объект с доступными предложениями товара в ритейлерах. Скрипт виджета генерирует верстку на основании этих данных и визуальных настроек виджета и отображает ее на странице сайта, где используется виджет. Виджет вставляется в элемент страницы, который тоже указывается в настройках инициализации.
Помимо получения данных через виджет, возможно получение данных при обращении к API сервиса в формате JSON. При запросе необходимо указать некоторые обязательные параметры, которые позволят получить информацию для нужного продукта. Больше информации об этих параметрах описано в разделе "Получение списка предложений по продукту через API".
Для интеграции виджета необходимо разместить 2 тега скрипта в нижней части сайта
1 - Подключение скрипта виджета.
2 - Инициализация виджета.
Код подключения скрипта виджета выглядит следующим образом:
<script src="https://widget.24wtb.com/wtbWidget.js"></script>
Пример кода инициализации виджета:
<script>
var wtbWidget = new WtbWidget();
wtbWidget.init({
el: ".product-gallery__light-button-right",
licenseId: '4c579eab-adb2-4187-bb4b-cc69f01a08bd',
productId: ‘3838782532436',
skuType: 'ean',
buttonClass: 'btn',
buttonText: 'ГДЕ КУПИТЬ',
widgetLinkColor: '#00b8ac',
widgetListColor: '#00b8ac',
footerBg: '#00b8ac',
footerColor: '#fff',
});
</script>
Виджет готов к работе!
Параметр | Обязательный | Тип данных | Значение по умолчанию | Описание |
licenseId |
Да | Строка | null |
Айди бренда в сервисе 24WTB |
el |
Нет | Строка | .wtb-container |
Селектор элемента, в который произойдет вставка виджета |
skuType |
Нет | Строка | mpn |
Тип идентификатора товара (доступны mpn, ean, brandSku) |
productId |
Да | Строка | null |
Идентификатор товара |
buttonText |
Нет | Строка | Где купить |
Текст на кнопке вызова виджета |
buttonClass |
Нет | Строка | null |
Css-классы кнопки вызова виджета |
buttonStyle |
Нет | Объект | {} |
Сss кнопки вызова виджета |
widgetClass |
Нет | Строка | null |
Css-классы виджета |
widgetLinkColor |
Нет | Строка | #ccc |
Цвет иконок перехода на ритейлеры внутри виджета |
widgetListColor |
Нет | Строка | #000 |
Цвет текста в списке доступных офферов |
footerColor |
Нет | Строка | #736c64 |
Цвет текста в футере виджета |
footerBg |
Нет | Строка | #ddd |
Цвет фона в футере виджета |
noShopsText |
Нет | Строка | У данного товара нет предложений |
Текст в виджете в случае отсутствия офферов |
available |
Нет | Строка | В наличии |
Подпись товара, когда он есть в наличии |
not available |
Нет | Строка | Нет в наличии |
Подпись товара, когда его нет в наличии |
showPrice |
Нет | Булевое значение | false |
Показывать ли цену товара в виджете |
showAvailability |
Нет | Булевое значение | false |
Показывать ли статус наличия товара в виджете |
showAwailableOnly |
Нет | Булевое значение | true |
Показывать ли только товары в наличии в виджете |
Получить список предлоджений по продукту можно через API 24WTB.
Приведенный ниже пример URL содержит несколько переменных, которые необходимы для получения предложений по товару. На основе этих переменных 24WTB выведет список предложений онлайн-магазинов для товара на виджет на сайте бренда.
https://core.24wtb.com/api/v1/{license_id}/online/product?{product_sku_type}={product_sku_value}
где:
{license_id} = уникальный ID, предоставляемый при регистрации в 24WTB Online
{product_sku_type} (допустимые значения - mpn, ean или custom_id) = Тип данных, по которым маппится продукт
{product_sku_value} = Номер модели или код EAN (13 значный цифровой код/ штрихкод) или custom_id, уникальный код продукта на сайте бренда)
Name |
Data type |
Description |
license_id |
Целое число |
Уникальный идентификатор бренда в системе 24WTB |
MPN |
Строка |
Номер модели |
EAN |
Целое число |
Международный артикул товара |
custom_id |
Целое число |
Уникальный идентификатор на площадке бренда |
Примеры: JSON с MPN и EAN
https://core.24wtb.com/api/v1/1957063e-e342-4eba-b42b-e0ac9c9aed97/online/product?mpn=BM235CLI
https://core.24wtb.com/api/v1/1957063e-e342-4eba-b42b-e0ac9c9aed97/online/product?ean=3838942142796
Если вы планируете отслеживать кампании (например, различные медиа, рекламу, продающие лендинги и тд), с которых пользователи переходят на вашу собственную целевую страницу, где находится кнопка "Где купить", вам необходимо добавить параметр CID в URL-адреса медиа и реализовать следующий сценарий, чтобы значение CID перехватывалось и отображалось на приборной панели 24WTB.
Что такое CID?
24WTB предлагает возможность связать вашу систему отслеживания с функцией отслеживания лидов и продаж 24WTB. Вы сможете увидеть общую информацию по пользователям, которые перешли с отдельной рекламной кампании, и сделать глубокие инсайты по поведению пользователя.
За подробной информацией и технической документацией просьба обратиться к вашему Customer Success Manager.
Для практических примеров использования мы создали Песочницу, где вы можете поэкспериментировать с параметрами.
Решение Where-to-Buy Offline компании 24TTL позволяет брендам-производителям запрашивать информацию по ближайшим офлайн магазинам по выбранному товару и выводить их на карту в виде точек, на которые пользователь может нажать и получить подробную информацию по каждой из них. На виджете отображаются только те магазины, в которых продаются нужные категории по выбранному товару. Например, для холодильника будут отображаться магазины, в которых продается данная категория. Сервис 24WTB-Offline помогает пользователю быстро найти актуальную информацию о ближайших офлайн магазинах, где можно приобрести конкретный товар.
Когда пользователь заходит на продуктовую страницу на сайте бренда, открывает карту с решением “Where to buy - Offline", виджет посылает запрос к API, который возвращает ответ json с данными по офлайн магазинам, в котором хранится информация: название магазина, время работы, адрес, координаты долготы и широты, телефон, электронная почта и другие возможные параметры. После того, как ответ был получен, он визуализируется на виджете-карте в виде доступных вариантов офлайн магазинов, куда пользователь может отправиться за покупкой товара. После нажатия на доступный магазин пользователь увидит более подробную информацию о нем.
Получить список офлайн магазинов для определенного продукта можно через API 24WTB.
Приведенный ниже пример URL содержит несколько переменных, которые необходимы для получения информации по офлайн магазинам. На основе этих переменных 24WTB выведет список офлайн магазинов, которые находятся в указанном в запросе радиусе вокруг выбранной геолокации покупателя.
https://core.24wtb.com/api/v1/{license_id}/offline/product/by-area?{product_sku_type}={product_sku_value}&latitude={latitude}&longitude={longitude}&distance={distance}
где:
{license_id} = уникальный ID, предоставляемый при регистрации в 24WTB
{product_sku_type} (допустимые значения - mpn, ean или custom_id) = Тип данных, по которым маппится продукт
{product_sku_value} (допустимые значения - mpn, ean или custom_id) = Номер модели или код EAN (13 значный цифровой код/ штрихкод) или custom_id, уникальный код продукта на сайте бренда)
{latitude} = Широта центра круга, в которой происходит поиск магазинов
{longitude} = Долгота центра круга, в которой происходит поиск магазинов
{distance} = Радиус круга в метрах. Максимальная дистанция 100 000 м (100 км)
Name |
Data type |
Description |
license_Id |
Строка |
Уникальный идентификатор бренда-клиента в системе 24WTB |
MPN |
Строка |
Номер модели продукта |
EAN |
Целое число |
Международный артикул товара |
custom_id |
Строка |
Уникальный идентификатор на площадке бренда |
latitude |
Десятичная дробь |
Широта центра круга, в котором происходит поиск магазинов |
longitude |
Десятичная дробь |
Долгота центра круга, в котором происходит поиск магазинов |
distance |
Целое число |
Радиус круга в метрах. Максимальная дистанция 100 000 м (100км) |
Examples: JSON with MPN and EAN