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

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Aviasales.ru)
(Запрос вариантов перелета с ценами)
Строка 50: Строка 50:
  
 
AviaSales.ru рекомендует устанавливать срок действия HTTP cookie в 30 дней.
 
AviaSales.ru рекомендует устанавливать срок действия HTTP cookie в 30 дней.
 
===== Запрос вариантов перелета с ценами =====
 
 
Пример запроса
 
<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. Для отслеживания продаж и привязывания к посетителям передаётся дополнительный GET параметр marker.

Версия 11:48, 21 февраля 2014

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

Настройка

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

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

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

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

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

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

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

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

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

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

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

Сборы

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

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

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

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

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

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

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

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

Aviasales.ru

Aviasales.ru.png

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

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

В Nemo реализовано два интерфейса (согласно требованиям AviaSales.ru):

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

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

Полный URL бронирования строится следующим образом: variant/url + '&marker' + marker_value, где marker_value - строка содержащая не более 256 символов. Маркер переданный при переходе на бронирование является частью информации о бронировании в статистике и напрямую связан с параметром 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     <id>JHKHVR</id>
 4     <created_at>2012-05-02 00:02:01</created_at>
 5     <marker>1232:1222.t</marker>
 6     <price>1199</price>
 7     <profit>200</profit>
 8     <currency>RUB</currency>
 9     <state>PAID</state>
10     <validatingCarrier>UN</validatingCarrier>
11     <segment>
12       <flight>
13         <operatingCarrier>UN</operatingCarrier>
14         <number>3</number>
15         <departure>DME</departure>
16         <departureDate>2012-09-25</departureDate>
17         <departureTime>09:55</departureTime>
18         <arrival>LED</arrival>
19         <arrivalDate>2012-09-25</arrivalDate>
20         <arrivalTime>11:10</arrivalTime>
21         <equipment>735</equipment>
22         <cabin>Y</cabin>
23       </flight>
24     </segment>
25     <adults>1</adults>
26     <children>0</children>
27     <infants>0</infants>
28   </booking>
29   ...more bookings...
30 </bookings>

Содержание ответа

    /bookings - корневой элемент содержащий информацию о бронированиях.
    //booking - информации об одном бронировании.
    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 - информация о бронировании (аналогично поисковому запросу).
    //flight - информация об одном перелёте.
        operatingCarrier - код авиакомпании осуществляющей рейс.
        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+4.

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

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

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

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

См. также