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

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(→‎Применение)
Строка 1: Строка 1:
−
{{Contract}}
+
[[Категория:Плагины (Авиабилеты)]]
−
В системе Nemo имеется возможность перенаправлять пользователей на страницу с уже заполненными параметрами поиска или сразу напрямую на результаты поиска.
+
[[Категория:API (Авиабилеты)]]
 +
<!-- -->
 +
FastSearch в {{NameSystem|link}} — функция, позволяющая перенаправлять пользователей на страницу с уже заполненными параметрами поиска или напрямую на результаты поиска.
  
−
== Применение ==
+
==Назначение==
−
Эта технология может использоватся к примеру для формирования ссылок с баннеров, при клике на которые пользователь попадает на форму, на которой уже могут быть заполнены пункты назначения, даты, количество пассажиров и прочие параметры.
+
Функция автоматически заполняет форму поиска и запускает процесс поиска.
  
−
Также, при указании всех необходимых параметров, пользователя можно перебрасывать сразу на процесс поиска авиабилетов с указанными критериями.
+
== Примеры использования ==
 +
Формирование ссылок для баннеров, при щелчке на которые [[пользователь]] попадает на [[Форма поиска (Авиабилеты)|форму поиска]] с заполненными полями: пункт вылета и назначения, дата, количество и типы пассажиров и прочие параметры. Так же по ссылке можно запускать процесс [[Поиск (Авиабилеты)|поиска]].
  
−
Для использования заполнения формы из URL следует включить опцию: '''Администрирование''' → '''Настройки системы''' → '''''Включить FastSearch (передачу параметров поиска)'''''
+
== Принцип работы ==
 +
Для использования Fast Search включите опцию {{Menu|Управление сайтом|Домены и протоколы|Включить Fast Search (передачу параметров поиска)}}.
  
−
После этого можно использовать ссылки на форму поиска вида
+
Запрос Fast Search состоит из ''параметров'' и их ''значений'', которые в определенном порядке задаются в ссылке.
 +
 
 +
==Fast Search для Frontend 1.0==
 +
При использовании Frontend 1.0 ссылка имеет следующий вид:
  
 
<pre>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</pre>
 
<pre>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</pre>
  
−
При использовании Frontend 2.0 необходимо передавать ссылку в следующем виде:
+
Имена переменных аналогичны именам полей на поисковой форме.
−
<pre>http://SITEMANE/search/IEVPEW20150718PEWMOW20150710ADT3INS1CLD2-direct-vicinityDates-class=Business-GO</pre>
 
  
−
Или:
+
*Значения переменных должны удовлетворять ограничениям параметров настройки.
 +
*Рекомендуется не включать в запрос переменные, которые предполагают в качестве значения ''true'' <!-- чтобы их логика не отработала.-->
 +
*Чтобы перенаправить пользователя '''''на страницу с заполненными параметрами поиска''''', в конце запроса укажите get-параметр '''&param_by_get=on''', иначе сработают стандартные предустановки полей формы поиска
 +
*Чтобы отправить пользователя напрямую '''''на результаты поиска''''', укажите get-параметр '''&fast_search=on'''
  
−
<pre>http://SITEMANE/search/MOWPARd3PARMOWd10ADT1-direct-class=Business-GO</pre>
+
=== Примеры ===
−
Где:
+
{| class="wikitable mw-collapsible mw-collapsed" style="width: 1000px;"
 +
! style="text-align:left;"| Маршрут в одну сторону
 +
|-
 +
|
 +
Прямые маршруты в одну сторону из Москвы в Париж на двух взрослых людей с вылетом 25.10.2016
 +
* '''''Запрос заполняет форму поиска'''''
 +
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 +
http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on
 +
</syntaxhighlight>
 +
* '''''Запрос запускает процесс поиска'''''
 +
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">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
 +
</syntaxhighlight>
  
−
- IEV, PEW -IATA коды пунктов вылета/прилета
+
{| class="wikitable"
 +
|-
 +
|[[Файл:FS1Маршрут в одну сторону.png]]
 +
|-
 +
|Маршрут в одну сторону
 +
|}
 +
|}
  
−
- 20150718 - дата в формате YYYY-MM-DD
+
{| class="wikitable mw-collapsible mw-collapsed" style="width: 1000px;"
 +
! style="text-align:left;"| Маршрут туда-обратно
 +
|-
 +
|
 +
Маршрут туда-обратно Москва - Париж - Москва эконом-классом на двух взрослых людей и младенца
 +
* '''''Запрос заполняет форму поиска'''''
 +
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 +
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
 +
</syntaxhighlight>
 +
* '''''Запрос запускает процесс поиска'''''
 +
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">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
 +
</syntaxhighlight>
  
−
- d3,d10 - дата в формате dXX, где XX это величина смещения относительно текущей даты.
+
{| class="wikitable"
 +
|-
 +
|[[Файл:FS1Маршрут туда-обратно.png]]
 +
|-
 +
|Маршрут туда-обратно
 +
|}
 +
|}
  
−
- ADT 3 INS 1 CLD 2 - Типы пассажиров и их количество
+
{| class="wikitable mw-collapsible mw-collapsed" style="width: 1000px;"
 +
! style="text-align:left;"| Сложный маршрут
 +
|-
 +
|
 +
Сложный маршрут на одного взрослого из Москвы в Париж с вылетом 25.10.2016, из Парижа в Санкт-Петербург с вылетом 26.10.2016, из Санкт-Петербурга в Москву, с вылетом 29.10.2016.
 +
* '''''Запрос заполняет форму поиска'''''
 +
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
 +
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
 +
</syntaxhighlight>
 +
* '''''Запрос запускает процесс поиска'''''
 +
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">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
 +
</syntaxhighlight>
  
−
- direct - прямые рейсы
+
{| class="wikitable"
 +
|-
 +
|[[Файл:FS1сложный маршрут.png]]
 +
|-
 +
|Сложный маршрут
 +
|}
 +
|}
  
−
- vicinityDates - включение поиска по окружным датам
+
=== Параметры запроса ===
−
 
+
==== Маршрут «В одну сторону» или «Туда и обратно» ====
−
- class=Business - выбор класса
+
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;"
−
 
+
! colspan="3" style="text-align:left;"| Параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
−
- GO - параметр для запуска поиска (в случае, если параметр не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет)
 
−
 
 
−
== Переменные FastSearch ==
 
−
Имена полей - такие же как имена инпутов на поисковой форме.
 
−
 
 
−
Следите за тем, чтобы значения соответствовали установленным в настройках ограничениям.
 
−
 
 
−
Переменные, которые предполагают в качестве значения "true" можно просто не включать в запрос, чтобы их логика не отработала.
 
−
 
 
−
=== Форма поиска ===
 
−
Чтобы перенаправить пользователя на страницу с заполненными параметрами поиска, необходимо указать get-параметр '''&param_by_get=on''', иначе сработают стандартные предустановки полей формы поиска.
 
−
 
 
−
=== Процесс поиска ===
 
−
Если вы указываете все необходимые для поиска параметры, то для того чтобы отправить пользователя сразу на результаты поиска, нужно указать get-параметр '''&fast_search=on'''.
 
−
 
 
−
=== Маршрут «В одну сторону» и «Туда и обратно» ===
 
−
{| style="width: 800px;" class="wikitable"
 
 
|-
 
|-
 
! scope="col" width="300" | Элемент
 
! scope="col" width="300" | Элемент
Строка 169: Строка 212:
 
|}
 
|}
  
−
==== Дополнительные параметры ====
+
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;"
−
{| style="width: 800px" class="wikitable"
+
! colspan="3" style="text-align:left;"| Дополнительные параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
 
|-
 
|-
 
! scope="col" width="300" | Элемент
 
! scope="col" width="300" | Элемент
Строка 263: Строка 306:
 
| По длительности перелёта
 
| По длительности перелёта
 
|}
 
|}
−
 
 
|}
 
|}
  
−
=== Сложный маршрут ===
+
==== Сложный маршрут ====
−
<span style="font-size: large; color: rgb(255, 0, 0);">!&nbsp;</span><span style="background-color: rgb(255, 240, 245);">&nbsp;Данные переменные применимы только для сложного маршрута ('''trip_type=CR''').</span>
+
{{Attention|Данные переменные применимы только для сложного маршрута (trip_type&#61;CR).}}
−
 
 
−
'''[X]''' - номера отдельных перелетов. Нумерация начинается с 0, что означает первый перелет.
 
  
−
Максимальное количество сегментов для сложного маршрута определяется одноименной настройкой в разделе '''Авиабилеты ⇨ Поиск ⇨ Ограничения поиска'''.
+
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;"
−
 
+
! colspan="4" style="text-align:left;"| Параметры запроса для поиска сложного маршрута
−
{| style="width: 800px;" class="wikitable"
 
 
|-
 
|-
 
! scope="col" width="300" | Элемент
 
! scope="col" width="300" | Элемент
Строка 357: Строка 396:
 
|}
 
|}
  
−
=== Пассажиры ===
+
'''[X]''' - номера отдельных перелетов. Нумерация начинается с 0, что означает первый перелет.
−
{| style="width: 800px" class="wikitable"
+
 
 +
Максимальное количество сегментов для [[Маршрут#Сложный маршрут|сложного маршрута]] определяется в разделе {{Menu|Управление продажами|Устаревшие настройки|Ограничения поиска}}.
 +
 
 +
==== Пассажиры ====
 +
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;"
 +
! colspan="3" style="text-align:left;"| Параметры указания пассажиров в запросе поиска
 
|-
 
|-
 
! scope="col" width="300" | Элемент
 
! scope="col" width="300" | Элемент
Строка 370: Строка 414:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
−
| width="80" | 1
 
 
| Целое число большее либо равное 0
 
| Целое число большее либо равное 0
 
|}
 
|}
Строка 381: Строка 424:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
−
| width="80" | 1
 
 
| Целое число большее либо равное 0
 
| Целое число большее либо равное 0
 
|}
 
|}
Строка 392: Строка 434:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
−
| width="80" | 1
 
 
| Целое число большее либо равное 0
 
| Целое число большее либо равное 0
 
|}
 
|}
Строка 403: Строка 444:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
−
| width="80" | 1
 
 
| Целое число большее либо равное 0
 
| Целое число большее либо равное 0
 
|}
 
|}
Строка 414: Строка 454:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
−
| width="80" | 1
+
| Целое число большее либо равное 0
−
| Целое число большее либо равное 0<br/>
 
−
<span style="font-size: large; color: rgb(255, 0, 0);">!&nbsp;</span><span style="background-color: rgb(255, 240, 245);">&nbsp;Данный параметр доступен только в новой базовой теме.</span>
 
 
|}
 
|}
  
Строка 426: Строка 464:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
−
| width="80" | 1
+
| Целое число большее либо равное 0
−
| Целое число большее либо равное 0<br/>
+
|}
−
<span style="font-size: large; color: rgb(255, 0, 0);">!&nbsp;</span><span style="background-color: rgb(255, 240, 245);">&nbsp;Данный параметр доступен только в новой базовой теме.</span>
+
 
 +
|}
 +
 
 +
==Fast Search для Frontend 2.0==
 +
При использовании Frontend 2.0 ссылка имеет следующий вид:
 +
<pre>http://SITEMANE/search/IEVMOW20160218MOWIEV20160420ADT3INS1CLD2-direct-vicinityDates-class=Business-GO</pre>
 +
где:
 +
* '''IEV, PEW''' — [[Международная ассоциация воздушного транспорта|IATA]] коды пунктов вылета/прилета
 +
* '''20160420''' — дата вылета в формате ГГГММДД
 +
* '''ADT 3 INS 1 CLD 2''' — типы [[Пассажир|пассажиров]] и их количество
 +
* '''direct''' — прямые рейсы
 +
* '''icinityDates''' — включить [[Поиск по окружным датам (Авиабилеты)|поиск по окружным датам]]
 +
* '''class=Business''' — выбор [[Класс обслуживания|класса]]
 +
* '''GO''' — параметр для запуска поиска. Если он не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет
 +
 
 +
===Примеры===
 +
{| class="wikitable mw-collapsible mw-collapsed"
 +
| '''Маршрут в одну сторону'''
 +
|-
 +
|
 +
Прямые маршруты эконом класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам.
 +
* '''''Запрос заполняет форму поиска'''''
 +
<pre>http://SITEMANE/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy</pre>  
 +
 
 +
* '''''Запрос запускает процесс поиска'''''
 +
<pre>http://SITEMANE/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy-GO</pre>
 +
 
 +
{| class="wikitable"
 +
|-
 +
|[[Файл:FS2Маршрут в одну сторону.png]]
 +
|-
 +
| Форма поиска автоматически заполненная с помощью запроса Fast Search
 +
|}
 +
 
 +
{| class="wikitable"
 +
|-
 +
|[[Файл:FS2Маршрут в одну сторону. Пассажиры.png]]
 +
|-
 +
| Форма пассажиров автоматически заполненная с помощью запроса Fast Search
 +
|}
 +
|}
 +
 
 +
{| class="wikitable mw-collapsible mw-collapsed"
 +
| '''Маршрут туда-обратно'''
 +
|-
 +
|
 +
Маршрут бизнес класса из Москвы в Берлин с вылетом 18.02.2016 и обратно 22.02.2016 на двух взрослых.
 +
 
 +
* '''''Запрос заполняет форму поиска'''''
 +
<pre>http://SITEMANE/search/MOWBER20160218BERMOW20160222ADT2-class=Business</pre>  
 +
 
 +
* '''''Запрос запускает процесс поиска'''''
 +
<pre>http://SITEMANE/search/MOWBER20160218BERMOW20160222ADT2-class=Business-GO</pre>
 +
 
 +
{| class="wikitable"
 +
|-
 +
|[[Файл:FS2Маршрут туда-обратно.png]]
 +
|-
 +
| Форма поиска автоматически заполненная с помощью запроса Fast Search
 +
|}
 
|}
 
|}
  
 +
{| class="wikitable mw-collapsible mw-collapsed"
 +
| '''Сложный маршрут'''
 +
|-
 +
|
 +
Маршрут из Киева в Пешевар с вылетом 10.07.2016, из Пешевара в Москву с вылетом 18.07.2016, из Москвы в Париж, с вылетом 19.07.2016 на одного взрослого.
 +
 +
* '''''Запрос заполняет форму поиска'''''
 +
<pre>http://SITEMANE/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1</pre>
 +
 +
* '''''Запрос запускает процесс поиска'''''
 +
<pre>http://SITEMANE/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1-GO</pre>
 +
 +
{| class="wikitable"
 +
|-
 +
|[[Файл:FS2сложный маршрут.png]]
 +
|-
 +
| Форма поиска автоматически заполненная с помощью запроса Fast Search
 +
|}
 
|}
 
|}
  
−
=== Примеры FastSearch запросов ===
+
=== Параметры запроса ===
 +
Параметры в таблице приведены в том порядке, в котором они должны следовать с запросе.
 +
{| 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
 +
|-
 +
| Дата вылета || Формат ГГГГММДД || 20160818
 +
|-
 +
| 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
 +
|}
  
−
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
+
== Взаимодействие Fast Search и модуля метрики ==
−
<u>'''В одну сторону (простой)'''</u>
+
[[Файл:Источник перехода в служебной информации.png|thumb|250px|right|Отображение источника перехода в служебной информации.]]
−
<div class="mw-collapsible-content">
+
<!-- -->
−
'''Рейс в одну сторону из Москвы в Париж, дата вылета: 25.10.2013, без пересадок, 1 взрослый'''
+
Чтобы зафиксировать источник ссылки, по которой перешел пользователь, необходимо передать в конце запроса дополнительный параметр:
−
* '''''форма поиска'''''
+
<syntaxhighlight lang="text" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">&utm_source=source_alias</syntaxhighlight>
−
<pre>http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
+
где '''source_alias''' — алиас источника перехода [[Модуль метрики |модуля метрики]].
−
&direct=true&adults=2&param_by_get=on</pre>
 
−
* '''''процесс поиска'''''
 
−
<pre>http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
 
−
&direct=true&adults=2&param_by_get=on&fast_search=on</pre>
 
−
</div>
 
−
</div>
 
  
−
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
+
Информация об источнике перехода отображается в [[Логи системы|логах]] и на странице заказа в [[Форма бронирования (Авиабилеты)#Интерфейс|служебной информации]].
−
<u>'''В одну сторону (с фильтрами по авиакомпаниям)'''</u>
 
−
<div class="mw-collapsible-content">
 
−
'''Рейс в одну сторону из Москвы в Париж, дата вылета 25.10.2013, Пассажиры: пожилых - 2, Авиакомпании: Аэрофлот - Российские авиалинии, Международные Авиалинии Украины'''
 
−
* '''''форма поиска'''''
 
−
<pre>http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
 
−
&seniors=2&input_vendors=SU,PS&param_by_get=on</pre>
 
−
* '''''процесс поиска'''''
 
−
<pre>http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
 
−
&seniors=2&input_vendors=SU,PS&param_by_get=on&fast_search=on</pre>
 
−
</div>
 
−
</div>
 
  
−
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
+
=== Пример Fast Search для Frontend 1.0 ===
−
<u>'''Туда-обратно'''</u>
+
{| class="wikitable mw-collapsible mw-collapsed"
−
<div class="mw-collapsible-content">
+
! style="text-align:left;"| Запрос Fast Search для Frontend 1.0 с учетом источника перехода модуля метрики
−
'''Рейсы туда-обратно Москва ↔ Париж, дата вылета: 25.10.2013, обратно: 27.10.2013, класс перелета: Эконом, Пассажиры: взрослых - 2 младенцев - 1'''
+
|-
−
* '''''форма поиска'''''
+
|
−
<pre>http://SITEMANE/?trip_type=RT&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
+
Маршрут в одну сторону без пересадок на одного взрослого из Москвы в Париж с вылетом 25.10.2016 (с учетом источника перехода модуля метрики).
−
&back_departure_date=27.10.2013&class=econom&adults=2&infants=1&param_by_get=on</pre>
 
−
* '''''процесс поиска'''''
 
−
<pre>http://SITEMANE/?trip_type=RT&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
 
−
&back_departure_date=27.10.2013&class=econom&adults=2&infants=1&param_by_get=on&fast_search=on</pre>
 
−
</div>
 
−
</div>
 
  
−
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
+
* '''''Запрос заполняет форму поиска'''''
−
<u>'''Сложный маршрут'''</u>
+
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
−
<div class="mw-collapsible-content">
+
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
−
'''из Москвы в Париж, дата вылета 25.10.2013,'''<br/>
+
</syntaxhighlight>
−
'''из Парижа в Санкт-Петербург, дата вылета 26.10.2013,'''<br/>
 
−
'''из Санкт-Петербурга в Москву, дата вылета 29.10.2013,'''<br/>
 
−
'''1 взрослый'''
 
−
* '''''форма поиска'''''
 
−
<pre>http://SITEMANE/?trip_type=CR
 
−
&cr_iata[0]=MOW&cr_back_iata[0]=PAR&cr_date[0]=25.10.2013
 
−
&cr_iata[1]=PAR&cr_back_iata[1]=LED&cr_date[1]=26.10.2013
 
−
&cr_iata[2]=LED&cr_back_iata[2]=MOW&cr_date[2]=29.10.2013
 
−
&adults=1&param_by_get=on</pre>
 
−
* '''''процесс поиска'''''
 
−
<pre>http://SITEMANE/?trip_type=CR
 
−
&cr_iata[0]=MOW&cr_back_iata[0]=PAR&cr_date[0]=25.10.2013
 
−
&cr_iata[1]=PAR&cr_back_iata[1]=LED&cr_date[1]=26.10.2013
 
−
&cr_iata[2]=LED&cr_back_iata[2]=MOW&cr_date[2]=29.10.2013
 
−
&adults=1&param_by_get=on&fast_search=on</pre>
 
−
</div>
 
−
</div>
 
  
−
== Взаимодействие FastSearch и Метрики ==
+
* '''''Запрос запускает процесс поиска'''''
−
Для того, чтобы переход был зарегистрирован системой как переход с определенного источника, необходимо передать в запросе дополнительный параметр utm_source (Metrics Session ID). Например:
+
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
−
<pre>http://SITEMANE/?(some_parameters=vals&)utm_source=source_alias</pre>
+
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
−
где source_alias - алиас источника переходов. [[Модуль метрики | Дополнительная информация по использованию модуля Метрики]].
+
</syntaxhighlight>
 +
|}
  
−
=== Пример FastSearch запроса с параметром для модуля Метрики ===
+
===Пример Fast Search для Frontend 2.0===
−
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
+
{| class="wikitable mw-collapsible mw-collapsed"
−
<u>'''FastSearch (с учетом источника перехода для модуля Метрики)'''</u>
+
! Запрос Fast Search для Frontend 2.0 с учетом источника перехода модуля метрики
−
<div class="mw-collapsible-content">
+
|-
−
'''Рейс в одну сторону из Москвы в Париж, дата вылета: 25.10.2013, без пересадок, 1 взрослый (с учетом источника перехода для модуля Метрики).'''
+
|
−
* '''''форма поиска'''''
+
Прямые маршруты эконом класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам (с учетом источника перехода модуля метрики).
−
<pre>
+
 
−
http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
+
* '''''Запрос заполняет форму поиска'''''
−
&direct=true&adults=2&param_by_get=on&utm_source=source_alias
+
<pre>http://SITEMANE/search/MOWPAR20160218ADT3INS1CLD2-vicinityDates-class=Economy&utm_source=source_alias</pre>  
−
</pre>
+
 
−
* '''''процесс поиска'''''
+
* '''''Запрос запускает процесс поиска'''''
−
<pre>
+
<pre>http://SITEMANE/search/MOWPAR20160218ADT3INS1CLD2-vicinityDates-class=Economy-GO&utm_source=source_alias</pre>  
−
http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
+
|}
−
&direct=true&adults=2&param_by_get=on&fast_search=on&utm_source=source_alias
 
−
</pre>
 
−
</div>
 
−
</div>
 
  
 
== См. также ==
 
== См. также ==
−
*[[Fast Search для отелей]]
+
*[[Поиск (Авиабилеты)]]
 +
*[[Маршрут]]
 
*[[Модуль метрики]]
 
*[[Модуль метрики]]
−
*[[Интеграция]]
 
−
 
−
[[Категория:Функции]]<br>
 

Версия 10:52, 18 марта 2016

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

Назначение

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

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

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

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

Для использования Fast Search включите опцию Шаблон:Menu.

Запрос 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, что означает первый перелет.

Максимальное количество сегментов для сложного маршрута определяется в разделе Шаблон:Menu.

Пассажиры

Параметры указания пассажиров в запросе поиска
Элемент Переменная Допустимые значения
Взрослых от 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 ссылка имеет следующий вид: 

http://SITEMANE/search/IEVMOW20160218MOWIEV20160420ADT3INS1CLD2-direct-vicinityDates-class=Business-GO

где:

  • IEV, PEW — IATA коды пунктов вылета/прилета
  • 20160420 — дата вылета в формате ГГГММДД
  • ADT 3 INS 1 CLD 2 — типы пассажиров и их количество
  • direct — прямые рейсы
  • icinityDates — включить поиск по окружным датам
  • class=Business — выбор класса
  • 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
Маршрут туда-обратно

Маршрут бизнес класса из Москвы в Берлин с вылетом 18.02.2016 и обратно 22.02.2016 на двух взрослых.

  • Запрос заполняет форму поиска
http://SITEMANE/search/MOWBER20160218BERMOW20160222ADT2-class=Business
  • Запрос запускает процесс поиска
http://SITEMANE/search/MOWBER20160218BERMOW20160222ADT2-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

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

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

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

Взаимодействие 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/MOWPAR20160218ADT3INS1CLD2-vicinityDates-class=Economy&utm_source=source_alias
  • Запрос запускает процесс поиска
http://SITEMANE/search/MOWPAR20160218ADT3INS1CLD2-vicinityDates-class=Economy-GO&utm_source=source_alias

См. также

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