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

Изменения

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

21 739 байт добавлено, 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]]Российский метапоисковик авиабилетов, работающий Первый и крупнейший в Рунете с начала 2009 года[1][нет метапоиск дешевых авиабилетов. Производит поиск авиабилетов в источнике]. В настоящий момент[когда?] пользователям доступны данные 728 авиакомпаниях, 40 авиакассах и 5 систем системах бронирования: Amadeus, Travelport (включающая «Галилео» и WorldspanGDS), «Сирена», Sabre; 45 агентств и 728 авиакомпаний[2][неавторитетный источник?][3] Услугами поиска пользуются около 200.000 уникальных пользователей ежедневно, эти пользователи делают около 500.000 поисковых запросов авиабилетов[4]. Офис компании находится на острове Пхукет (Таиланд)[5][неавторитетный источник?]используя наиболее современные технологии.
Aviasales==== Принципы работы с метапоисковиком ====AviaSales.ru был запущен рекомендует устанавливать срок действия HTTP cookie в январе 2008 года как удобная основателю RSS-лента. Однако сайт оказался интересен многим путешественникам, потому и вырос в самостоятельный проект. Вначале данные о спецпредложениях получались из открытых источников, с других сайтов и из рассылок авиакомпаний30 дней.
Сегодня AviaSales. Ru — первый и крупнейший в Рунете метапоиск дешевых авиабилетов. Мы ищем авиабилеты в 728 авиакомпаниях, 40 авиакассах и 5 системах Для покупки билетов пользователь будет перенаправлен с метапоиска на сайт для бронирования (GDS), используя наиболее современные технологии. Вы выбираете, где покупатьзаказа. Наш инновационный нанопоиск авиабилетов найдет для вас не только самый лучший вариант на конкретные даты, но Для отслеживания продаж и предложит другие даты, когда стоимость перелета привязывания к посетителям может быть ещё нижепередаваться дополнительный GET параметр marker. Выбирайте самые «дешёвые даты» в специальном разделе сайта
Использует агентский API NemoМаркер, переданный при переходе на бронирование, является частью информации о бронировании в статистике, и напрямую связан с параметром [[Модуль метрики#Маркер | marker]] из модуля метрики.
== Принципы работы с метапоисковиком ===Статистика продаж == API Авиа ====== Модуль метрики ====== Ценообразование 2.0 ===
Пример запроса
<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 0
 
Состояние брони '''''state''''' может принимать значения:
* '''''PROCESSING''''' — забронирован;
* '''''PAID''''' — выписан;
* '''''CANCELLED''''' — аннулирован (по любым причинам).
 
Прибыль партнёра '''''profit''''' от данного бронирования в формате 00.99 (через точку).
Размер прибыли партнера устанавливается для конкретного источника трафика в Модуле метрики и считается как процент от стоимости оплаченного заказа, включая комиссию платежного шлюза и апсейловые продажи. В последующем расчет прибыли может измениться. При возврате авиабилетов сумма ранее засчитанная как прибыль партнера (метапоисковой системы) должна подставляться с минусом в данном периоде.
 
Количество детей до 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|Комиссия метапоиску из файла ценообразования приоритетнее комиссии из настройки источника перехода. Устанавливая значение комиссии в ЦО меньше стандартного размера комиссии метапоиска может привести к проблеме взаимодействия с метапоиском.}}
 
Для подключения данной функции необходимо предварительное согласование с поставщиком метапоисковой системы.
== См. также ==
* [https://github.com/KosyanMedia/aviasales-self-service-api/wiki/API-RU Требования Aviasales.ru к API]
* [[Модуль метрики]]
* [[Ценообразование 2.0. Описание]]
* [[Ценообразование. Импорт правил]]
* [[Поиск_2.0#Фильтры запросов | Фильтры запросов поиска]]
 
[[Категория:Модули]]
[[Категория:Дополнительные модули]]
'