Изменения

← Предыдущая правка

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

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|~~right~~50px|left]]~~Российский метапоисковик авиабилетов, работающий~~ Первый и крупнейший в Рунете ~~с начала 2009 года[1][нет~~ метапоиск дешевых авиабилетов. Производит поиск авиабилетов в ~~источнике]. В настоящий момент[когда?] пользователям доступны данные~~ 728 авиакомпаниях, 40 авиакассах и 5 ~~систем~~ системах бронирования~~: Amadeus, Travelport~~ (~~включающая «Галилео» и Worldspan~~GDS), «Сирена», 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~~ ===

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

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

| Пароль партнёра - пароль источника переходов модуля метрики.

|}

<u>Пример ответа</u>

<nemo_id>123123</nemo_id>

<id>JHKHVR</id>

<created_at>2012-05-02 00:02:01</created_at>

</flight>

</segment>

</booking>

...more bookings...

</bookings>

</syntaxhighlight>

</div>

<u>Описание структуры ответа</u>

/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>

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

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

* '''''PROCESSING''''' — забронирован;

* '''''PAID''''' — выписан;

* '''''CANCELLED''''' — аннулирован (по любым причинам).

Прибыль партнёра '''''profit''''' от данного бронирования в формате 00.99 (через точку).

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

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

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

* В случае расхождения фактических результатов поиска с ожидаемыми агентом или при возникновении других вопросов агент должен проанализировать поисковые логи, затем обратиться сначала в поддержку метапоисковой системы и выяснить возможные причины проблемного поведения в системе метапоиска, и только потом, если ситуация не прояснилась, обращаться в техподдержку {{NameSystem}}.

* Порядок отображения перелетов агентства в метапоисковых системах во многом зависит от настроек на стороне метапоиска, скорости ответа и ряда других параметров, на которые система {{NameSystem}} не может повлиять.

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

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

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

* В правилах ценообразования задается как десятичное представление процентной ставки - это доля от 1, например, если задано 0.05 - 5%. Метапоиск считает это значение из элемента MetasearchCommissionRate в результатах поиска.

<pre>

</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#Фильтры запросов | Фильтры запросов поиска]]

[[Категория:Модули]]

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

Дмитрий Поликарпов

182

правки