Изменения

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

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

7033 байта добавлено, 10:52, 18 марта 2016
Нет описания правки
[[Категория:Плагины (Авиабилеты)]][[Категория:API (Авиабилеты)]]<!-- -->FastSearch в {{ContractNameSystem|link}}В системе Nemo имеется возможность — функция, позволяющая перенаправлять пользователей на страницу с уже заполненными параметрами поиска или сразу напрямую на результаты поиска.
== Применение Назначение==Эта технология может использоватся к примеру для формирования ссылок с баннеров, при клике на которые пользователь попадает на Функция автоматически заполняет форму, на которой уже могут быть заполнены пункты назначения, даты, количество пассажиров поиска и прочие параметрызапускает процесс поиска.
Также== Примеры использования ==Формирование ссылок для баннеров, при указании всех необходимых параметровщелчке на которые [[пользователь]] попадает на [[Форма поиска (Авиабилеты)|форму поиска]] с заполненными полями: пункт вылета и назначения, дата, пользователя количество и типы пассажиров и прочие параметры. Так же по ссылке можно перебрасывать сразу на запускать процесс [[Поиск (Авиабилеты)|поиска авиабилетов с указанными критериями]].
== Принцип работы ==Для использования заполнения формы из URL следует включить Fast Search включите опцию: '''Администрирование''' → '''Настройки системы''' → '''''{{Menu|Управление сайтом|Домены и протоколы|Включить FastSearch 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>
При использовании Frontend 2Имена переменных аналогичны именам полей на поисковой форме.0 необходимо передавать ссылку в следующем виде:<pre>http://SITEMANE/search/IEVPEW20150718PEWMOW20150710ADT3INS1CLD2-direct-vicinityDates-class=Business-GO</pre>
Или:*Значения переменных должны удовлетворять ограничениям параметров настройки.*Рекомендуется не включать в запрос переменные, которые предполагают в качестве значения ''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* '''''Запрос заполняет форму поиска'''''<presyntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">http://SITEMANE/search?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on</MOWPARd3PARMOWd10ADT1syntaxhighlight>* '''''Запрос запускает процесс поиска'''''<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-class=Business-GOtrue&adults=2&param_by_get=on&fast_search=on</presyntaxhighlight>Где:
{| class="wikitable"|- IEV, PEW |[[Файл:FS1Маршрут в одну сторону.png]]|-IATA коды пунктов вылета/прилета|Маршрут в одну сторону|}|}
{| class="wikitable mw- 20150718 collapsible mw- дата в формате YYYYcollapsed" style="width: 1000px;"! style="text-MMalign:left;"| Маршрут туда-DDобратно|-|Маршрут туда-обратно Москва - Париж - Москва эконом-классом на двух взрослых людей и младенца* '''''Запрос заполняет форму поиска'''''<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>
{| class="wikitable"|- d3,d10 |[[Файл:FS1Маршрут туда- дата в формате dXX, где XX это величина смещения относительно текущей датыобратно.png]]|-|Маршрут туда-обратно|}|}
{| class="wikitable mw- ADT 3 INS 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 CLD ]=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>
{| class="wikitable"|- direct |[[Файл:FS1сложный маршрут.png]]|- прямые рейсы|Сложный маршрут|}|}
- vicinityDates - включение поиска по окружным датам - class=Business - выбор класса - GO - параметр для запуска поиска (в случае, если параметр не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет) == Переменные FastSearch ==Имена полей - такие же как имена инпутов на поисковой форме. Следите за тем, чтобы значения соответствовали установленным в настройках ограничениям. Переменные, которые предполагают в качестве значения "true" можно просто не включать в запрос, чтобы их логика не отработала. ==Параметры запроса = Форма поиска ===Чтобы перенаправить пользователя на страницу с заполненными параметрами поиска, необходимо указать get-параметр '''&param_by_get=on''', иначе сработают стандартные предустановки полей формы поиска. === Процесс поиска ===Если вы указываете все необходимые для поиска параметры, то для того чтобы отправить пользователя сразу на результаты поиска, нужно указать get-параметр '''&fast_search=on'''. === Маршрут «В одну сторону» и или «Туда и обратно» ===={| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;" class! colspan="3" style="wikitabletext-align:left;"| Параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
|-
! scope="col" width="300" | Элемент
|}
==== Дополнительные параметры ===={| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;" class! colspan="3" style="wikitabletext-align:left;"| Дополнительные параметры запроса для поиска маршрутов «В одну сторону» и «Туда и обратно»
|-
! scope="col" width="300" | Элемент
| По длительности перелёта
|}
 
|}
==== Сложный маршрут ====<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|} |} ==Fast Search для Frontend 2.0==При использовании Frontend 2.0 ссылка имеет следующий вид:<pre>http://SITEMANE/search/IEVMOW20160218MOWIEV20160420ADT3INS1CLD2-direct-vicinityDates-class=Business-GO<br/pre><span style="font-sizeгде: large; color: rgb* '''IEV, PEW''' — [[Международная ассоциация воздушного транспорта|IATA]] коды пунктов вылета/прилета* '''20160420''' — дата вылета в формате ГГГММДД* '''ADT 3 INS 1 CLD 2''' — типы [[Пассажир|пассажиров]] и их количество* '''direct''' — прямые рейсы* '''icinityDates''' — включить [[Поиск по окружным датам (255Авиабилеты)|поиск по окружным датам]]* '''class=Business''' — выбор [[Класс обслуживания|класса]]* '''GO''' — параметр для запуска поиска. Если он не указан, 0параметры будут подставлены в форму поиска, 0);но поиск запущен не будет ===Примеры==={| class="wikitable mw-collapsible mw-collapsed"| '''Маршрут в одну сторону'''|-|Прямые маршруты эконом класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам.* '''''Запрос заполняет форму поиска'''''<pre>!&nbsp;http://SITEMANE/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy</spanpre* '''''Запрос запускает процесс поиска'''''<span stylepre>http://SITEMANE/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy-GO</pre> {| class="wikitable"|-|[[Файл:FS2Маршрут в одну сторону.png]]|-| Форма поиска автоматически заполненная с помощью запроса Fast Search|} {| class="backgroundwikitable"|-color|[[Файл: rgb(255, 240, 245);FS2Маршрут в одну сторону. Пассажиры.png]]|-| Форма пассажиров автоматически заполненная с помощью запроса Fast Search|}|} {| class="wikitable mw-collapsible mw-collapsed">&nbsp;Данный параметр доступен только | '''Маршрут туда-обратно'''|-|Маршрут бизнес класса из Москвы в новой базовой темеБерлин с вылетом 18.02.2016 и обратно 22.02.2016 на двух взрослых. * '''''Запрос заполняет форму поиска'''''<pre>http://SITEMANE/search/MOWBER20160218BERMOW20160222ADT2-class=Business</spanpre* '''''Запрос запускает процесс поиска'''''<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Взаимодействие Fast Search и модуля метрики ==[[Файл:800px">Источник перехода в служебной информации.png|thumb|250px|right|Отображение источника перехода в служебной информации.]]<u>'''В одну сторону (простой)'''</u><div class="mw!-- -collapsible-content">'''Рейс в одну сторону из Москвы Чтобы зафиксировать источник ссылки, по которой перешел пользователь, необходимо передать в Париж, дата вылетаконце запроса дополнительный параметр: 25.10.2013, без пересадок, 1 взрослый'''* '''''форма поиска'''''<pre>http://SITEMANE/?trip_typesyntaxhighlight lang=OW&out_iata"text" style=MOW&in_iata=PAR&departure_date=25.10.2013&direct=true&adults=2"font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">&param_by_getutm_source=onsource_alias</presyntaxhighlight>* ''''где 'процесс поиска''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</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 === Пример Fast Search для Frontend 1.0 ==={| class="toccolours wikitable mw-collapsible mw-collapsed" ! style="widthtext-align:800pxleft;">| Запрос Fast Search для Frontend 1.0 с учетом источника перехода модуля метрики<u>'''Туда|-обратно'''</u><div class="mw-collapsible-content">|'''Рейсы туда-обратно Москва ↔ Маршрут в одну сторону без пересадок на одного взрослого из Москвы в Париж, дата вылета: 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&back_departure_date=27.102016 (с учетом источника перехода модуля метрики).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><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://SITEMANE/?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_searchutm_source=on</pre>source_alias</div></divsyntaxhighlight>
* '''''Запрос запускает процесс поиска'''''<syntaxhighlight lang="text" enclose= Взаимодействие FastSearch и Метрики "div" style==Для того, чтобы переход был зарегистрирован системой как переход с определенного источника, необходимо передать в запросе дополнительный параметр utm_source (Metrics Session ID). Например"font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin:10px 0;"><pre>http://SITEMANE/?(some_parameterstrip_type=valsOW&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</presyntaxhighlight>где source_alias - алиас источника переходов. [[Модуль метрики | Дополнительная информация по использованию модуля Метрики]].}
=== Пример FastSearch запроса с параметром Fast Search для модуля Метрики Frontend 2.0===<div {| class="toccolours wikitable mw-collapsible mw-collapsed" style="width:800px"><u>'''FastSearch (! Запрос Fast Search для Frontend 2.0 с учетом источника перехода для модуля Метрики)'''</u>метрики<div class="mw|-collapsible-content">'''Рейс |Прямые маршруты эконом класса в одну сторону из Москвы в Париж, дата вылета: 25с вылетом 18.1002.20132016 на трех взрослых, без пересадок, 1 взрослый двух детей и одного младенца с местом с поиском по окружным датам (с учетом источника перехода для модуля Метрикиметрики).''' * '''''форма Запрос заполняет форму поиска'''''<pre>http://SITEMANE/?trip_type=OW&out_iata=MOW&in_iatasearch/MOWPAR20160218ADT3INS1CLD2-vicinityDates-class=PAR&departure_date=25.10.2013&direct=true&adults=2&param_by_get=onEconomy&utm_source=source_alias</pre> * '''''Запрос запускает процесс поиска'''''<pre>http://SITEMANE/?trip_typesearch/MOWPAR20160218ADT3INS1CLD2-vicinityDates-class=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2013&direct=true&adults=2&param_by_get=on&fast_search=onEconomy-GO&utm_source=source_alias</pre></div></div>|}
== См. также ==
*[[Fast Search для отелейПоиск (Авиабилеты)]]*[[Маршрут]]
*[[Модуль метрики]]
*[[Интеграция]]
 
[[Категория:Функции]]<br>

Навигация

'