4
правки
Изменения
Перейти к навигации
Перейти к поиску
В системе Nemo имеется возможность [[Категория:Плагины (Авиабилеты)]][[Категория:Интеграция]][[Категория:Модули]] [[Категория:Встроенные модули]]<!-- -->FastSearch в {{NameSystem|link}} — функция [http://www.nemo.travel системы онлайн-бронирования {{NameSystem}}], позволяющая перенаправлять пользователей на страницу с уже заполненными параметрами поиска, или же сразу напрямую на результаты актуального поиска.
Эта технология может использоватся к примеру для формирования ссылок с баннеров, при клике на которые пользователь попадает на ==Назначение==Функция автоматически заполняет форму, на которой уже могут быть заполнены пункты назначения, даты, количество пассажиров поиска и прочие параметрызапускает процесс поиска.
После этого можно использовать ссылки на форму поиска видаЗапрос Fast Search состоит из ''параметров'' и их ''значений'', которые в определенном порядке задаются в ссылке.
<pre>http://DOMAIN/?trip_type=OW&out_iata=MOW&in_iata=BER&departure_date=21Fast Search для Frontend 1.10.2009&adults=1&children=0&input_vendors=SU,PS¶m_by_get=on</pre>
== Переменные 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, то для того чтобы отправить пользователя сразу на результаты поиска нужно указать непустой параметр fast_search. Например PS&fast_searchparam_by_get=trueon</pre>
<div style="background-color: rgb(255, 240, 245);"><span style="font-size: large; color: rgb(255, 0, 0); margin-left: 5px;">! </span><span> Следите за тем, чтобы значения соответствовали установленным в настройках ограничениям:</span>* Авиабилеты ⇨ Поиск ⇨ Предустановки поиска* Авиабилеты ⇨ Поиск ⇨ Ограничения поиска</div>Имена переменных аналогичны именам полей на поисковой форме.
Переменные*Значения переменных должны удовлетворять ограничениям из соответствующих настроек формы поиска. Например, если согласно настройкам поиск можно совершать не далее чем на 270 дней вперед, то для FastSearch это ограничение тоже будет действовать.*Рекомендуется не включать в запрос переменные, которые предполагают в качестве значения "''true" можно просто не включать в запрос, '' <!-- чтобы их логика не отработала.-->*Чтобы перенаправить пользователя '''''на форму с заполненными параметрами поиска''''', в конце запроса добавьте get-параметр '''¶m_by_get=on''', иначе сработают стандартные предустановки полей формы поиска.*Чтобы отправить пользователя напрямую '''''на результаты поиска''''', добавьте get-параметр '''&fast_search=on'''.
<span style="font-size: large; color: rgb(255, 0, 0);">! </span><span style="background-color: rgb(255, 240, 245);"> {{Attention|Данные переменные применимы только для сложного маршрута (trip_type==CR).</span>}}
cr_searchcr_iata[8]
cr_back_searchcr_back_iata[8]
|-
| width="80" | all
| Перелет любым классом
| width="80" | 0
| width="80" | 10000| Целое число большее либо равное 0
| width="80" | 1| Целое число большее [1..3]либо равное 0
{| * '''''Запрос запускает процесс поиска'''''<syntaxhighlight lang="text" enclose="div" style="widthfont-size: 257px9pt; heightbackground: 100%#F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: -1px10px 0;" class>http://SITENAME/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2¶m_by_get=on&fast_search="wikitable"|-| widthon&utm_source="80" | 1source_alias| Целое число большее либо равное 0</syntaxhighlight>
{| style="width: 257px; height: 100%; margin* '''''Запрос заполняет форму поиска'''''<pre>http: //SITENAME/search/MOWPAR20160918ADT3INS1CLD2-vicinityDates-1px;" class="wikitable"|-| widthEconomy?ccCurrency=USD&utm_source="80" | 1| Целое число большее либо равное 0|}source_alias</pre>
=== Примеры FastSearch запросов ===
== Взаимодействие FastSearch и Метрики ==
Отмена правки 15015, сделанной Андрей Кизимов (обсуждение)
== Примеры использования ==Формирование ссылок для баннеров или спецпредложений для клиентов, по клику на которые [[пользователь]] попадает на [[Форма поиска (Авиабилеты)|форму поиска]] с уже заполненными полями: пункт вылета и назначения, дата, количество и типы пассажиров и прочие параметры. Также, при указании всех необходимых параметров пользователя по ссылке можно перебрасывать сразу на запускать процесс [[Поиск (Авиабилеты)|поиска авиабилетов с указанными критериями]] по заданным заранее параметрам.
== Принцип работы ==Для использования заполнения формы из URL следует включить Fast Search включите одноименную опцию: Администрирование → Настройки агентства → в разделе настроек '''Управление сайтом → Домены и протоколы → Включить FastSearch Fast Search (передачу параметров поиска)'''.<!--{{Menu|Управление сайтом|Домены и протоколы|Включить Fast Search (передачу параметров поиска)}}.-->
=== Примеры ==={| 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¶m_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¶m_by_get=on&fast_search=on</syntaxhighlight> {| class="wikitable"|-|[[Файл:FS1Маршрут в одну сторону.png]]|-|Маршрут в одну сторону|}|} {| class="wikitable mw-collapsible mw-collapsed" style="width: 800px1000px;"! 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¶m_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¶m_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¶m_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¶m_by_get=on&fast_search=on</syntaxhighlight> {| class="wikitable"|-|[[Файл:FS1сложный маршрут.png]]|-|Сложный маршрут|}|} === Параметры запроса ======= Маршрут «В одну сторону» или «Туда и обратно» ===={| class="wikitablemw-collapsible mw-collapsed" style="width: 800px;"! colspan="3" style="text-align:left;"| Параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
|-
! scope="col" width="300" | Элемент
|-
| Поиск только среди прямых рейсов("Без пересадок")
| direct
| true
|}
{| 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" | Допустимые значения
|-
| Нижнее ограничение по цене по умолчанию
| money_from
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | 0
| Целое число большее либо равное 0
|}
|-
| Верхнее ограничение по цене по умолчанию
| money_to
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | 10000
| Целое число большее 0
|}
|-
| Поиск в окружных датах
| district_date
| true
|-
| Диапазон соседних дат +(-) [дней]
| date_range
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | 1
| Целое число большее [1..3]
|}
|-
| Поиск по соседним аэропортам
| district_airport
| true
|-
| Класс обслуживания
| class
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| econom
| Перелет эконом-классом
|-
| business
| Перелет бизнес-классом
|-
| first
| Перелет первым-классом
|}
|-
| Фильтр по авиакомпании
| input_vendors
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | SU,PS
| Коды авиакомпании ИАТА через запятую без пробелов
|}
|-
| Сортировка
| sort
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | price
| По стоимости
|-
| out_date
| По расписанию
|-
| company
| По авиакомпании
|-
| fltduration
| По длительности перелёта
|}
|}
==== Сложный маршрут ====
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;" class! colspan="4" style="wikitabletext-align:left;"| Параметры запроса для поиска сложного маршрута
|-
! scope="col" width="300" | Элемент
|-
| Пункты вылета
| cr_searchcr_iata[0]<br/>cr_searchcr_iata[1]<br/>
...<br/>
| width="80" | MOW
| Код аэропорта ИАТА
|-
| Пункты прилета
| cr_back_searchcr_back_iata[0]<br/>cr_back_searchcr_back_iata[1]<br/>
...<br/>
| width="80" | LED
| Код аэропорта ИАТА
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| econom
|}
'''[X]''' - номера отдельных перелетов. Нумерация начинается с 0, что означает первый перелет. Максимальное количество сегментов для [[(термин) Сложный маршрут|сложного маршрута]] определяется в разделе Управление продажами → Устаревшие настройки → Ограничения поиска.<!--{{Menu|Управление продажами|Устаревшие настройки|Ограничения поиска}}.--> ==== Дополнительные параметры Пассажиры ===={| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;" class! colspan="3" style="wikitabletext-align:left;"| Параметры указания пассажиров в запросе поиска
|-
! scope="col" width="300" | Элемент
! scope="col" width="250" | Допустимые значения
|-
| Нижнее ограничение по цене по умолчаниюВзрослых от 12 лет| money_fromadults
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| Целое число большее либо равное 0
|}
|-
| Верхнее ограничение по цене по умолчаниюДетей от 2 до 12 лет| money_tochildren
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
|}
|-
| Поиск в окружных датахМладенцев до 2 лет| district_date| true|-| Диапазон соседних дат +(-) [дней]| date_rangeinfants
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
|}
|-
| Поиск по соседним аэропортамМладенцев с местом до 2 лет| district_airport| true|-| Класс обслуживания| classinfants_seat
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | all| Перелет любым классом|-| econom| Перелет эконом-классом|-| business| Перелет бизнес-классом|-| first| Перелет первым классомЦелое число большее либо равное 0
|}
|-
| Выбрать туда и обратно отдельно Молодых от 12 до 24 лет <br/>| separate| true|-| Фильтр по авиакомпании | preferable| true|-| Фильтр по авиакомпании | input_vendorsyouths| style="padding: 0;" | Коды авиакомпании ИАТА
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | price| По стоимостиЦелое число большее либо равное 0
|}
|-
| СортировкаПожилых от 65 лет| sortseniors
| style="padding: 0;" |
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | price| По стоимости|-| out_date| По расписанию|-| company| По авиакомпании|-| fltduration| По длительности перелётаЦелое число большее либо равное 0
|}
|}
==Fast Search для Frontend 2.0= Пассажиры = === Параметры запроса ===При использовании Frontend 2.0 для ссылки доступны следующие переменные:Параметры в таблице приведены в том порядке, в котором они должны следовать в запросе.{| class="wikitable" style="width: 800px;"! colspan=" class3" style="wikitabletext-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"
| '''Маршрут в одну сторону'''
|-
| Взрослых от 12 лет| adultsПрямые маршруты эконом класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам.| style* '''''Запрос заполняет форму поиска'''''<pre>http://SITENAME/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class="paddingEconomy</pre> * '''''Запрос запускает процесс поиска'''''<pre>http: 0;" |//SITENAME/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy-GO</pre>
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"|-|[[Файл:FS2Маршрут в одну сторону.png]]
|-
| width="80" | 1| Целое число большее либо равное 0Форма поиска, автоматически заполненная с помощью запроса Fast Search
|}
{| class="wikitable"
|-
| Детей от 2 до 12 лет| children| style="padding[[Файл: 0;" | {| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"FS2Маршрут в одну сторону. Пассажиры.png]]
|-
| width="80" | 1Форма пассажиров, автоматически заполненная с помощью запроса Fast Search| Целое число большее либо равное 0}
|}
{| class="wikitable mw-collapsible mw-collapsed"
| '''Маршрут туда-обратно'''
|-
| Младенцев до 2 лет| infantsМаршрут бизнес-класса из Москвы в Берлин с вылетом через 10 дней от текущей даты и обратно через 20 дней от текущей даты на двух взрослых.| style* '''''Запрос заполняет форму поиска'''''<pre>http://SITENAME/search/MOWBERd10BERMOWd20ADT2-class="paddingBusiness</pre> * '''''Запрос запускает процесс поиска'''''<pre>http: 0;" |//SITENAME/search/MOWBER20160218d10BERMOW20160222d20ADT2-class=Business-GO</pre>
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"|-|[[Файл:FS2Маршрут туда-обратно.png]]
|-
| width="80" | 1Форма поиска, автоматически заполненная с помощью запроса Fast Search| Целое число большее либо равное 0}
|}
{| class="wikitable mw-collapsible mw-collapsed"
| '''Сложный маршрут'''
|-
| Младенцев Маршрут из Киева в Пешевар с вылетом 10.07.2016, из Пешевара в Москву с вылетом 18.07.2016, из Москвы в Париж, с местом до 2 летвылетом 19.07.2016 на одного взрослого. * '''''Запрос заполняет форму поиска'''''<pre>http://SITENAME/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1</pre> | infants_seat* '''''Запрос запускает процесс поиска'''''| style="padding<pre>http: 0;" |//SITENAME/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1-GO</pre>
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"|-|[[Файл:FS2сложный маршрут.png]]
|-
| width="80" | 1Форма поиска, автоматически заполненная с помощью запроса Fast Search| Целое число большее либо равное 0}
|}
== Взаимодействие 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''' — алиас источника перехода [[Модуль метрики |модуля метрики]].
Информация об источнике перехода отображается в [[Логи системы|логах]] и на странице заказа в [[Форма бронирования (Авиабилеты)#Интерфейс|служебной информации]].
=== Пример Fast Search для Frontend 1.0 ===
{| class="wikitable mw-collapsible mw-collapsed"
! style="text-align:left;"| Запрос Fast Search для Frontend 1.0 с учетом источника перехода модуля метрики
|-
| Молодых от 12 до 24 лет | youthsМаршрут в одну сторону без пересадок на одного взрослого из Москвы в Париж с вылетом 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¶m_by_get=on&utm_source=source_alias</syntaxhighlight>
|}
===Пример Fast Search для Frontend 2.0===
{| class="wikitable mw-collapsible mw-collapsed"
! Запрос Fast Search для Frontend 2.0 с учетом источника перехода модуля метрики
|-
| Пожилых от 65 лет| seniors| style="padding: 0;" |Прямые маршруты эконом-класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам (с учетом источника перехода модуля метрики).
* '''''Запрос запускает процесс поиска'''''
<pre>http://SITENAME/search/MOWPAR20171218ADT1-vicinityDates-class=Economy-GO?ccCurrency=USD&utm_source=source_alias</pre>
|}
== См. также ==
*[[Fast Search для отелейПоиск (Авиабилеты)]]*[[Тип маршрута]]
*[[Модуль метрики]]
*[[ИнтеграцияФорма поиска (Авиабилеты)]] [[Категория:Функции]]<br>