FastSearch — передача параметров в форму поиска: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(→‎Fast Search для Frontend 2.0)
(→‎Fast Search для Frontend 2.0)
Строка 470: Строка 470:
  
 
==Fast Search для Frontend 2.0==
 
==Fast Search для Frontend 2.0==
−
При использовании Frontend 2.0 ссылка имеет следующий вид:
 
−
<pre>http://SITEMANE/search/IEVMOW20160218MOWIEV20160420ADT3INS1CLD2-direct-vicinityDates-class=Business-GO</pre>
 
−
или
 
−
<pre>http://SITEMANE/search/IEVMOWd10MOWIEVd20ADT3INS1CLD2-direct-vicinityDates-class=Business-GO</pre>
 
−
где:
 
−
* '''IEV, PEW''' — [[Международная ассоциация воздушного транспорта|IATA]] коды пунктов вылета/прилета
 
−
* '''20160420''' — дата вылета в формате ГГГММДД
 
−
* '''d10,d20''' — дата в формате dXX ,где XX это величина смещения относительно текущей даты.
 
−
* '''ADT 3 INS 1 CLD 2''' — типы [[Пассажир|пассажиров]] и их количество
 
−
* '''direct''' — прямые рейсы
 
−
* '''icinityDates''' — включить [[Поиск по окружным датам (Авиабилеты)|поиск по окружным датам]]
 
−
* '''class=Business''' — выбор [[Класс обслуживания|класса]]
 
−
* '''GO''' — параметр для запуска поиска. Если он не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет
 
  
 +
=== Параметры запроса ===
 +
При использовании Frontend 2.0 для ссылки доступны следующие переменные:
 +
Параметры в таблице приведены в том порядке, в котором они должны следовать с запросе.
 +
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;"
 +
! colspan="3" style="text-align:left;"| Параметры указания пассажиров в запросе поиска
 +
|-
 +
! scope="col" width="300" | Элемент
 +
! scope="col" width="250" | Формат ввода
 +
! scope="col" width="250" | Допустимые значения
 +
|-
 +
| rowspan="2" | Пункт вылета || rowspan="2" |Трехбуквенный '''IATA код''' аэропорта || MOW
 +
|-
 +
|LED
 +
|-
 +
|rowspan="2"| Пункт прилета || rowspan="2" |Трехбуквенный '''IATA код''' аэропорта || IEV
 +
|-
 +
|MOW
 +
|-
 +
| rowspan="2" | Дата вылета || Дата вылета в формате '''ГГГГММДД''' || 20160818
 +
|-
 +
|'''dX''', где ''X'' - смещение даты вылета относительно текущей даты. Неотрицательное число. || d7
 +
|-
 +
| rowspan="3"|Типы пассажиров и их количество ||rowspan="3"|Трехбуквенный '''код типа''' пассажира (ADT,CLD,INF,INS,YTH,SRC) с количеством || ADT2
 +
|-
 +
|ADT2INF2
 +
|-
 +
|ADT3INS1CLD2SRC1
 +
|-
 +
| Искать только прямые рейсы  || Команда || -direct
 +
|-
 +
| Искать по окружным датам  || Команда || -vicinityDates
 +
|-
 +
|rowspan="3"| Класс|| rowspan="3"|Название класса перелета (Economy, Business, First) || -class=Economy
 +
|-
 +
|  -class=Business
 +
|-
 +
|  -class=First
 +
|-
 +
| Запуск процесса поиска || Команда. Если параметр не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет || -GO
 +
|}
 
===Примеры===
 
===Примеры===
 
{| class="wikitable mw-collapsible mw-collapsed"
 
{| class="wikitable mw-collapsible mw-collapsed"
Строка 550: Строка 577:
 
|}
 
|}
 
|}
 
|}
−
 
−
=== Параметры запроса ===
 
−
Параметры в таблице приведены в том порядке, в котором они должны следовать с запросе.
 
−
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;"
 
−
! colspan="3" style="text-align:left;"| Параметры указания пассажиров в запросе поиска
 
−
|-
 
−
! scope="col" width="300" | Элемент
 
−
! scope="col" width="250" | Формат ввода
 
−
! scope="col" width="250" | Допустимые значения
 
−
|-
 
−
| rowspan="2" | Пункт вылета || rowspan="2" |Трехбуквенный '''IATA код''' аэропорта || MOW
 
−
|-
 
−
|LED
 
−
|-
 
−
|rowspan="2"| Пункт прилета || rowspan="2" |Трехбуквенный '''IATA код''' аэропорта || IEV
 
−
|-
 
−
|MOW
 
−
|-
 
−
| rowspan="2" | Дата вылета || Дата вылета в формате '''ГГГГММДД''' || 20160818
 
−
|-
 
−
|'''dX''', где ''X'' - смещение даты вылета относительно текущей даты. Неотрицательное число. || d7
 
−
|-
 
−
| rowspan="3"|Типы пассажиров и их количество ||rowspan="3"|Трехбуквенный '''код типа''' пассажира (ADT,CLD,INF,INS,YTH,SRC) с количеством || ADT2
 
−
|-
 
−
|ADT2INF2
 
−
|-
 
−
|ADT3INS1CLD2SRC1
 
−
|-
 
−
| Искать только прямые рейсы  || Команда || -direct
 
−
|-
 
−
| Искать по окружным датам  || Команда || -vicinityDates
 
−
|-
 
−
|rowspan="3"| Класс|| rowspan="3"|Название класса перелета (Economy, Business, First) || -class=Economy
 
−
|-
 
−
|  -class=Business
 
−
|-
 
−
|  -class=First
 
−
|-
 
−
| Запуск процесса поиска || Команда. Если параметр не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет || -GO
 
−
|}
 
  
 
== Взаимодействие Fast Search и модуля метрики ==
 
== Взаимодействие Fast Search и модуля метрики ==

Версия 16:23, 1 апреля 2016

FastSearch в Nemo.Travel — функция, позволяющая перенаправлять пользователей на страницу с уже заполненными параметрами поиска или напрямую на результаты поиска.

Назначение

Функция автоматически заполняет форму поиска и запускает процесс поиска.

Примеры использования

Формирование ссылок для баннеров, при щелчке на которые пользователь попадает на форму поиска с заполненными полями: пункт вылета и назначения, дата, количество и типы пассажиров и прочие параметры. Так же по ссылке можно запускать процесс поиска.

Принцип работы

Для использования Fast Search включите опцию Управление сайтом → Домены и протоколы → Включить Fast Search (передачу параметров поиска).

Запрос Fast Search состоит из параметров и их значений, которые в определенном порядке задаются в ссылке.

Fast Search для Frontend 1.0

При использовании Frontend 1.0 ссылка имеет следующий вид: 

http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=BER&departure_date=21.10.2009&adults=1&children=0&input_vendors=SU,PS&param_by_get=on

Имена переменных аналогичны именам полей на поисковой форме.

  • Значения переменных должны удовлетворять ограничениям параметров настройки.
  • Рекомендуется не включать в запрос переменные, которые предполагают в качестве значения true
  • Чтобы перенаправить пользователя на страницу с заполненными параметрами поиска, в конце запроса укажите get-параметр &param_by_get=on, иначе сработают стандартные предустановки полей формы поиска
  • Чтобы отправить пользователя напрямую на результаты поиска, укажите get-параметр &fast_search=on

Примеры

Маршрут в одну сторону

Прямые маршруты в одну сторону из Москвы в Париж на двух взрослых людей с вылетом 25.10.2016

  • Запрос заполняет форму поиска
http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on
  • Запрос запускает процесс поиска
http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on&fast_search=on
FS1Маршрут в одну сторону.png
Маршрут в одну сторону
Маршрут туда-обратно

Маршрут туда-обратно Москва - Париж - Москва эконом-классом на двух взрослых людей и младенца

  • Запрос заполняет форму поиска
http://SITEMANE/?trip_type=RT&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&back_departure_date=27.10.2016&class=econom&adults=2&infants=1&param_by_get=on
  • Запрос запускает процесс поиска
http://SITEMANE/?trip_type=RT&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&back_departure_date=27.10.2016&class=econom&adults=2&infants=1&param_by_get=on&fast_search=on
FS1Маршрут туда-обратно.png
Маршрут туда-обратно
Сложный маршрут

Сложный маршрут на одного взрослого из Москвы в Париж с вылетом 25.10.2016, из Парижа в Санкт-Петербург с вылетом 26.10.2016, из Санкт-Петербурга в Москву, с вылетом 29.10.2016.

  • Запрос заполняет форму поиска
http://SITEMANE/?trip_type=CR&cr_iata[0]=MOW&cr_back_iata[0]=PAR&cr_date[0]=25.10.2016&cr_iata[1]=PAR&cr_back_iata[1]=LED&cr_date[1]=26.10.2016&cr_iata[2]=LED&cr_back_iata[2]=MOW&cr_date[2]=29.10.2016&adults=1&param_by_get=on
  • Запрос запускает процесс поиска
http://SITEMANE/?trip_type=CR&cr_iata[0]=MOW&cr_back_iata[0]=PAR&cr_date[0]=25.10.2016&cr_iata[1]=PAR&cr_back_iata[1]=LED&cr_date[1]=26.10.2016&cr_iata[2]=LED&cr_back_iata[2]=MOW&cr_date[2]=29.10.2016&adults=1&param_by_get=on&fast_search=on
FS1сложный маршрут.png
Сложный маршрут

Параметры запроса

Маршрут «В одну сторону» или «Туда и обратно»

Параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
Элемент Переменная Допустимые значения
Тип маршрута trip_type
OW В одну сторону
RT Туда и обратно
CR Сложный маршрут
Пункт вылета out_iata
MOW Код аэропорта ИАТА
Пункт прилета in_iata
LED Код аэропорта ИАТА
Дата вылета departure_date
25.10.2013 Дата в формате ДД.ММ.ГГГГ
Дата обратного вылета back_departure_date
27.10.2013 Дата в формате ДД.ММ.ГГГГ
Время вылета prefered_departure_type
not_important Любое время
morning Утром
afternoon Днем
evening Вечером
night Ночью
Время обратного вылета prefered_back_departure_type
not_important Любое время
morning Утром
afternoon Днем
evening Вечером
night Ночью
Поиск только среди прямых рейсов ("Без пересадок") direct true
Дополнительные параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
Элемент Переменная Допустимые значения
Нижнее ограничение по цене по умолчанию money_from
0 Целое число большее либо равное 0
Верхнее ограничение по цене по умолчанию money_to
10000 Целое число большее 0
Поиск в окружных датах district_date true
Диапазон соседних дат +(-) [дней] date_range
1 Целое число большее [1..3]
Поиск по соседним аэропортам district_airport true
Класс обслуживания class
econom Перелет эконом-классом
business Перелет бизнес-классом
first Перелет первым-классом
Фильтр по авиакомпании input_vendors
SU,PS Коды авиакомпании ИАТА через запятую без пробелов
Сортировка sort
price По стоимости
out_date По расписанию
company По авиакомпании
fltduration По длительности перелёта

Сложный маршрут

Внимание! Данные переменные применимы только для сложного маршрута (trip_type=CR).

Параметры запроса для поиска сложного маршрута
Элемент Переменная Допустимые значения
Пункты вылета cr_iata[0]

cr_iata[1]
...
cr_iata[8]

MOW Код аэропорта ИАТА
Пункты прилета cr_back_iata[0]

cr_back_iata[1]
...
cr_back_iata[8]

LED Код аэропорта ИАТА
Дата вылета cr_date[0]

cr_date[1]
...
cr_date[8]

25.10.2013 Дата в формате ДД.ММ.ГГГГ
Время вылета cr_pref_departure[0]

cr_pref_departure[1]
...
cr_pref_departure[8]

not_important Любое время
morning Утром
afternoon Днем
evening Вечером
night Ночью
Класс обслуживания cr_class[0]

cr_class[1]
...
cr_class[8]

econom Перелет эконом-классом
business Перелет бизнес-классом
first Перелет первым классом
Окружные аэропорты (±XX км) cr_district_airport[0]

cr_district_airport[1]
...
cr_district_airport[8]

true

[X] - номера отдельных перелетов. Нумерация начинается с 0, что означает первый перелет.

Максимальное количество сегментов для сложного маршрута определяется в разделе Управление продажами → Устаревшие настройки → Ограничения поиска.

Пассажиры

Параметры указания пассажиров в запросе поиска
Элемент Переменная Допустимые значения
Взрослых от 12 лет adults
Целое число большее либо равное 0
Детей от 2 до 12 лет children
Целое число большее либо равное 0
Младенцев до 2 лет infants
Целое число большее либо равное 0
Младенцев с местом до 2 лет infants_seat
Целое число большее либо равное 0
Молодых от 12 до 24 лет
youths
Целое число большее либо равное 0
Пожилых от 65 лет seniors
Целое число большее либо равное 0

Fast Search для Frontend 2.0

Параметры запроса

При использовании Frontend 2.0 для ссылки доступны следующие переменные: Параметры в таблице приведены в том порядке, в котором они должны следовать с запросе.

Параметры указания пассажиров в запросе поиска
Элемент Формат ввода Допустимые значения
Пункт вылета Трехбуквенный IATA код аэропорта MOW
LED
Пункт прилета Трехбуквенный IATA код аэропорта IEV
MOW
Дата вылета Дата вылета в формате ГГГГММДД 20160818
dX, где X - смещение даты вылета относительно текущей даты. Неотрицательное число. d7
Типы пассажиров и их количество Трехбуквенный код типа пассажира (ADT,CLD,INF,INS,YTH,SRC) с количеством ADT2
ADT2INF2
ADT3INS1CLD2SRC1
Искать только прямые рейсы Команда -direct
Искать по окружным датам Команда -vicinityDates
Класс Название класса перелета (Economy, Business, First) -class=Economy
-class=Business
-class=First
Запуск процесса поиска Команда. Если параметр не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет -GO

Примеры

Маршрут в одну сторону

Прямые маршруты эконом класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам.

  • Запрос заполняет форму поиска
http://SITEMANE/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy
  • Запрос запускает процесс поиска
http://SITEMANE/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy-GO
FS2Маршрут в одну сторону.png
Форма поиска автоматически заполненная с помощью запроса Fast Search
FS2Маршрут в одну сторону. Пассажиры.png
Форма пассажиров автоматически заполненная с помощью запроса Fast Search
Маршрут туда-обратно

Маршрут бизнес класса из Москвы в Берлин с вылетом через 10 дней от текущей даты и обратно через 20 дней от текущей даты на двух взрослых.

  • Запрос заполняет форму поиска
http://SITEMANE/search/MOWBERd10BERMOWd20ADT2-class=Business
  • Запрос запускает процесс поиска
http://SITEMANE/search/MOWBER20160218d10BERMOW20160222d20ADT2-class=Business-GO
FS2Маршрут туда-обратно.png
Форма поиска автоматически заполненная с помощью запроса Fast Search
Сложный маршрут

Маршрут из Киева в Пешевар с вылетом 10.07.2016, из Пешевара в Москву с вылетом 18.07.2016, из Москвы в Париж, с вылетом 19.07.2016 на одного взрослого.

  • Запрос заполняет форму поиска
http://SITEMANE/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1
  • Запрос запускает процесс поиска
http://SITEMANE/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1-GO
FS2сложный маршрут.png
Форма поиска автоматически заполненная с помощью запроса Fast Search

Взаимодействие Fast Search и модуля метрики

Отображение источника перехода в служебной информации.

Чтобы зафиксировать источник ссылки, по которой перешел пользователь, необходимо передать в конце запроса дополнительный параметр: 

&utm_source=source_alias

где source_alias — алиас источника перехода модуля метрики.

Информация об источнике перехода отображается в логах и на странице заказа в служебной информации.

Пример Fast Search для Frontend 1.0

Запрос Fast Search для Frontend 1.0 с учетом источника перехода модуля метрики

Маршрут в одну сторону без пересадок на одного взрослого из Москвы в Париж с вылетом 25.10.2016 (с учетом источника перехода модуля метрики).

  • Запрос заполняет форму поиска
http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on&utm_source=source_alias
  • Запрос запускает процесс поиска
http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on&fast_search=on&utm_source=source_alias

Пример Fast Search для Frontend 2.0

Запрос Fast Search для Frontend 2.0 с учетом источника перехода модуля метрики

Прямые маршруты эконом класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам (с учетом источника перехода модуля метрики).

  • Запрос заполняет форму поиска
http://SITEMANE/search/MOWPAR20160918ADT3INS1CLD2-vicinityDates-class=Economy&utm_source=source_alias
  • Запрос запускает процесс поиска
http://SITEMANE/search/MOWPAR20160918ADT3INS1CLD2-vicinityDates-class=Economy-GO&utm_source=source_alias

См. также

Источник — https://support.nemo.travel/index.php?title=FastSearch_—_передача_параметров_в_форму_поиска&oldid=8912