White Label: инструкция по настройке

Виджет White Label содержит параметры, которые позволяют настроить его для конкретных задач.

В этой инструкции рассмотрим, как можно настраивать и размещать виджет WL.

Код виджета вы можете получить в личном кабинете, на вкладке «Виджеты и баннеры», в категории White Label.

Здесь вам необходимо выбрать подходящий виджет и нажать кнопку «Получить код баннера»:

Ниже откроется окно с кодом виджета:

Скопируйте этот код для вставки на свою страницу.

Если стандартный виджет не помещается по ширине на вашей странице, мы рекомендуем прямо в элементе указать нужные вам тип и ширину, например:

<div data-kiwitaxi-white-label style="width: 830px;">.

Иначе виджет может отображаться некорректно.

Примечание: В системе управления контентом Wordpress следует вставлять код одной строкой (без переносов), в случае если абзацы текста автоматически заключаются в парные тэги. В этом вам поможет сервис http://www.willpeavy.com/minifier/. С его помощью код примет такой вид:

Виджет в исходном виде готов к использованию. Но мы рассмотрим, как можно его изменять для более эффективного использования на разных страницах.

Код виджета содержит следующие настраиваемые параметры (можно настроить один или сразу несколько параметров):

language — язык, на котором будут отображаться все этапы бронирования (т.е. локаль). В настоящее время доступны языки: русский (ru), английский (en), немецкий (de), французский (fr), испанский (es), португальский (pt), польский (pl), итальянский (it), нидерландский (nl), венгерский (hu) и украинский (ua).

Указывайте в следующем формате:

Пример испанской версии:

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

transfers_limit — количество результатов поиска в списке трансферов. Если выбрана только одна точка: Куда либо Откуда, то результатом поиска станут маршруты из этой точки или в эту точку и количество таких результатов на странице будет равно указанному в данном параметре значению. По умолчанию оно равно 10.

Например, для transfers_limit, равному 3, результат будет таким:

Остальные варианты можно посмотреть, нажав «Все трансферы».

Задавайте параметр в формате:

transfer_options — фильтр классов трансфера. Можно ограничить выдачу результатов поиска только определенными классами из списка (одним или несколькими):

• MCR — Micro
  
• ECN — Economy
  
• CMT — Comfort
  
• BSN — Business
  
• PRM — Premium
  
• MV4 — Minivan 4pax
  
• MB7 — Minibus 7pax
  
• PM6 — Premium Minibus 6pax
  
• MB10 — Minibus 10pax
  
• MB13 — Minibus 13pax
  
• MB16 — Minibus 16pax
  
• MB19 — Minibus 19pax
  
  

По умолчанию параметр пустой, и отображаются все классы авто. Указывайте значение параметра в формате:

transfer_options_limit — задает количество классов авто (см. предыдущий пункт), которые будут показаны в результатах поиска, начиная с «младшего», т. е. с Micro, и далее по списку. По умолчанию 12. Например:

Остальные варианты можно посмотреть, нажав «Все трансферы».

display_currency — валюта, в которой будет отображаться стоимость трансфера. Укажите здесь одну из трех доступных валют: USD, EUR, RUB.
По умолчанию параметр пустой, и в .ru-локали валюта = RUB, во всех остальных — USD. Указывайте валюту в формате:

country — если заполнить этот параметр, то в выпадающем списке точки Откуда и/или Куда виджет покажет направления только в указанной стране. Напишите название страны на русском или английском языке или укажите двухсимвольный код IATA следующим образом (пример для Франции):

Примечание: даже если вы выберете определенную страну, это не ограничит посетителя в поиске. Когда он начнет вводить название точки в другой стране, например «Берлин», то виджет найдет нужный город и позволит заказать трансфер.

Если страна не указана, т. е. параметр не заполнен, то будут предложены самые популярные маршруты в мире.

Обратите внимание! Данная опция не будет работать, если указаны несколько параметров (code, name). Необходимо указывать только один параметр.

place_from — точка отправления: название города (аэропорта, ж/д вокзала, автовокзала, порта) на русском или английском, либо код IATA. Если будет задана данная точка, то фрейм будет сразу загружать страницу со всеми маршрутами из данной точки. Это удобно, когда виджет размещен в статье или на сайте по конкретному направлению. Например, предложите своему читателю способы добраться из аэропорта Барселоны до других популярных городов Испании:

place_to — точка назначения: название города (аэропорта, ж/д вокзала, автовокзала, порта) на русском или английском, либо код IATA. Используйте аналогично точке Откуда (place_from):

Примечание: параметры country, place_from и place_to не зависят друг от друга. Вы можете настроить как все эти параметры, так и выборочно: один или два.

max_height — максимальная высота виджета в пикселях. По умолчанию параметр не задан и высота меняется в зависимости от содержимого. Минимальная высота — 400 пикселей. Вертикальная полоса прокрутки появится, если содержимое виджета будет больше. Пример:

disable_currency_selector — скрыть возможность выбора валюты трансфера. Используйте true, если хотите скрыть поле выбора валюты или false, чтобы поле отображалось. Указывайте:

чтобы скрыть поле:

Примечание: если поле скрыто, но валюта задана в параметре display_currency (см. описание выше), то цены будут отображаться в этой валюте.

hide_form_extras — скрыть дополнительные элементы с текстом со стартовой страницы виджета. Со скрытыми элементами виджет будет выглядеть так (сравните, например, с картинкой в параметре language):

Указывайте true, если хотите скрыть элементы или false, чтобы они отображались.

Задавайте параметр в формате:

deep_link — позволяет с помощью виджета создавать глубокую ссылку и направлять пользователя сразу на нужный шаг оформления заказа.
При включенной настройке вы можете добавить к адресу в URL точку Откуда, Куда и/или страну для поиска трансфера, а также класс авто, и виджет WL будет заполнен введенными данными. Ссылка со всеми атрибутами имеет вид:

#/country/страна/from/откуда/to/куда/by/класс авто
где: страна — это наименование страны на английском языке;
откуда, куда — наименование точки на английском языке, либо код IATA;
класс авто — класс автомобиля трансфера.

Части /country/страна, /from/откуда, /to/куда, /by/класс авто — необязательные, т. е. может быть указан только один, либо несколько из этих параметров.

Например, чтобы показать пользователю возможные варианты трансферов по маршруту Берлин — Аэропорт Берлин, направьте его по следующей ссылке:

https://адресвашегосайта.com/transfer/#/country/Germany/from/Berlin/to/TXL

Можно показать все маршруты "в точку", если указать:
https://адресвашегосайта.com/transfer/#/country/Germany/to/TXL

Если добавить в эту ссылку класс авто трансфера, как здесь:
https://адресвашегосайта.com/transfer/#/country/Germany/from/Berlin/to/TXL/by/Economy

то виджет откроется уже на этапе бронирования трансфера класса "Эконом":

Эта же функция позволит вам создать глубокую ссылку:
в полях виджета введите точки Откуда/Куда или обе, нажмите кнопку Найти, и в адресной строке вы получите URL глубокой ссылки.

Обратите внимание:
1. после добавления параметра в URL ссылку необходимо обновить,
2. ссылка будет приоритетнее прочих настроек виджета.
Для включения возможности формировать такую ссылку параметру deep_link присваивается значение true, иначе — false.

hide_external_links — скрыть ссылку Узнать подробнее (Read more), которая ведет на сайт Kiwitaxi. Прописывайте true, чтобы скрыть и false — чтобы отображать ссылку, в формате:

ref_params — ваш партнёрский идентификатор и внутренний идентификатор виджета. Параметры формируются автоматически нашей платформой, не изменяйте их.

scroll_offset — позволяет установить расстояние (в пикселях) от верха страницы до верхней точки видимого контента виджета.

Страница с результатами поиска автоматически прокручивается до классов трансфера. Чтобы эти результаты не перекрывались фиксированным хедером на странице (если на вашем сайте используются фиксированные хедеры), конфигурируйте параметр scroll_offset. По умолчанию равен 0, т.е. отступа нет.

Если у вас остались вопросы по установке или настройке White Label, пишите на cpa@kiwitaxi.com. Удачи!