Просмотр кода страницы Взаимодействие с метапоисковиками

'''Метапоисковая система''' (метапоисковая машина, метапоисковик) — это поисковая система, которая в отличие от классических поисковых машин не имеет собственной базы данных и собственного поискового индекса, а формирует поисковую выдачу за счет смешивания и переранжирования результатов поиска других поисковых систем.

Необходимо убедиться, что 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|50px|left]]
Первый и крупнейший в Рунете метапоиск дешевых авиабилетов. Производит поиск авиабилетов в 728 авиакомпаниях, 40 авиакассах и 5 системах бронирования (GDS), используя наиболее современные технологии.

==== Принципы работы с метапоисковиком ====
AviaSales.ru рекомендует устанавливать срок действия HTTP cookie в 30 дней.

Для покупки билетов пользователь будет перенаправлен с метапоиска на сайт для бронирования заказа. Для отслеживания продаж и привязывания к посетителям может передаваться дополнительный GET параметр marker.

Маркер, переданный при переходе на бронирование, является частью информации о бронировании в статистике, и напрямую связан с параметром [[Модуль метрики#Маркер | marker]] из модуля метрики.

В работе с метапоиском присутствует функционал динамического аукциона, который позволяет при равной цене показывать результаты с большей комиссией за метапоиск выше в поисковой выдаче. Размер комиссии задается по параметру "Комиссия метапоиску" (Metasearch Сommission) в процессе ценообразования.  

===== Статистика продаж =====

Пример запроса
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://host/index.php?go=settings/download_metasearch_stat&date1=2012-05-01&date2=2012-06-01&partner=aviasales&password=secret
</syntaxhighlight>

Параметры запроса
{| style="width: 800px" class="wikitable"
|-
! scope="col" | Параметр запроса
! scope="col" | Описание
|-
| date1
| YYYY-MM-DD дата.
|-
| date2
| YYYY-MM-DD дата.
|-
| 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;">
<bookings>
  <booking>
    <nemo_id>123123</nemo_id>
    <id>JHKHVR</id>
    <created_at>2012-05-02 00:02:01</created_at>
    <marker>1232:1222.t</marker>
    <price>1199</price>
    <profit>200</profit>
    <currency>RUB</currency>
    <state>PAID</state>
    <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>
    <adults>1</adults>
    <children>0</children>
    <infants>0</infants>
  </booking>
  ...more bookings...
</bookings>
</syntaxhighlight>
</div>
</div>

<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 при переходе на бронирование.    
    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» — эконом , «C» — бизнес, «F» — первый.
    adults — кол-во взрослых пассажиров.
    children — кол-во детей.
    infants — кол-во детей до 2 лет.
</syntaxhighlight>
</div>
</div>

Время и дата бронирования '''''created_at''''' передается в таймзоне UTC+4.

Состояние брони '''''state''''' может принимать значения:
* '''''PROCESSING''''' — забронирован;
* '''''PAID''''' — выписан;
* '''''CANCELLED''''' — аннулирован (по любым причинам).

Прибыль партнёра '''''profit''''' от данного бронирования в формате 00.99 (через точку).
Размер прибыли партнера устанавливается для конкретного источника трафика в Модуле метрики и считается как процент от стоимости оплаченного заказа, включая комиссию платежного шлюза и апсейловые продажи. В последующем расчет прибыли может измениться. При возврате авиабилетов сумма ранее засчитанная как прибыль партнера (метапоисковой системы) должна подставляться с минусом в данном периоде.

Количество детей до 2 лет '''''infants''''' относится только к младенцам без места. Количество младенцев с местом объединяются с количеством детей до 12 лет '''''children'''''.

== Особенности работы с метапоиском в {{NameSystem}} == 

* В случае расхождения фактических результатов поиска с ожидаемыми агентом или при возникновении других вопросов агент должен проанализировать поисковые логи, затем обратиться сначала в поддержку метапоисковой системы и выяснить возможные причины проблемного поведения в системе метапоиска, и только потом, если ситуация не прояснилась, обращаться в техподдержку {{NameSystem}}.
* Порядок отображения перелетов агентства в метапоисковых системах во многом зависит от настроек на стороне метапоиска, скорости ответа и ряда других параметров, на которые система {{NameSystem}} не может повлиять.
* В соответствии с требованиями авиакомпании «Аэрофлот», система {{NameSystem}} при запросе эконом класса, а также если в маршрутизаторе включена настройка "Включает замену эконом/премэконом класса в запросе на All", самостоятельно отфильтровывает перелёты бизнес-класса от группы компаний «Аэрофлот». Будет отброшен перелёт бизнес-класса, если он удовлетворяет сразу обоим указанным критериям: валидирующим перевозчиком является авиакомпания SU, хотя бы на одном из сегментов маркетинговый перевозчик или оперирующий перевозчик относится к авиакомпаниям SU, FV, HZ. <!-- мета сделано в рамках тикета 37849 -->

== См. также ==
* [https://github.com/KosyanMedia/aviasales-self-service-api/wiki/API-RU Требования Aviasales.ru к API]
* [[Модуль метрики]]
* [[Ценообразование 2.0. Описание]]
* [[Ценообразование. Импорт правил]]
* [[Поиск_2.0#Фильтры запросов | Фильтры запросов поиска]]

[[Категория:Модули]] 
[[Категория:Дополнительные модули]]