Изменения

Перейти к навигации Перейти к поиску

FastSearch — передача параметров в форму поиска

10 184 байта добавлено, 13:01, 20 августа 2018
Отмена правки 15015, сделанной Андрей Кизимов (обсуждение)
[[Категория:Плагины (Авиабилеты)]][[Категория:Интеграция]][[Категория:Модули]] [[Категория:Встроенные модули]]<!-- -->FastSearch в {{ContractNameSystem|link}}В системе Nemo имеется возможность — функция [http://www.nemo.travel системы онлайн-бронирования {{NameSystem}}], позволяющая перенаправлять пользователей на страницу с уже заполненными параметрами поиска или сразу напрямую на результаты актуального поиска.
== Применение Назначение==Эта технология может использоватся к примеру для формирования ссылок с баннеров, при клике на которые пользователь попадает на Функция автоматически заполняет форму, на которой уже могут быть заполнены пункты назначения, даты, количество пассажиров поиска и прочие параметрызапускает процесс поиска.
Также== Примеры использования ==Формирование ссылок для баннеров или спецпредложений для клиентов, по клику на которые [[пользователь]] попадает на [[Форма поиска (Авиабилеты)|форму поиска]] с уже заполненными полями: пункт вылета и назначения, при указании всех необходимых параметровдата, пользователя количество и типы пассажиров и прочие параметры. Также по ссылке можно перебрасывать сразу на запускать процесс [[Поиск (Авиабилеты)|поиска авиабилетов с указанными критериями]] по заданным заранее параметрам.
== Принцип работы ==Для использования заполнения формы из URL следует включить Fast Search включите одноименную опцию: '''Администрированиев разделе настроек ''' Управление сайтом '''Настройки агентства''' Домены и протоколы Включить Fast Search (передачу параметров поиска)'''''.<!--{{Menu|Управление сайтом|Домены и протоколы|Включить FastSearch Fast Search (передачу параметров поиска)'''''}}.-->
После этого можно использовать ссылки на форму поиска видаЗапрос Fast Search состоит из ''параметров'' и их ''значений'', которые в определенном порядке задаются в ссылке.
<pre>http://SITEMANE/?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&param_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, чтобы значения соответствовали установленным в настройках ограничениям.PS&param_by_get=on</pre>
Переменные, которые предполагают в качестве значения "true" можно просто не включать в запрос, чтобы их логика не отработалаИмена переменных аналогичны именам полей на поисковой форме.
=== Форма *Значения переменных должны удовлетворять ограничениям из соответствующих настроек формы поиска ===. Например, если согласно настройкам поиск можно совершать не далее чем на 270 дней вперед, то для FastSearch это ограничение тоже будет действовать.*Рекомендуется не включать в запрос переменные, которые предполагают в качестве значения ''true'' <!-- чтобы их логика не отработала.-->*Чтобы перенаправить пользователя '''''на страницу форму с заполненными параметрами поиска''''', необходимо указать в конце запроса добавьте get-параметр '''&param_by_get=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, нужно указать getиз Санкт-параметр Петербурга в Москву, с вылетом 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&fast_searchcr_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]]|-|Сложный маршрут|}|} === Параметры запроса ======= Маршрут «В одну сторону» и или «Туда и обратно» ===={| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;" class! colspan="3" style="wikitabletext-align:left;"| Параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
|-
! scope="col" width="300" | Элемент
|-
| Поиск только среди прямых рейсов("Без пересадок")
| direct
| true
|}
==== Дополнительные параметры ===={| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;" class! colspan="3" style="wikitabletext-align:left;"| Дополнительные параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
|-
! scope="col" width="300" | Элемент
|-
| first
| Перелет первым -классом
|}
|-
| Выбрать туда и обратно отдельно
| separate
| true
|-
| Фильтр по авиакомпании
| По длительности перелёта
|}
 
|}
==== Сложный маршрут ====<span style="font-size: large; color: rgb(255, 0, 0);">!&nbsp;</span><span style="background-color: rgb(255, 240, 245);">&nbsp;{{Attention|Данные переменные применимы только для сложного маршрута ('''trip_type=&#61;CR''').</span> '''[X]''' - номера отдельных перелетов. Нумерация начинается с 0, что означает первый перелет.  Максимальное количество сегментов для сложного маршрута определяется одноименной настройкой в разделе '''Авиабилеты ⇨ Поиск ⇨ Ограничения поиска'''. }}
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;" class! colspan="4" style="wikitabletext-align:left;"| Параметры запроса для поиска сложного маршрута
|-
! scope="col" width="300" | Элемент
|}
'''[X]''' - номера отдельных перелетов. Нумерация начинается с 0, что означает первый перелет. Максимальное количество сегментов для [[(термин) Сложный маршрут|сложного маршрута]] определяется в разделе Управление продажами → Устаревшие настройки → Ограничения поиска.<!--{{Menu|Управление продажами|Устаревшие настройки|Ограничения поиска}}.--> ==== Пассажиры ===={| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;" class! colspan="3" style="wikitabletext-align:left;"| Параметры указания пассажиров в запросе поиска
|-
! scope="col" width="300" | Элемент
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | 1
| Целое число большее либо равное 0
|}
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | 1
| Целое число большее либо равное 0
|}
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | 1
| Целое число большее либо равное 0
|}
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | 1
| Целое число большее либо равное 0
|}
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | 1| Целое число большее либо равное 0<br/><span style="font-size: large; color: rgb(255, 0, 0);">!&nbsp;</span><span style="background-color: rgb(255, 240, 245);">&nbsp;Данный параметр доступен только в новой базовой теме.</span>
|}
{| style="width: 257px; height: 100%; margin: -1px;" class="wikitable"
|-
| width="80" | 1| Целое число большее либо равное 0<br/><span |} |} ==Fast Search для Frontend 2.0== === Параметры запроса ===При использовании Frontend 2.0 для ссылки доступны следующие переменные:Параметры в таблице приведены в том порядке, в котором они должны следовать в запросе.{| class="wikitable" style="width: 800px;"! colspan="3" style="fonttext-sizealign: largeleft; color: rgb"| Параметры указания пассажиров в запросе поиска|-! 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 |- | Валюта || Трехбуквенный '''код''' валюты (255USD, EUR, RUB) || -ccCurrency=USD |- | Запуск процесса поиска || Команда. Если параметр не указан, 0параметры будут подставлены в форму поиска, 0но поиск запущен не будет || -GO |- | Отключение перенаправления || Команда. Позволяет отключить использование перенаправления на другой домен для ссылок в формате FastSearch при включенной настройке [[Раздел_настроек_«Nemo_1.0_(JSON_API);»|"Перенаправлять указанные страницы на другой домен"]]. Если параметр не указан, перенаправление будет осуществляться в соответствии с параметрами настройки "Перенаправлять указанные страницы на другой домен"|| ?noredirect=1 |} '''Примечание.''' Если необходимо передать параметры в форму без дат вылета-прилета, оставив поля дат пустыми, можно вместо конкретных дат подставить 8 нулей, например: /search/MOWMAD00000000ADT1-class=Economy. Тогда пользователь сам выберет дату, а остальные переданные параметры будут заполнены. ===Примеры==={| class="wikitable mw-collapsible mw-collapsed"| '''Маршрут в одну сторону'''|-|Прямые маршруты эконом класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам.* '''''Запрос заполняет форму поиска'''''<pre>!&nbsp;http://SITENAME/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy</spanpre* '''''Запрос запускает процесс поиска'''''<span stylepre>http://SITENAME/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy-GO</pre> {| class="backgroundwikitable"|-color|[[Файл: rgb(255FS2Маршрут в одну сторону.png]]|-| Форма поиска, 240автоматически заполненная с помощью запроса Fast Search|} {| class="wikitable"|-|[[Файл:FS2Маршрут в одну сторону. Пассажиры.png]]|-| Форма пассажиров, 245);автоматически заполненная с помощью запроса Fast Search|}|} {| class="wikitable mw-collapsible mw-collapsed">&nbsp;Данный параметр доступен только | '''Маршрут туда-обратно'''|-|Маршрут бизнес-класса из Москвы в новой базовой темеБерлин с вылетом через 10 дней от текущей даты и обратно через 20 дней от текущей даты на двух взрослых* '''''Запрос заполняет форму поиска'''''<pre>http://SITENAME/search/MOWBERd10BERMOWd20ADT2-class=Business</spanpre>  * '''''Запрос запускает процесс поиска'''''<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
|}
|}
==Взаимодействие Fast Search и модуля метрики = Примеры FastSearch запросов =[[Файл:Источник перехода в служебной информации.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 === Пример Fast Search для Frontend 1.0 ==={| class="toccolours wikitable mw-collapsible mw-collapsed" ! style="widthtext-align:800pxleft;"><u>'''В одну сторону (| Запрос Fast Search для Frontend 1.0 с фильтрами по авиакомпаниям)'''</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.102016 (с учетом источника перехода модуля метрики).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 class" style="mwfont-collapsible-content">'''Рейсы туда-обратно Москва ↔ Париж, дата вылетаsize: 25.10.2013, обратно9pt;background: 27.10.2013, класс перелета#F9F9F9; border: Эконом, Пассажиры1px dashed #2F6FAB; padding: взрослых - 2 младенцев - 1'''* '''''форма поиска'''''<pre>http10px 5px; margin://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</pre10px 0;">* '''''процесс поиска'''''<pre>http://SITEMANESITENAME/?trip_type=RTOW&out_iata=MOW&in_iata=PAR&departure_date=25.10.20132016&back_departure_datedirect=27.10.2013&class=economtrue&adults=2&infants=1&param_by_get=on&fast_searchutm_source=on</pre>source_alias</div></divsyntaxhighlight>
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px"><u>'''Сложный маршрут'''</u><div class="mw-collapsible-content">'''из Москвы в Париж, дата вылета 25.10.2013,'''<br/>'''из Парижа в Санкт-Петербург, дата вылета 26.10.2013,'''<br/>'''из Санкт-Петербурга в Москву, дата вылета 29.10.2013,'''<br/>'''1 взрослый'''* '''''форма Запрос запускает процесс поиска'''''<pre>http://SITEMANE/?trip_typesyntaxhighlight lang=CR&cr_iata[0]"text" enclose=MOW&cr_back_iata[0]"div" style=PAR&cr_date["font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 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://SITEMANESITENAME/?trip_type=CROW&cr_iata[0]out_iata=MOW&cr_back_iata[0]in_iata=PAR&cr_date[0]departure_date=25.10.20132016&cr_iata[1]direct=PARtrue&cr_back_iata[1]=LED&cr_date[1]=26.10.2013&cr_iata[2]adults=LED&cr_back_iata[2]=MOW&cr_date[2]=29.10.2013&adults=1&param_by_get=on&fast_search=on</pre>&utm_source=source_alias</divsyntaxhighlight></div>|}
== Взаимодействие FastSearch и Метрики =Пример Fast Search для Frontend 2.0==={| class="wikitable mw-collapsible mw-collapsed"Для того, чтобы переход был зарегистрирован системой как переход ! Запрос Fast Search для Frontend 2.0 с определенного учетом источникаперехода модуля метрики|-|Прямые маршруты эконом-класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, необходимо передать в запросе дополнительный параметр utm_source двух детей и одного младенца с местом с поиском по окружным датам (Metrics Session IDс учетом источника перехода модуля метрики). Например: * '''''Запрос заполняет форму поиска'''''<pre>http://SITEMANESITENAME/search/MOWPAR20160918ADT3INS1CLD2-vicinityDates-class=Economy?(some_parametersccCurrency=valsUSD&)utm_source=source_alias</pre>где source_alias - алиас источника переходов. [[Модуль метрики | Дополнительная информация по использованию модуля Метрики]].
=== Пример FastSearch запроса с параметром для модуля Метрики ===<div class="toccolours mw-collapsible mw-collapsed" style="width:800px"><u>'''FastSearch (с учетом источника перехода для модуля Метрики)'''</u><div class="mw-collapsible-content">'''Рейс в одну сторону из Москвы в Париж, дата вылета: 25.10.2013, без пересадок, 1 взрослый (с учетом источника перехода для модуля Метрики).'''* '''''форма Запрос запускает процесс поиска'''''<pre>http://SITEMANESITENAME/search/?trip_typeMOWPAR20171218ADT1-vicinityDates-class=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/Economy-GO?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013&direct=true&adults=2&param_by_get=on&fast_searchccCurrency=onUSD&utm_source=source_alias</pre></div></div>|}
== См. также ==
*[[Fast Search для отелейПоиск (Авиабилеты)]]*[[Тип маршрута]]
*[[Модуль метрики]]
*[[ИнтеграцияФорма поиска (Авиабилеты)]] [[Категория:Функции]]<br>

Навигация

'