Виджет 24WTB-Online
Общий принцип работы системы

Решение Where-to-Buy Online компании 24TTL позволяет брендам-производителям запрашивать предложения товаров из онлайн-магазинов (ритейлеров далее) и выводить их в виде ссылок-логотипов на виджет у себя на сайте. Это позволяет перенаправить покупателей с карточки товара на сайте бренда прямо в карточку товара на сайт ритейлера без ухода со страницы, обеспечивая бесшовный путь покупки.

Когда пользователь заходит на продуктовую страницу на сайте бренда и нажимает кнопку “Где купить”, виджет посылает запрос к API 24WTB, который возвращает в ответ json с предложениями по данному продукту на разных сайтах ритейлеров, в котором хранится информация о цене, валюте, наличии в интернет-магазине, ссылке на продуктовую страницу и прочих параметрах. Если предложения доступны для отображения, система даёт ответ «200», и виджет визуализирует Json файл в виде ссылок-логотипов различных ритейлеров. Если предложения отсутствуют, система даёт ответ «204» и на виджет выводится фраза об отсутствии предложений.

 

Виджет 24WTB-Online

Виджет 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

Получить список предлоджений по продукту можно через 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

Если вы планируете отслеживать кампании (например, различные медиа, рекламу, продающие лендинги и тд), с которых пользователи переходят на вашу собственную целевую страницу, где находится кнопка "Где купить", вам необходимо добавить параметр CID в URL-адреса медиа и реализовать следующий сценарий, чтобы значение CID перехватывалось и отображалось на приборной панели 24WTB. 

Что такое CID?

24WTB предлагает возможность связать вашу систему отслеживания с функцией отслеживания лидов и продаж 24WTB. Вы сможете увидеть общую информацию по пользователям, которые перешли с отдельной рекламной кампании, и сделать глубокие инсайты по поведению пользователя.

За подробной информацией и технической документацией просьба обратиться к вашему Customer Success Manager.

 

Песочница

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

Виджет 24WTB-Offline
Общий принцип работы системы

Решение Where-to-Buy Offline компании 24TTL позволяет брендам-производителям запрашивать информацию по ближайшим офлайн магазинам по выбранному товару и выводить их на карту в виде точек, на которые пользователь может нажать и получить подробную информацию по каждой из них. На виджете отображаются только те магазины, в которых продаются нужные категории по выбранному товару. Например, для холодильника будут отображаться магазины, в которых продается данная категория. Сервис 24WTB-Offline помогает пользователю быстро найти актуальную информацию о ближайших офлайн магазинах, где можно приобрести конкретный товар. 

Когда пользователь заходит на продуктовую страницу на сайте бренда, открывает карту с решением “Where to buy - Offline", виджет посылает запрос к API, который возвращает ответ json с данными по офлайн магазинам, в котором хранится информация: название магазина, время работы, адрес, координаты долготы и широты, телефон, электронная почта и другие возможные параметры. После того, как ответ был получен, он визуализируется на виджете-карте в виде доступных вариантов офлайн магазинов, куда пользователь может отправиться за покупкой товара. После нажатия на доступный магазин пользователь увидит более подробную информацию о нем.



Получение списка офлайн-магазинов по продукту через API

Получить список офлайн магазинов для определенного продукта можно через 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

https://core.24wtb.com/api/v1/1957063e-e342-4eba-b42b-e0ac9c9aed97/offline/product/by-area?mpn=PNKH33333&latitude=55.753927&longitude=37.610834&distance=10000

https://core.24wtb.com/api/v1/1957063e-e342-4eba-b42b-e0ac9c9aed97/offline/product/by-area?ean=2222222222222&latitude=55.753927&longitude=37.610834&distance=10000