Взаимодействие с метапоисковиками: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Aviasales.ru)
(Статистика продаж)
 
(не показаны 44 промежуточные версии 14 участников)
Строка 1: Строка 1:
 
'''Метапоисковая система''' (метапоисковая машина, метапоисковик) — это поисковая система, которая в отличие от классических поисковых машин не имеет собственной базы данных и собственного поискового индекса, а формирует поисковую выдачу за счет смешивания и переранжирования результатов поиска других поисковых систем.
 
'''Метапоисковая система''' (метапоисковая машина, метапоисковик) — это поисковая система, которая в отличие от классических поисковых машин не имеет собственной базы данных и собственного поискового индекса, а формирует поисковую выдачу за счет смешивания и переранжирования результатов поиска других поисковых систем.
 +
 +
Необходимо убедиться, что API запросы на поиск отправляются на доменное имя, указанное для агентства (субагента) в разделе «Управление сайтом» → «Домены и протоколы».
 +
 +
== Условия подключения и использования модуля ==
 +
 +
Агентство может использовать данный модуль системы {{NameSystem}}, только если выполняются следующие условия:
 +
 +
* используется только коннектор к {{NameProject2}};
 +
* в разделе настроек «Управление продажами» → «Авиабилеты» → «Процессы» → «Процесс поиска» → «Тонкая настройка» для АПИ-пользователя метапоиска включена настройка {{Setting|Объединение поисков для {{NameProject2}}}};
 +
* для метапоиска настроены фильтры запросов;
 +
* для АПИ-пользователя в разделе «Управление продажами» → «Авиабилеты» → «Устаревшие настройки» → «Ограничение поиска» отключена отправка параллельных запросов на дополнительные классы перелетов (эконом-премиум и первый);
 +
* максимальное число ценовых правил, заведенных на каждую авиакомпанию — не более 100;
 +
* предельный look-to-book (конверсия) для метапоиска - 3000:1.
 +
 +
Данные ограничения объясняются необходимостью контролировать нагрузку на сервер. Если какие-либо условия из этого списка не выполняются, администраторы {{NameSystem}} вправе отключить модуль взаимодействия с метапоиском для агента.
  
 
== Настройка ==
 
== Настройка ==
Для агентства должен быть включен модуль '''«Взаимодействие с метапоисковиками»''', тогда:
+
Для агентства должен быть включен модуль {{Setting|Взаимодействие с метапоисковиками}}, тогда:
* становится доступным раздел '''«Статистика заказов из метапоисков»''' в разделе '''«Администрирование»''' → '''«Логи и статистика»''';
+
* становится доступным раздел '''Статистика и отчеты → Статистика заказов из метапоисков''';
* появляется настройка '''''«Источник метрики»''''' (показывается только для пользователей внутри агентства/субагентства) в разделе '''«Авиабилеты»''' '''«Стандартный поиск»''' '''«Настройки»''';
+
* появляется настройка {{Setting|Источник метрики}} (показывается только для пользователей внутри агентства/субагентства) в разделе «Управление продажами» → «Авиабилеты» → «Процессы» «Форма поиска»;
* появляются настройки '''''«Время жизни cookie (дней)»''''', '''''«Продлевать время жизни cookie при следующем заходе пользователя»''''', '''''«Прибыль метапоисковика (процент)»''''' в разделе '''«Метрика »''' '''«Источники трафика»'''.
+
 
 +
{{Attention|При изменении алиаса в разделе «Статистика и отчеты» → «Метрика» → «Источники переходов», необходимо проверить настройку «Источник метрики», определен ли источник, так как эта настройка может слететь.}}
 +
 
 +
* появляются настройки {{Setting|Время жизни cookie (дней)}}, {{Setting|Продлевать время жизни cookie при следующем заходе пользователя}}, {{Setting|Прибыль метапоисковика (процент)}} в разделе «Статистика и отчеты» → «Метрика» → «Источники переходов»;
 +
* в личном кабинете открывается новый фильтр по заказам '''''«Источник перехода»''''', подробнее [[Личный кабинет#Фильтр заказов | «Личный кабинет. Фильтр заказов»]].
  
В список '''''«Источник метрики»''''' подгружаются источники, настроенные в модуле метрики в '''«Источниках переходов»'''. Если ни одного источника не настроено, то поле '''''«Источник метрики»''''' будет скрыто.
+
В список {{Setting|Источник метрики}} подгружаются источники, настроенные в модуле метрики в '''«Источники переходов»'''. Если ни одного источника не настроено, то поле {{Setting|Источник метрики}} будет скрыто.
  
Если задана настройка '''''«Источник метрики»''''', то запускается механизм управления HTTP cookie пользователей, приходящих с сайта метапоиска. Если модуль '''«Взаимодействие с метапоисковиками»''' отключен, то HTTP cookie не сохраняются.
+
Если задана настройка {{Setting|Источник метрики}}, то запускается механизм управления HTTP cookie пользователей, приходящих с сайта метапоиска. Если модуль {{Setting|Взаимодействие с метапоисковиками}} отключен, то HTTP cookie не сохраняются.
  
Если источник перехода выключен в модуле метрики, то статистика метапоиска все равно считается, но в этом случае возможно расхождение данных статистики метапоиска и модуля метрики.
+
Если источник перехода выключен в модуле метрики, то статистика метапоиска все равно считается, но в этом случае данные статистики метапоиска и модуля метрики будут различными. В целом возможно расхождение данных статистики метапоиска и модуля метрики, так как это два различных модуля.
  
Через настройку '''''«Источник метрики»''''' ('''«Авиабилеты»''' '''«Стандартный поиск»''' '''«Настройки»''') источник переходов модуля метрики привязывается к конкретному пользователю, для которого настроены API Nemo.
+
Через настройку {{Setting|Источник метрики}} («Управление продажами» → «Авиабилеты» → «Процессы» «Форма поиска») источник переходов модуля метрики привязывается к конкретному пользователю, для которого настроены API {{NameSystem}}.
 +
 
 +
=== Фильтры запросов поиска ===
 +
При взаимодействии с метапоисковыми системами требуется настраивать [[Поиск_2.0#Фильтры запросов | фильтры запросов поиска]], чтобы:
 +
* оставить для поиска самые выгодные направления,
 +
* увеличить конверсию «Look To Book»,
 +
* ограничить нежелательные запросы к GDS (экономия транзакций), <!-- * исключить из поиска не поддерживаемые направления, то есть направления, по которым заведомо будут отсутствовать результаты поиска -->
 +
* уменьшить нагрузку на сервер.  
  
 
=== Источник метрики ===
 
=== Источник метрики ===
Строка 21: Строка 47:
  
 
=== Дополнительные параметры источника переходов ===
 
=== Дополнительные параметры источника переходов ===
* '''''Время жизни cookie (дней)''''' - срок действия HTTP cookie, в течение которого Nemo запоминает пользователя, пришедшего с метапоиска.
+
* {{Setting|Время жизни cookie (дней)}} — срок действия HTTP cookie, в течение которого {{NameSystem}} запоминает пользователя, пришедшего с метапоиска. В случае отсутствия заданного значения настройки «Время жизни cookie (дней)», либо если оно равно 0, то время жизни cookie проставляется в 1 час.
* '''''Продлевать время жизни cookie при следующем заходе пользователя''''' - если опция включена, то HTTP cookie продлеваются с каждым последующим переходом на бронирование.
+
* {{Setting|Продлевать время жизни cookie при следующем заходе пользователя}} — если опция включена, то HTTP cookie продлеваются с каждым последующим переходом на бронирование.
* '''''Прибыль метапоисковика (процент)''''' - считается как процент от стоимости оплаченного заказа, включая комиссию платежного шлюза и апсейловые продажи. Используется только в отчетах статистики метапоиска и не изменяет итоговую стоимость заказа.
+
* {{Setting|Прибыль метапоисковика (процент)}} — считается как процент от стоимости оплаченного заказа, включая комиссию платежного шлюза, исключая дополнительные услуги (апесейл). Используется только в отчетах статистики метапоиска и не изменяет итоговую стоимость заказа.
  
 
=== Сборы ===
 
=== Сборы ===
Модуль '''«Ценообразование 2.0»''' позволяет задать ценовое правило для источника перехода на основе параметра '''''utm source'''''. В качестве значения необходимо указывать идентификатор источника перехода, который отображается в поле '''''«№»''''' таблицы источников переходов.
+
Модуль '''«Ценообразование 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|Статистика заказов из метапоисков]]
 
[[Файл:Статистика_заказов_из_метапоисков.png|400px|thumb|right|Статистика заказов из метапоисков]]
 
В данном разделе можно получить данные по статистике метапоиска (по источнику переходов модуля метрики) <u>за определенный период бронирования заказов</u> в виде файла данных в формате XML.
 
В данном разделе можно получить данные по статистике метапоиска (по источнику переходов модуля метрики) <u>за определенный период бронирования заказов</u> в виде файла данных в формате XML.
 +
 +
Доступ к разделу имеет менеджер головного агентства.
  
 
Можно получить статистику метапоиска как для агентства, так и для субагентств.
 
Можно получить статистику метапоиска как для агентства, так и для субагентств.
  
 
Для получения данных необходимо заполнить поля:
 
Для получения данных необходимо заполнить поля:
* '''''Источник метрики''''' - один из источников, настроенных в «Источниках переходов» модуля метрики;
+
* {{Setting|Источник метрики}} — один из источников, настроенных в «Источниках переходов» модуля метрики;
* '''''Дата с''''' - начало периода бронирований;
+
* {{Setting|Дата с}} — начало периода бронирований;
* '''''Дата по''''' - окончание периода бронирований.
+
* {{Setting|Дата по}} — окончание периода бронирований.
  
 
== Поддержка метапоисковиков ==
 
== Поддержка метапоисковиков ==
Строка 45: Строка 73:
  
 
==== Принципы работы с метапоисковиком ====
 
==== Принципы работы с метапоисковиком ====
В Nemo реализовано два интерфейса (согласно требованиям AviaSales.ru):
 
* '''''Запрос вариантов перелета с ценами''''' - использует [[Агентский АПИ | агентский API Nemo]] для поиска авиабилетов.
 
* '''''Статистика продаж''''' - реализована на базе [[Модуль метрики | Модуля метрики Nemo]].
 
 
 
AviaSales.ru рекомендует устанавливать срок действия HTTP cookie в 30 дней.
 
AviaSales.ru рекомендует устанавливать срок действия 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
 
</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>
 
 
 
<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;">
 
    /variants - корневой элемент, содержащий варианты перелётов.
 
    //variant - полный вариант перелёта.
 
    price - полная цена за всех пассажиров для данного перелёта.
 
    currency - валюта используемая в цене билетов.
 
    url - URL приземляющий пользователя на страницу бронирования билетов.
 
    validatingCarrier - IATA код авиакомпании - ответственного перевозчика.
 
    segment - сегменты перелёта. Первый сегмент перелёт туда, второй обратно.
 
    segment/flight - 1..n, все перелёты в одну сторону.
 
    //flight - информация об одном перелёте.
 
        operatingCarrier - код авиакомпании осуществляющей рейс.
 
        marketingCarrier - код авиакомпании продающей рейс, указывается если отличается от авиакомпании осуществляющей рейс (code share).
 
        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" - первый.
 
</syntaxhighlight>
 
</div>
 
</div>
 
 
 
Для покупки билетов пользователь будет отправлен на URL из тега variant/url. Для отслеживания продаж и привязывания к посетителям передаётся дополнительный GET параметр marker.
 
  
Полный URL бронирования строится следующим образом: variant/url + '&marker' + marker_value, где marker_value - строка содержащая не более 256 символов. Маркер переданный при переходе на бронирование является частью информации о бронировании в статистике и напрямую связан с параметром [[Модуль метрики#Маркер | marker]] из модуля метрики.
+
Маркер, переданный при переходе на бронирование, является частью информации о бронировании в статистике, и напрямую связан с параметром [[Модуль метрики#Маркер | marker]] из модуля метрики.
 +
  
 
===== Статистика продаж =====
 
===== Статистика продаж =====
Строка 193: Строка 112:
 
<bookings>
 
<bookings>
 
   <booking>
 
   <booking>
 +
    <nemo_id>123123</nemo_id>
 
     <id>JHKHVR</id>
 
     <id>JHKHVR</id>
 
     <created_at>2012-05-02 00:02:01</created_at>
 
     <created_at>2012-05-02 00:02:01</created_at>
Строка 226: Строка 146:
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>Содержание ответа</u>
+
<u>Описание структуры ответа</u>
 
<div class="mw-collapsible-content">
 
<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;">
 
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
     /bookings - корневой элемент содержащий информацию о бронированиях.
+
     /bookings корневой элемент содержащий информацию о бронированиях.
     //booking - информации об одном бронировании.
+
     //booking информации об одном бронировании.
     id - уникальный идентификатор бронирования.
+
    nemo_id — ид заказа в системе Немо.
     created_at - YYYY-MM-DD HH:MM время и дата бронирования в таймзоне UTC.
+
     id уникальный идентификатор бронирования в системе поставщика (локатор).
     marker - маркер переданные в GET параметре marker при переходе на бронирование.
+
     created_at YYYY-MM-DD HH:MM время и дата бронирования в таймзоне UTC; если даты бронирования нет, то дата начала создания заказа.
    from - IATA код аэропорта отправления.
+
     marker маркер переданные в GET параметре marker при переходе на бронирование.  
    to - IATA код аэропорта назначения.
+
     price цена билетов.
     price - цена билетов.
+
     profit прибыль партнёра от данного бронирования.
     profit - прибыль партнёра от данного бронирования.
+
     currency валюта в которой указаны прибыль и цена билета.
     currency - валюта в которой указаны прибыль и цена билета.
+
     state состояние брони. Допустимые значения PROCESSING/PAID/CANCELLED.
     state - состояние брони. Допустимые значения PROCESSING/PAID/CANCELLED.
+
     segment информация о перелётах.
     segment - информация о перелётах (аналогично поисковому запросу).
+
     validatingCarrier — IATA код авиакомпании, являющейся валидирующим перевозчиком.
     validatingCarrier - информация о бронировании (аналогично поисковому запросу).
+
     //flight информация об одном перелёте.
     //flight - информация об одном перелёте.
+
         operatingCarrier — IATA код авиакомпании осуществляющей рейс.
         operatingCarrier - код авиакомпании осуществляющей рейс.
+
         number номер рейса.
         number - номер рейса.
+
         departure IATA код аэропорта отправления.
         departure - IATA код аэропорта отправления.
+
         departureDate дата отправления, 'YYYY-MM-DD', местное время.
         departureDate - дата отправления, 'YYYY-MM-DD', местное время.
+
         departureTime время отправления, 'HH:MM', местное время.
         departureTime - время отправления, 'HH:MM', местное время.
+
         arrival IATA код аэропорта назначения.
         arrival - IATA код аэропорта назначения.
+
         arrivalDate дата прибытия, 'YYYY-MM-DD', местное время.
         arrivalDate - дата прибытия, 'YYYY-MM-DD', местное время.
+
         arrivalTime время прибытия, 'HH:MM', местное время.
         arrivalTime - время прибытия, 'HH:MM', местное время.
+
         equipment IATA транспортного средства осуществляющего перевозку.
         equipment - IATA транспортного средства осуществляющего перевозку.
+
         cabin класс перелёта. «Y» — эконом , «C» — бизнес, «F» — первый.
         cabin - класс перелёта. "Y" - эконом , "C" - бизнес, "F" - первый.
+
     adults кол-во взрослых пассажиров.
     adults - кол-во взрослых пассажиров.
+
     children кол-во детей.
     children - кол-во детей.
+
     infants кол-во детей до 2 лет.
     infants - кол-во детей до 2 лет.
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 
</div>
 
</div>
 
</div>
 
</div>
  
Время и дата бронирования '''''created_at''''' передается в таймзоне UTC+4.
+
Время и дата бронирования '''''created_at''''' передается в таймзоне UTC 0
  
 
Состояние брони '''''state''''' может принимать значения:
 
Состояние брони '''''state''''' может принимать значения:
* '''''PROCESSING''''' - забронирован;
+
* '''''PROCESSING''''' забронирован;
* '''''PAID''''' - выписан;
+
* '''''PAID''''' выписан;
* '''''CANCELLED''''' - аннулирован (по любым причинам).
+
* '''''CANCELLED''''' аннулирован (по любым причинам).
  
Прибыль партнёра '''''profit''''' от данного бронирования.
+
Прибыль партнёра '''''profit''''' от данного бронирования в формате 00.99 (через точку).
 
Размер прибыли партнера устанавливается для конкретного источника трафика в Модуле метрики и считается как процент от стоимости оплаченного заказа, включая комиссию платежного шлюза и апсейловые продажи. В последующем расчет прибыли может измениться. При возврате авиабилетов сумма ранее засчитанная как прибыль партнера (метапоисковой системы) должна подставляться с минусом в данном периоде.
 
Размер прибыли партнера устанавливается для конкретного источника трафика в Модуле метрики и считается как процент от стоимости оплаченного заказа, включая комиссию платежного шлюза и апсейловые продажи. В последующем расчет прибыли может измениться. При возврате авиабилетов сумма ранее засчитанная как прибыль партнера (метапоисковой системы) должна подставляться с минусом в данном периоде.
  
 
Количество детей до 2 лет '''''infants''''' относится только к младенцам без места. Количество младенцев с местом объединяются с количеством детей до 12 лет '''''children'''''.
 
Количество детей до 2 лет '''''infants''''' относится только к младенцам без места. Количество младенцев с местом объединяются с количеством детей до 12 лет '''''children'''''.
 +
 +
== Особенности работы с метапоиском в {{NameSystem}} ==
 +
 +
* В случае расхождения фактических результатов поиска с ожидаемыми агентом или при возникновении других вопросов агент должен проанализировать поисковые логи, затем обратиться сначала в поддержку метапоисковой системы и выяснить возможные причины проблемного поведения в системе метапоиска, и только потом, если ситуация не прояснилась, обращаться в техподдержку {{NameSystem}}.
 +
* Порядок отображения перелетов агентства в метапоисковых системах во многом зависит от настроек на стороне метапоиска, скорости ответа и ряда других параметров, на которые система {{NameSystem}} не может повлиять.
 +
* В соответствии с требованиями авиакомпании «Аэрофлот», система {{NameSystem}} при запросе эконом класса, а также если в маршрутизаторе включена настройка "Включает замену эконом/премэконом класса в запросе на All", самостоятельно отфильтровывает перелёты бизнес-класса от группы компаний «Аэрофлот». Будет отброшен перелёт бизнес-класса, если он удовлетворяет сразу обоим указанным критериям: валидирующим перевозчиком является авиакомпания SU, хотя бы на одном из сегментов маркетинговый перевозчик или оперирующий перевозчик относится к авиакомпаниям SU, FV, HZ. <!-- мета сделано в рамках тикета 37849 -->
 +
 +
== Комиссия метапоиска ==
 +
 +
Для ценообразования также действует параметр Metasearch commission (комиссия метапоиску). Реализовано только для поставщика Aviasales. Данный параметр имеет следующие особенности:
 +
 +
* В правилах ценообразования задается как десятичное представление процентной ставки - это доля от 1, например, если задано 0.05 - 5%. Метапоиск считает это значение из элемента MetasearchCommissionRate в результатах поиска.
 +
<pre>
 +
<MetasearchCommissionRate>0.05</MetasearchCommissionRate>
 +
</pre>
 +
* Валюта расчета комиссии метапоиска берется из настроек агентства - «Профили компаний».
 +
* Если значение параметра из ценообразования меньше или равно нулю, то метапоиску передаваться не будет.
 +
* Так же можно указать значение в источнике метрики (Статистика и отчеты -> Метрика -> Источники переходов; параметр "Прибыль метапоисковика" в меню редактирования выбранного источника):
 +
** В процентном соотношении - в качестве значения указывается именно процент, т.е. если ставка комиссии 2.5%, то корректным значением будет "2.5";
 +
** В виде формулы - значение аналогично формуле ЦО, например, "120RUB*SEG*ADT".
 +
* Если не установлена комиссия, то она считается равной 0.
 +
* Комиссия применяется из наилучшего правила ценообразования, но сам параметр не влияет на выбор правила как наилучшего.
 +
* Параметр приходит на этапе поиска и остается неизменным на всех этапе оформления заказа. На установленное значение комиссии не повлияет смена цены, семейства, правил ценообразования и т.д...
 +
* Комиссия из ЦО учитывается только в том случае, если был переход с метапоиска.
 +
* В отчете «Статистика заказов из метапоисков» комиссия фиксируется в теге profit.
 +
 +
{{Attention|Комиссия метапоиску из файла ценообразования приоритетнее комиссии из настройки источника перехода. Устанавливая значение комиссии в ЦО меньше стандартного размера комиссии метапоиска может привести к проблеме взаимодействия с метапоиском.}}
 +
 +
Для подключения данной функции необходимо предварительное согласование с поставщиком метапоисковой системы.
  
 
== См. также ==
 
== См. также ==
Строка 277: Строка 225:
 
* [[Ценообразование 2.0. Описание]]
 
* [[Ценообразование 2.0. Описание]]
 
* [[Ценообразование. Импорт правил]]
 
* [[Ценообразование. Импорт правил]]
 +
* [[Поиск_2.0#Фильтры запросов | Фильтры запросов поиска]]
 +
 +
[[Категория:Модули]]
 +
[[Категория:Дополнительные модули]]

Текущая версия на 12:48, 19 апреля 2021

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

Необходимо убедиться, что API запросы на поиск отправляются на доменное имя, указанное для агентства (субагента) в разделе «Управление сайтом» → «Домены и протоколы».

Условия подключения и использования модуля

Агентство может использовать данный модуль системы Nemo.Travel, только если выполняются следующие условия:

  • используется только коннектор к Nemo Connect;
  • в разделе настроек «Управление продажами» → «Авиабилеты» → «Процессы» → «Процесс поиска» → «Тонкая настройка» для АПИ-пользователя метапоиска включена настройка Объединение поисков для Nemo Connect;
  • для метапоиска настроены фильтры запросов;
  • для АПИ-пользователя в разделе «Управление продажами» → «Авиабилеты» → «Устаревшие настройки» → «Ограничение поиска» отключена отправка параллельных запросов на дополнительные классы перелетов (эконом-премиум и первый);
  • максимальное число ценовых правил, заведенных на каждую авиакомпанию — не более 100;
  • предельный look-to-book (конверсия) для метапоиска - 3000:1.

Данные ограничения объясняются необходимостью контролировать нагрузку на сервер. Если какие-либо условия из этого списка не выполняются, администраторы Nemo.Travel вправе отключить модуль взаимодействия с метапоиском для агента.

Настройка

Для агентства должен быть включен модуль Взаимодействие с метапоисковиками, тогда:

  • становится доступным раздел Статистика и отчеты → Статистика заказов из метапоисков;
  • появляется настройка Источник метрики (показывается только для пользователей внутри агентства/субагентства) в разделе «Управление продажами» → «Авиабилеты» → «Процессы» → «Форма поиска»;

Внимание! При изменении алиаса в разделе «Статистика и отчеты» → «Метрика» → «Источники переходов», необходимо проверить настройку «Источник метрики», определен ли источник, так как эта настройка может слететь.

  • появляются настройки Время жизни cookie (дней), Продлевать время жизни cookie при следующем заходе пользователя, Прибыль метапоисковика (процент) в разделе «Статистика и отчеты» → «Метрика» → «Источники переходов»;
  • в личном кабинете открывается новый фильтр по заказам «Источник перехода», подробнее «Личный кабинет. Фильтр заказов».

В список Источник метрики подгружаются источники, настроенные в модуле метрики в «Источники переходов». Если ни одного источника не настроено, то поле Источник метрики будет скрыто.

Если задана настройка Источник метрики, то запускается механизм управления HTTP cookie пользователей, приходящих с сайта метапоиска. Если модуль Взаимодействие с метапоисковиками отключен, то HTTP cookie не сохраняются.

Если источник перехода выключен в модуле метрики, то статистика метапоиска все равно считается, но в этом случае данные статистики метапоиска и модуля метрики будут различными. В целом возможно расхождение данных статистики метапоиска и модуля метрики, так как это два различных модуля.

Через настройку Источник метрики («Управление продажами» → «Авиабилеты» → «Процессы» → «Форма поиска») источник переходов модуля метрики привязывается к конкретному пользователю, для которого настроены API Nemo.Travel.

Фильтры запросов поиска

При взаимодействии с метапоисковыми системами требуется настраивать фильтры запросов поиска, чтобы:

  • оставить для поиска самые выгодные направления,
  • увеличить конверсию «Look To Book»,
  • ограничить нежелательные запросы к GDS (экономия транзакций),
  • уменьшить нагрузку на сервер.

Источник метрики

Подробная информация об источниках переходов модуля метрики находится в соответствующей статье «Модуль метрики. Создание источника переходов».

Параметры источников переходов, связанные со статистикой метапоисков описаны ниже.

Дополнительные параметры источника переходов

  • Время жизни cookie (дней) — срок действия HTTP cookie, в течение которого Nemo.Travel запоминает пользователя, пришедшего с метапоиска. В случае отсутствия заданного значения настройки «Время жизни cookie (дней)», либо если оно равно 0, то время жизни cookie проставляется в 1 час.
  • Продлевать время жизни cookie при следующем заходе пользователя — если опция включена, то HTTP cookie продлеваются с каждым последующим переходом на бронирование.
  • Прибыль метапоисковика (процент) — считается как процент от стоимости оплаченного заказа, включая комиссию платежного шлюза, исключая дополнительные услуги (апесейл). Используется только в отчетах статистики метапоиска и не изменяет итоговую стоимость заказа.

Сборы

Модуль «Ценообразование 2.0» позволяет задать ценовое правило для источника перехода на основе параметра utm_source. В качестве значения необходимо указывать идентификатор источника перехода, который отображается в поле таблицы источников переходов.

Статистика заказов из метапоисков

Статистика заказов из метапоисков

В данном разделе можно получить данные по статистике метапоиска (по источнику переходов модуля метрики) за определенный период бронирования заказов в виде файла данных в формате XML.

Доступ к разделу имеет менеджер головного агентства.

Можно получить статистику метапоиска как для агентства, так и для субагентств.

Для получения данных необходимо заполнить поля:

  • Источник метрики — один из источников, настроенных в «Источниках переходов» модуля метрики;
  • Дата с — начало периода бронирований;
  • Дата по — окончание периода бронирований.

Поддержка метапоисковиков

Aviasales.ru

Aviasales.ru.png

Первый и крупнейший в Рунете метапоиск дешевых авиабилетов. Производит поиск авиабилетов в 728 авиакомпаниях, 40 авиакассах и 5 системах бронирования (GDS), используя наиболее современные технологии.

Принципы работы с метапоисковиком

AviaSales.ru рекомендует устанавливать срок действия HTTP cookie в 30 дней.

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

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


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

Пример запроса

http://host/index.php?go=settings/download_metasearch_stat&date1=2012-05-01&date2=2012-06-01&partner=aviasales&password=secret

Параметры запроса

Параметр запроса Описание
date1 YYYY-MM-DD дата.
date2 YYYY-MM-DD дата.
partner Идентификатор партнёра - алиас источника переходов модуля метрики.
password Пароль партнёра - пароль источника переходов модуля метрики.

Пример ответа

 1 <bookings>
 2   <booking>
 3     <nemo_id>123123</nemo_id>
 4     <id>JHKHVR</id>
 5     <created_at>2012-05-02 00:02:01</created_at>
 6     <marker>1232:1222.t</marker>
 7     <price>1199</price>
 8     <profit>200</profit>
 9     <currency>RUB</currency>
10     <state>PAID</state>
11     <validatingCarrier>UN</validatingCarrier>
12     <segment>
13       <flight>
14         <operatingCarrier>UN</operatingCarrier>
15         <number>3</number>
16         <departure>DME</departure>
17         <departureDate>2012-09-25</departureDate>
18         <departureTime>09:55</departureTime>
19         <arrival>LED</arrival>
20         <arrivalDate>2012-09-25</arrivalDate>
21         <arrivalTime>11:10</arrivalTime>
22         <equipment>735</equipment>
23         <cabin>Y</cabin>
24       </flight>
25     </segment>
26     <adults>1</adults>
27     <children>0</children>
28     <infants>0</infants>
29   </booking>
30   ...more bookings...
31 </bookings>

Описание структуры ответа

    /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 лет.

Время и дата бронирования created_at передается в таймзоне UTC 0

Состояние брони state может принимать значения:

  • PROCESSING — забронирован;
  • PAID — выписан;
  • CANCELLED — аннулирован (по любым причинам).

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

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

Особенности работы с метапоиском в Nemo.Travel

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

Комиссия метапоиска

Для ценообразования также действует параметр Metasearch commission (комиссия метапоиску). Реализовано только для поставщика Aviasales. Данный параметр имеет следующие особенности:

  • В правилах ценообразования задается как десятичное представление процентной ставки - это доля от 1, например, если задано 0.05 - 5%. Метапоиск считает это значение из элемента MetasearchCommissionRate в результатах поиска.
<MetasearchCommissionRate>0.05</MetasearchCommissionRate>
  • Валюта расчета комиссии метапоиска берется из настроек агентства - «Профили компаний».
  • Если значение параметра из ценообразования меньше или равно нулю, то метапоиску передаваться не будет.
  • Так же можно указать значение в источнике метрики (Статистика и отчеты -> Метрика -> Источники переходов; параметр "Прибыль метапоисковика" в меню редактирования выбранного источника):
    • В процентном соотношении - в качестве значения указывается именно процент, т.е. если ставка комиссии 2.5%, то корректным значением будет "2.5";
    • В виде формулы - значение аналогично формуле ЦО, например, "120RUB*SEG*ADT".
  • Если не установлена комиссия, то она считается равной 0.
  • Комиссия применяется из наилучшего правила ценообразования, но сам параметр не влияет на выбор правила как наилучшего.
  • Параметр приходит на этапе поиска и остается неизменным на всех этапе оформления заказа. На установленное значение комиссии не повлияет смена цены, семейства, правил ценообразования и т.д...
  • Комиссия из ЦО учитывается только в том случае, если был переход с метапоиска.
  • В отчете «Статистика заказов из метапоисков» комиссия фиксируется в теге profit.

Внимание! Комиссия метапоиску из файла ценообразования приоритетнее комиссии из настройки источника перехода. Устанавливая значение комиссии в ЦО меньше стандартного размера комиссии метапоиска может привести к проблеме взаимодействия с метапоиском.

Для подключения данной функции необходимо предварительное согласование с поставщиком метапоисковой системы.

См. также