Изменения

Перейти к навигации Перейти к поиску

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

24 222 байта добавлено, 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|№}} таблицы источников переходов.
== Принципы работы с метапоисковиком Статистика заказов из метапоисков ===== API Авиа ===[[Файл:Статистика_заказов_из_метапоисков.png|400px|thumb|right|Статистика заказов из метапоисков]]=== Модуль В данном разделе можно получить данные по статистике метапоиска (по источнику переходов модуля метрики ====== Ценообразование 2) <u>за определенный период бронирования заказов</u> в виде файла данных в формате XML.0 ===
Доступ к разделу имеет менеджер головного агентства.
 
Можно получить статистику метапоиска как для агентства, так и для субагентств.
 
Для получения данных необходимо заполнить поля:
* {{Setting|Источник метрики}} — один из источников, настроенных в «Источниках переходов» модуля метрики;
* {{Setting|Дата с}} — начало периода бронирований;
* {{Setting|Дата по}} — окончание периода бронирований.
 
== Поддержка метапоисковиков ==
=== Aviasales.ru ===
[[Файл:Aviasales.ru.png|50px|left]]
Первый и крупнейший в Рунете метапоиск дешевых авиабилетов. Производит поиск авиабилетов в 728 авиакомпаниях, 40 авиакассах и 5 системах бронирования (GDS), используя наиболее современные технологии.
 
==== Принципы работы с метапоисковиком ====
AviaSales.ru рекомендует устанавливать срок действия HTTP cookie в 30 дней.
 
Для покупки билетов пользователь будет перенаправлен с метапоиска на сайт для бронирования заказа. Для отслеживания продаж и привязывания к посетителям может передаваться дополнительный GET параметр marker.
 
Маркер, переданный при переходе на бронирование, является частью информации о бронировании в статистике, и напрямую связан с параметром [[Модуль метрики#Маркер | marker]] из модуля метрики.
 
===== Статистика продаж =====
 
Пример запроса
<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#Фильтры запросов | Фильтры запросов поиска]]
 
[[Категория:Модули]]
[[Категория:Дополнительные модули]]

Навигация

'