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

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Дополнительные параметры)
(Отмена правки 15015, сделанной Андрей Кизимов (обсуждение))
 
(не показаны 42 промежуточные версии 6 участников)
Строка 1: Строка 1:
{{Contract}}
+
[[Категория:Плагины (Авиабилеты)]]
В системе Nemo имеется возможность перенаправлять пользователей на страницу с уже заполненными параметрами поиска или сразу напрямую на результаты поиска.
+
[[Категория:Интеграция]]
 +
[[Категория:Модули]]
 +
[[Категория:Встроенные модули]]
 +
<!-- -->
 +
FastSearch в {{NameSystem|link}} — функция [http://www.nemo.travel системы онлайн-бронирования {{NameSystem}}], позволяющая перенаправлять пользователей на страницу с уже заполненными параметрами поиска или напрямую на результаты актуального поиска.
  
== Применение ==
+
==Назначение==
Эта технология может использоватся к примеру для формирования ссылок с баннеров, при клике на которые пользователь попадает на форму, на которой уже могут быть заполнены пункты назначения, даты, количество пассажиров и прочие параметры.
+
Функция автоматически заполняет форму поиска и запускает процесс поиска.
  
Также, при указании всех необходимых параметров, пользователя можно перебрасывать сразу на процесс поиска авиабилетов с указанными критериями.
+
== Примеры использования ==
 +
Формирование ссылок для баннеров или спецпредложений для клиентов, по клику на которые [[пользователь]] попадает на [[Форма поиска (Авиабилеты)|форму поиска]] с уже заполненными полями: пункт вылета и назначения, дата, количество и типы пассажиров и прочие параметры. Также по ссылке можно сразу запускать процесс [[Поиск (Авиабилеты)|поиска]] по заданным заранее параметрам.
  
Для использования заполнения формы из URL следует включить опцию: '''Администрирование''' → '''Настройки системы''' → '''''Включить FastSearch (передачу параметров поиска)'''''
+
== Принцип работы ==
 +
Для использования Fast Search включите одноименную опцию в разделе настроек '''Управление сайтом Домены и протоколы Включить Fast Search (передачу параметров поиска)'''.<!--{{Menu|Управление сайтом|Домены и протоколы|Включить Fast Search (передачу параметров поиска)}}.-->
  
После этого можно использовать ссылки на форму поиска вида
+
Запрос Fast Search состоит из ''параметров'' и их ''значений'', которые в определенном порядке задаются в ссылке.
  
<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>
+
==Fast Search для Frontend 1.0==
  
== Переменные FastSearch ==
+
{{Attention| Приведенные ниже инструкции актуальны только для старых тем оформления! Для тем оформления, унаследованных от темы wurst, см. подраздел '''Fast Search для Frontend 2.0''' данной статьи!}}<br>
Имена полей - такие же как имена инпутов на поисковой форме.
+
При использовании Frontend 1.0 ссылка имеет следующий вид:
  
Следите за тем, чтобы значения соответствовали установленным в настройках ограничениям.
+
<pre>http://SITENAME/?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>
  
Переменные, которые предполагают в качестве значения "true" можно просто не включать в запрос, чтобы их логика не отработала.
+
Имена переменных аналогичны именам полей на поисковой форме.
  
=== Форма поиска ===
+
*Значения переменных должны удовлетворять ограничениям из соответствующих настроек формы поиска. Например, если согласно настройкам поиск можно совершать не далее чем на 270 дней вперед, то для FastSearch это ограничение тоже будет действовать.
Чтобы перенаправить пользователя на страницу с заполненными параметрами поиска, необходимо указать get-параметр '''&param_by_get=on''', иначе сработают стандартные предустановки полей формы поиска.
+
*Рекомендуется не включать в запрос переменные, которые предполагают в качестве значения ''true'' <!-- чтобы их логика не отработала.-->
 +
*Чтобы перенаправить пользователя '''''на форму с заполненными параметрами поиска''''', в конце запроса добавьте get-параметр '''&param_by_get=on''', иначе сработают стандартные предустановки полей формы поиска.
 +
*Чтобы отправить пользователя напрямую '''''на результаты поиска''''', добавьте get-параметр '''&fast_search=on'''.
  
=== Процесс поиска ===
+
=== Примеры ===
Если вы указываете все необходимые для поиска параметры, то для того чтобы отправить пользователя сразу на результаты поиска, нужно указать get-параметр '''&fast_search=on'''.
+
{| 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://SITENAME/?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://SITENAME/?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>
 +
 
 +
{| class="wikitable"
 +
|-
 +
|[[Файл:FS1Маршрут в одну сторону.png]]
 +
|-
 +
|Маршрут в одну сторону
 +
|}
 +
|}
 +
 
 +
{| 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://SITENAME/?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://SITENAME/?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>
 +
 
 +
{| class="wikitable"
 +
|-
 +
|[[Файл:FS1Маршрут туда-обратно.png]]
 +
|-
 +
|Маршрут туда-обратно
 +
|}
 +
|}
 +
 
 +
{| 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://SITENAME/?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://SITENAME/?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>
 +
 
 +
{| class="wikitable"
 +
|-
 +
|[[Файл:FS1сложный маршрут.png]]
 +
|-
 +
|Сложный маршрут
 +
|}
 +
|}
  
=== Маршрут «В одну сторону» и «Туда и обратно» ===
+
=== Параметры запроса ===
{| style="width: 800px;" class="wikitable"
+
==== Маршрут «В одну сторону» или «Туда и обратно» ====
 +
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;"
 +
! colspan="3" style="text-align:left;"| Параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
 
|-
 
|-
 
! scope="col" width="300" | Элемент
 
! scope="col" width="300" | Элемент
Строка 145: Строка 216:
 
|}
 
|}
  
==== Дополнительные параметры ====
+
{| 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" | Элемент
Строка 239: Строка 310:
 
| По длительности перелёта
 
| По длительности перелёта
 
|}
 
|}
 
 
|}
 
|}
  
=== Сложный маршрут ===
+
==== Сложный маршрут ====
<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" | Элемент
Строка 333: Строка 400:
 
|}
 
|}
  
=== Пассажиры ===
+
'''[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" | Элемент
Строка 346: Строка 418:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
| width="80" | 1
 
 
| Целое число большее либо равное 0
 
| Целое число большее либо равное 0
 
|}
 
|}
Строка 357: Строка 428:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
| width="80" | 1
 
 
| Целое число большее либо равное 0
 
| Целое число большее либо равное 0
 
|}
 
|}
Строка 368: Строка 438:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
| width="80" | 1
 
 
| Целое число большее либо равное 0
 
| Целое число большее либо равное 0
 
|}
 
|}
Строка 379: Строка 448:
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
 
|-
 
|-
| width="80" | 1
 
 
| Целое число большее либо равное 0
 
| Целое число большее либо равное 0
 
|}
 
|}
Строка 390: Строка 458:
 
{| 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>
 
 
|}
 
|}
  
Строка 402: Строка 468:
 
{| 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 для ссылки доступны следующие переменные:
 +
Параметры в таблице приведены в том порядке, в котором они должны следовать в запросе.
 +
{| class="wikitable" 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
 +
|-
 +
| Валюта  || Трехбуквенный '''код''' валюты (USD, EUR, RUB) || -ccCurrency=USD
 +
|-
 +
| Запуск процесса поиска || Команда. Если параметр не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет || -GO
 +
|-
 +
| Отключение перенаправления || Команда. Позволяет отключить использование перенаправления на другой домен для ссылок в формате FastSearch при включенной настройке [[Раздел_настроек_«Nemo_1.0_(JSON_API)»|"Перенаправлять указанные страницы на другой домен"]]. Если параметр не указан, перенаправление будет осуществляться в соответствии с параметрами настройки "Перенаправлять указанные страницы на другой домен"|| ?noredirect=1
 +
|}
 +
 
 +
'''Примечание.''' Если необходимо передать параметры в форму без дат вылета-прилета, оставив поля дат пустыми, можно вместо конкретных дат подставить 8 нулей, например: /search/MOWMAD00000000ADT1-class=Economy. Тогда пользователь сам выберет дату, а остальные переданные параметры будут заполнены.
 +
 
 +
===Примеры===
 +
{| class="wikitable mw-collapsible mw-collapsed"
 +
| '''Маршрут в одну сторону'''
 +
|-
 +
|
 +
Прямые маршруты эконом класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам.
 +
* '''''Запрос заполняет форму поиска'''''
 +
<pre>http://SITENAME/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy</pre>  
 +
 
 +
* '''''Запрос запускает процесс поиска'''''
 +
<pre>http://SITENAME/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"
 +
| '''Маршрут туда-обратно'''
 +
|-
 +
|
 +
Маршрут бизнес-класса из Москвы в Берлин с вылетом через 10 дней от текущей даты и обратно через 20 дней от текущей даты на двух взрослых.
 +
 
 +
* '''''Запрос заполняет форму поиска'''''
 +
<pre>http://SITENAME/search/MOWBERd10BERMOWd20ADT2-class=Business</pre>
 +
 
 +
* '''''Запрос запускает процесс поиска'''''
 +
<pre>http://SITENAME/search/MOWBER20160218d10BERMOW20160222d20ADT2-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://SITENAME/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1</pre>
 +
 +
* '''''Запрос запускает процесс поиска'''''
 +
<pre>http://SITENAME/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1-GO</pre>
 +
 +
{| class="wikitable"
 +
|-
 +
|[[Файл:FS2сложный маршрут.png]]
 +
|-
 +
| Форма поиска, автоматически заполненная с помощью запроса Fast Search
 +
|}
 
|}
 
|}
  
=== Примеры FastSearch запросов ===
+
== Взаимодействие Fast Search и модуля метрики ==
 +
[[Файл:Источник перехода в служебной информации.png|thumb|250px|right|Отображение источника перехода в служебной информации.]]
 +
<!-- -->
 +
Чтобы зафиксировать источник ссылки, по которой перешел пользователь, необходимо передать в конце запроса дополнительный параметр:
 +
<syntaxhighlight lang="text" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">?utm_source=source_alias</syntaxhighlight>
 +
где '''source_alias''' — алиас источника перехода [[Модуль метрики |модуля метрики]].
  
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
+
Информация об источнике перехода отображается в [[Логи системы|логах]] и на странице заказа в [[Форма бронирования (Авиабилеты)#Интерфейс|служебной информации]].
<u>'''В одну сторону (простой)'''</u>
 
<div class="mw-collapsible-content">
 
'''Рейс в одну сторону из Москвы в Париж, дата вылета: 25.10.2013, без пересадок, 1 взрослый'''
 
* '''''форма поиска'''''
 
<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</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">
+
=== Пример 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, Пассажиры: пожилых - 2, Авиакомпании: Аэрофлот - Российские авиалинии, Международные Авиалинии Украины'''
+
|-
* '''''форма поиска'''''
+
|
<pre>http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013
+
Маршрут в одну сторону без пересадок на одного взрослого из Москвы в Париж с вылетом 25.10.2016 (с учетом источника перехода модуля метрики).
&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">
+
* '''''Запрос заполняет форму поиска'''''
<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://SITENAME/?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, обратно: 27.10.2013, класс перелета: Эконом, Пассажиры: взрослых - 2 младенцев - 1'''
+
</syntaxhighlight>
* '''''форма поиска'''''
 
<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</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://SITENAME/?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
'''из Москвы в Париж, дата вылета 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 и Метрики ==
+
===Пример Fast Search для Frontend 2.0===
Для того, чтобы переход был зарегистрирован системой как переход с определенного источника, необходимо передать в запросе дополнительный параметр utm_source (Metrics Session ID). Например:
+
{| class="wikitable mw-collapsible mw-collapsed"
<pre>http://SITEMANE/?(some_parameters=vals&)utm_source=source_alias</pre>
+
! Запрос Fast Search для Frontend 2.0 с учетом источника перехода модуля метрики
где source_alias - алиас источника переходов. [[Модуль метрики | Дополнительная информация по использованию модуля Метрики]].
+
|-
 +
|
 +
Прямые маршруты эконом-класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам (с учетом источника перехода модуля метрики).
 +
 
 +
* '''''Запрос заполняет форму поиска'''''
 +
<pre>http://SITENAME/search/MOWPAR20160918ADT3INS1CLD2-vicinityDates-class=Economy?ccCurrency=USD&utm_source=source_alias</pre>  
  
=== Пример FastSearch запроса с параметром для модуля Метрики ===
+
* '''''Запрос запускает процесс поиска'''''
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
+
<pre>http://SITENAME/search/MOWPAR20171218ADT1-vicinityDates-class=Economy-GO?ccCurrency=USD&utm_source=source_alias</pre>  
<u>'''FastSearch (с учетом источника перехода для модуля Метрики)'''</u>
+
|}
<div class="mw-collapsible-content">
 
'''Рейс в одну сторону из Москвы в Париж, дата вылета: 25.10.2013, без пересадок, 1 взрослый (с учетом источника перехода для модуля Метрики).'''
 
* '''''форма поиска'''''
 
<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>
 
* '''''процесс поиска'''''
 
<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>
 

Текущая версия на 13:01, 20 августа 2018

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

Назначение

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

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

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

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

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

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

Fast Search для Frontend 1.0

Внимание! Приведенные ниже инструкции актуальны только для старых тем оформления! Для тем оформления, унаследованных от темы wurst, см. подраздел Fast Search для Frontend 2.0 данной статьи!
При использовании Frontend 1.0 ссылка имеет следующий вид:

http://SITENAME/?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

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

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

Примеры

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

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

  • Запрос заполняет форму поиска
http://SITENAME/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on
  • Запрос запускает процесс поиска
http://SITENAME/?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://SITENAME/?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://SITENAME/?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://SITENAME/?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://SITENAME/?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
Валюта Трехбуквенный код валюты (USD, EUR, RUB) -ccCurrency=USD
Запуск процесса поиска Команда. Если параметр не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет -GO
Отключение перенаправления Команда. Позволяет отключить использование перенаправления на другой домен для ссылок в формате FastSearch при включенной настройке "Перенаправлять указанные страницы на другой домен". Если параметр не указан, перенаправление будет осуществляться в соответствии с параметрами настройки "Перенаправлять указанные страницы на другой домен" ?noredirect=1

Примечание. Если необходимо передать параметры в форму без дат вылета-прилета, оставив поля дат пустыми, можно вместо конкретных дат подставить 8 нулей, например: /search/MOWMAD00000000ADT1-class=Economy. Тогда пользователь сам выберет дату, а остальные переданные параметры будут заполнены.

Примеры

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

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

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

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

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

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

  • Запрос заполняет форму поиска
http://SITENAME/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1
  • Запрос запускает процесс поиска
http://SITENAME/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://SITENAME/?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://SITENAME/?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://SITENAME/search/MOWPAR20160918ADT3INS1CLD2-vicinityDates-class=Economy?ccCurrency=USD&utm_source=source_alias
  • Запрос запускает процесс поиска
http://SITENAME/search/MOWPAR20171218ADT1-vicinityDates-class=Economy-GO?ccCurrency=USD&utm_source=source_alias

См. также