Открыть главное меню

Изменения

Взаимодействие с метапоисковиками

13 214 байт добавлено, 12:48, 19 апреля 2021
Статистика продаж
'''Метапоисковая система''' (метапоисковая машина, метапоисковик) — это поисковая система, которая в отличие от классических поисковых машин не имеет собственной базы данных и собственного поискового индекса, а формирует поисковую выдачу за счет смешивания и переранжирования результатов поиска других поисковых систем.
 
Необходимо убедиться, что API запросы на поиск отправляются на доменное имя, указанное для агентства (субагента) в разделе «Управление сайтом» → «Домены и протоколы».
 
== Условия подключения и использования модуля ==
 
Агентство может использовать данный модуль системы {{NameSystem}}, только если выполняются следующие условия:
 
* используется только коннектор к {{NameProject2}};
* в разделе настроек «Управление продажами» → «Авиабилеты» → «Процессы» → «Процесс поиска» → «Тонкая настройка» для АПИ-пользователя метапоиска включена настройка {{Setting|Объединение поисков для {{NameProject2}}}};
* для метапоиска настроены фильтры запросов;
* для АПИ-пользователя в разделе «Управление продажами» → «Авиабилеты» → «Устаревшие настройки» → «Ограничение поиска» отключена отправка параллельных запросов на дополнительные классы перелетов (эконом-премиум и первый);
* максимальное число ценовых правил, заведенных на каждую авиакомпанию — не более 100;
* предельный look-to-book (конверсия) для метапоиска - 3000:1.
 
Данные ограничения объясняются необходимостью контролировать нагрузку на сервер. Если какие-либо условия из этого списка не выполняются, администраторы {{NameSystem}} вправе отключить модуль взаимодействия с метапоиском для агента.
== Настройка ==
Для агентства должен быть включен модуль '''«Взаимодействие {{Setting|Взаимодействие с метапоисковиками»'''метапоисковиками}}, тогда:* становится доступным раздел '''«Статистика Статистика и отчеты → Статистика заказов из метапоисков»''' в разделе '''«Администрирование»''' → '''«Логи и статистика»метапоисков''';* появляется настройка '''''«Источник метрики»''''' {{Setting|Источник метрики}} (показывается только для пользователей внутри агентства/субагентства) в разделе '''«Управление продажами» → «Авиабилеты»''' '''«Стандартный поиск»''' «Процессы» '''«Настройки»'''«Форма поиска»{{Attention|При изменении алиаса в разделе «Статистика и отчеты» → «Метрика» → «Источники переходов», необходимо проверить настройку «Источник метрики», определен ли источник, так как эта настройка может слететь.}} * появляются настройки '''''«Время {{Setting|Время жизни cookie (дней)»'''''}}, '''''«Продлевать {{Setting|Продлевать время жизни cookie при следующем заходе пользователя»''''' '''''«Прибыль пользователя}}, {{Setting|Прибыль метапоисковика(процент)»''''' }} в разделе «Статистика и отчеты» → «Метрика» → «Источники переходов»;* в личном кабинете открывается новый фильтр по заказам '''«Метрика »''«Источник перехода»' '''«Источники трафика»''', подробнее [[Личный кабинет#Фильтр заказов | «Личный кабинет. Фильтр заказов»]].
В список '''''«Источник метрики»''''' {{Setting|Источник метрики}} подгружаются источники, настроенные в модуле метрики в '''«Источниках «Источники переходов»'''. Если ни одного источника не настроено, то поле {{Setting|Источник метрики}} будет скрыто. Если задана настройка {{Setting|Источник метрики}}, то запускается механизм управления HTTP cookie пользователей, приходящих с сайта метапоиска. Если модуль {{Setting|Взаимодействие с метапоисковиками}} отключен, то HTTP cookie не сохраняются. Если источник перехода выключен в модуле метрики, то статистика метапоиска все равно считается, но в этом случае данные статистики метапоиска и модуля метрики будут различными. В целом возможно расхождение данных статистики метапоиска и модуля метрики, так как это два различных модуля. Через настройку {{Setting|Источник метрики}} («Управление продажами» → «Авиабилеты» → «Процессы» → «Форма поиска») источник переходов модуля метрики привязывается к конкретному пользователю, для которого настроены API {{NameSystem}}. === Фильтры запросов поиска ===При взаимодействии с метапоисковыми системами требуется настраивать [[Поиск_2.0#Фильтры запросов | фильтры запросов поиска]], чтобы:* оставить для поиска самые выгодные направления,* увеличить конверсию «Look To Book»,* ограничить нежелательные запросы к GDS (экономия транзакций), <!-- * исключить из поиска не поддерживаемые направления, то есть направления, по которым заведомо будут отсутствовать результаты поиска -->* уменьшить нагрузку на сервер.  === Источник метрики ===Подробная информация об источниках переходов модуля метрики находится в соответствующей статье [[Модуль метрики#Создание источника переходов | «Модуль метрики. Создание источника переходов»]]. Параметры источников переходов, связанные со статистикой метапоисков описаны ниже. === Дополнительные параметры источника переходов ===* {{Setting|Время жизни cookie (дней)}} — срок действия HTTP cookie, в течение которого {{NameSystem}} запоминает пользователя, пришедшего с метапоиска. В случае отсутствия заданного значения настройки «Время жизни cookie (дней)», либо если оно равно 0, то время жизни cookie проставляется в 1 час.* {{Setting|Продлевать время жизни cookie при следующем заходе пользователя}} — если опция включена, то HTTP cookie продлеваются с каждым последующим переходом на бронирование.* {{Setting|Прибыль метапоисковика (процент)}} — считается как процент от стоимости оплаченного заказа, включая комиссию платежного шлюза, исключая дополнительные услуги (апесейл). Используется только в отчетах статистики метапоиска и не изменяет итоговую стоимость заказа. === Сборы ===Модуль '''«Ценообразование 2.0»''«Источник метрики»''''' будет скрытопозволяет задать ценовое правило для источника перехода на основе параметра <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">utm_source</syntaxhighlight>. В качестве значения необходимо указывать идентификатор источника перехода, который отображается в поле {{Setting|№}} таблицы источников переходов. == Статистика заказов из метапоисков ==[[Файл:Статистика_заказов_из_метапоисков.png|400px|thumb|right|Статистика заказов из метапоисков]]В данном разделе можно получить данные по статистике метапоиска (по источнику переходов модуля метрики) <u>за определенный период бронирования заказов</u> в виде файла данных в формате XML. Доступ к разделу имеет менеджер головного агентства. Можно получить статистику метапоиска как для агентства, так и для субагентств. Для получения данных необходимо заполнить поля:* {{Setting|Источник метрики}} — один из источников, настроенных в «Источниках переходов» модуля метрики;* {{Setting|Дата с}} — начало периода бронирований;* {{Setting|Дата по}} — окончание периода бронирований.
== Поддержка метапоисковиков ==
=== Aviasales.ru ===
[[Файл:Aviasales.ru.png|right50px|left]]
Первый и крупнейший в Рунете метапоиск дешевых авиабилетов. Производит поиск авиабилетов в 728 авиакомпаниях, 40 авиакассах и 5 системах бронирования (GDS), используя наиболее современные технологии.
==== Принципы работы с метапоисковиком ====
===== API Авиа =====В Nemo реализовано два интерфейса (согласно требованиям AviaSales.ru):* '''''Запрос вариантов перелета с ценами''''' - использует [[Агентский АПИ | агентский API Nemo]] для поиска авиабилетов.* '''''Статистика продаж''''' - реализована на базе [[Модуль метрики | Модуля метрики Nemo]]рекомендует устанавливать срок действия HTTP cookie в 30 дней.
====== Запрос вариантов перелета Для покупки билетов пользователь будет перенаправлен с ценами ======метапоиска на сайт для бронирования заказа. Для отслеживания продаж и привязывания к посетителям может передаваться дополнительный GET параметр marker.
Пример запроса<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: Маркер, переданный при переходе на бронирование, является частью информации о бронировании в статистике, и напрямую связан с параметром [[Модуль метрики#F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">http://host/api/search?from=MOW&to=LED&date1=2012-09-25&date2=2012-10-01&adults=2&children=1&infants=1&cabin=Y&partner=avsl&password=passМаркер | marker]] из модуля метрики.</syntaxhighlight>
Параметры запроса{| style="width: 800px" class="wikitable"|-! scope="col" | Параметр запроса! scope="col" | Описание|-| from| IATA код пункта отправления.|-| to| IATA пункта назначения.|-| date1| YYYY-MM-DD дата вылета.|-| date2| YYYY-MM-DD дата возвращения. Для перелётов в одну сторону не передаётся.|-| adults| Количество взрослых пассажиров.|-| children| Количество пассажиров детей от 2 до 12 лет.|-| infants| Количество пассажиров детей до 2х лет.|-| cabin| Класс перелёта. "Y" - эконом , "C" - бизнес, "F" - первый.|-| partner| Идентификатор клиента делающего запрос.|-| password| Пароль клиента делающего запрос.|} <div class="toccolours mw-collapsible mw-collapsed" style="width:800px"><u>Пример ответа</u><div class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><?xml version='1.0' encoding='utf-8' ?><variants> <variant> <price>2664</price> <currency>rub</currency> <url>BOOKING_PAGE_DEEPLINK</url> <validatingCarrier>UN</validatingCarrier> <segment> <flight> <operatingCarrier>UN</operatingCarrier> <number>3</number> <departure>DME</departure> <departureDate>2012-09-25</departureDate> <departureTime>09:55</departureTime> <arrival>LED</arrival> <arrivalDate>2012-09-25</arrivalDate> <arrivalTime>11:10</arrivalTime> <equipment>735</equipment> <cabin>Y</cabin> </flight> </segment> </variant> <variant> ...more variants... </variant></variants></syntaxhighlight></div></div> ====== Статистика продаж ======
Пример запроса
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://hostnamehost/index.com/apiphp?go=settings/statistics?download_metasearch_stat&date1=2012-05-01&date2=2012-06-01&partner=aviasales&password=secret
</syntaxhighlight>
|-
| partner
| Идентификатор партнёра- алиас источника переходов модуля метрики.
|-
| password
| Пароль партнёра- пароль источника переходов модуля метрики.
|}
<bookings>
<booking>
<nemo_id>123123</nemo_id>
<id>JHKHVR</id>
<created_at>2012-05-02 00:02:01</created_at>
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>Содержание Описание структуры ответа</u>
<div class="mw-collapsible-content">
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
/bookings - корневой элемент содержащий информацию о бронированиях. //booking - информации об одном бронировании. nemo_id — ид заказа в системе Немо. id - уникальный идентификатор бронированияв системе поставщика (локатор). created_at - YYYY-MM-DD HH:MM время и дата бронирования в таймзоне UTC; если даты бронирования нет, то дата начала создания заказа. marker - маркер переданные в GET параметре marker при переходе на бронирование. from - IATA код аэропорта отправления. to - IATA код аэропорта назначения. price - цена билетов. profit - прибыль партнёра от данного бронирования. currency - валюта в которой указаны прибыль и цена билета. state - состояние брони. Допустимые значения PROCESSING/PAID/CANCELLED. segment - информация о перелётах (аналогично поисковому запросу). validatingCarrier - информация о бронировании (аналогично поисковому запросу)— IATA код авиакомпании, являющейся валидирующим перевозчиком. //flight - информация об одном перелёте. operatingCarrier - — IATA код авиакомпании осуществляющей рейс. number - номер рейса. departure - IATA код аэропорта отправления. departureDate - дата отправления, 'YYYY-MM-DD', местное время. departureTime - время отправления, 'HH:MM', местное время. arrival - IATA код аэропорта назначения. arrivalDate - дата прибытия, 'YYYY-MM-DD', местное время. arrivalTime - время прибытия, 'HH:MM', местное время. equipment - IATA транспортного средства осуществляющего перевозку. cabin - класс перелёта. "Y" - «Y» — эконом , "C" - «C» — бизнес, "F" - «F» — первый. adults - кол-во взрослых пассажиров. children - кол-во детей. infants - кол-во детей до 2 лет.
</syntaxhighlight>
</div>
</div>
Cостояние Время и дата бронирования '''''created_at''''' передается в таймзоне UTC 0 Состояние брони '''''state''''' может принимать значения:* '''''PROCESSING''''' - забронирован;* '''''PAID''''' - выписан;* '''''CANCELLED''''' - аннулирован (по любым причинам). Прибыль партнёра '''''profit''''' от данного бронирования в формате 00.99 (через точку).Размер прибыли партнера устанавливается для конкретного источника трафика в Модуле метрики и считается как процент от стоимости оплаченного заказа, включая комиссию платежного шлюза и апсейловые продажи. В последующем расчет прибыли может измениться. При возврате авиабилетов сумма ранее засчитанная как прибыль партнера (метапоисковой системы) должна подставляться с минусом в данном периоде.
Прибыль партнёра Количество детей до 2 лет '''''profitinfants''''' относится только к младенцам без места. Количество младенцев с местом объединяются с количеством детей до 12 лет '''''children''''' от данного бронирования.Размер прибыли партнера от стоимости оплаченного заказа
==Особенности работы с метапоиском в {{NameSystem}} === Модуль метрики =====Если источник перехода выключен, то статистика метапоиска все равно считается, но в этом случае возможно расхождение данных статистики метапоиска и модуля метрики по отключенному источнику.
====== HTTP cookie ======* В случае расхождения фактических результатов поиска с ожидаемыми агентом или при возникновении других вопросов агент должен проанализировать поисковые логи, затем обратиться сначала в поддержку метапоисковой системы и выяснить возможные причины проблемного поведения в системе метапоиска, и только потом, если ситуация не прояснилась, обращаться в техподдержку {{NameSystem}}.Запускается механизм управления HTTP cookie пользователей* Порядок отображения перелетов агентства в метапоисковых системах во многом зависит от настроек на стороне метапоиска, прихлдящих скорости ответа и ряда других параметров, на которые система {{NameSystem}} не может повлиять.* В соответствии с сайта метапоискатребованиями авиакомпании «Аэрофлот», система {{NameSystem}} при запросе эконом класса, а также если в маршрутизаторе включена настройка "Включает замену эконом/премэконом класса в запросе на All", самостоятельно отфильтровывает перелёты бизнес-класса от группы компаний «Аэрофлот». Для работы этого механихма необходимоБудет отброшен перелёт бизнес-класса, чтобы была задана настройка '''''«Источник метрики»'''''если он удовлетворяет сразу обоим указанным критериям: валидирующим перевозчиком является авиакомпания SU, хотя бы на одном из сегментов маркетинговый перевозчик или оперирующий перевозчик относится к авиакомпаниям SU, FV, HZ.<!-- мета сделано в рамках тикета 37849 -->
HTTP cookie продлеваются с каждым последующим переходом на бронирование.== Комиссия метапоиска ==
===== Ценообразование Для ценообразования также действует параметр Metasearch commission (комиссия метапоиску). Реализовано только для поставщика Aviasales. Данный параметр имеет следующие особенности:  * В правилах ценообразования задается как десятичное представление процентной ставки - это доля от 1, например, если задано 0.05 - 5%. Метапоиск считает это значение из элемента MetasearchCommissionRate в результатах поиска.<pre><MetasearchCommissionRate>0.05</MetasearchCommissionRate></pre>* Валюта расчета комиссии метапоиска берется из настроек агентства - «Профили компаний».* Если значение параметра из ценообразования меньше или равно нулю, то метапоиску передаваться не будет.* Так же можно указать значение в источнике метрики (Статистика и отчеты -> Метрика -> Источники переходов; параметр "Прибыль метапоисковика" в меню редактирования выбранного источника):** В процентном соотношении - в качестве значения указывается именно процент, т.е. если ставка комиссии 2.5%, то корректным значением будет "2.5";** В виде формулы - значение аналогично формуле ЦО, например, "120RUB*SEG*ADT".* Если не установлена комиссия, то она считается равной 0 =====. * Комиссия применяется из наилучшего правила ценообразования, но сам параметр не влияет на выбор правила как наилучшего.* Параметр приходит на этапе поиска и остается неизменным на всех этапе оформления заказа. На установленное значение комиссии не повлияет смена цены, семейства, правил ценообразования и т.д...* Комиссия из ЦО учитывается только в том случае, если был переход с метапоиска.* В отчете «Статистика заказов из метапоисков» комиссия фиксируется в теге profit. {{Attention|Комиссия метапоиску из файла ценообразования приоритетнее комиссии из настройки источника перехода. Устанавливая значение комиссии в ЦО меньше стандартного размера комиссии метапоиска может привести к проблеме взаимодействия с метапоиском.}} Для подключения данной функции необходимо предварительное согласование с поставщиком метапоисковой системы.
== См. также ==
* [[Ценообразование 2.0. Описание]]
* [[Ценообразование. Импорт правил]]
* [[Поиск_2.0#Фильтры запросов | Фильтры запросов поиска]]
 
[[Категория:Модули]]
[[Категория:Дополнительные модули]]
'