1206
правок
Изменения
Перейти к навигации
Перейти к поиску
=== Общие положения ===
Агрегация - слияние массива объектов с данными в один объект(в идеале) или в несколько объектов(если в объектах есть св-ва неподдающиеся агрегации).
Агрегации обычно поддаются свойства объектов с количественными значениями (кол-во времени, кол-во денег и т.д.). Объекты с такими свойствами будут автоматически агрегироваться при получении статистики.
Если в этих объектах есть свойство, обозначающее количество чего-нибудь, то в соответствующее свойство конечного объекта запишется сумма свойств исходных объектов.
Если в этих объектах есть свойство, обозначающее максимальное кол-во чего-нибудь за время формирования объекта, то в соответствующее свойство конечного объекта запишется максимальное значение из свойств исходных объектов.
Если в этих объектах есть свойство, обозначающее минимальное кол-во чего-нибудь за время формирования объекта, то в соответствующее свойство конечного объекта запишется минимальное значение из свойств исходных объектов.
Если в этих объектах есть свойство, обозначающее среднее кол-во чего-нибудь за время формирования объекта, то в соответствующее свойство конечного объекта запишется усреднённое значение свойств исходных объектов.
Многие свойства не всегда поддаются агрегации (например названия или идентификаторы чего-нибудь), их нельзя просуммировать, или взять среднее, максимальное или минимальное значение. Такие свойства аггрегируются только, когда у них одинаковые значения; в свойство конечного объекта запишется это самое значение.
Объекты с такими свойствами не агрегируются, даже если в этих объектах есть свойства, поддающиеся агрегации.
Однако если нам всё же необходимо проагрегировать объекты с неагрегируемыми свойстами, то следует явно указать эти свойства.
При агрегации таких объектов все неагрегируемые свойства, указанные нами в результатирующем объекте останутся без значений.
==== Общее о методах получения статистики ====
Во всех запросах получения статистики присутствуют следующие параметры:
* '''DateStart''' - Дата начала временного промежутка получения статистики в формате dd.mm.yyyy. Тип данных - строка.
* '''DateEnd''' - Дата окончания временного промежутка получения статистики в формате dd.mm.yyyy. Тип данных - строка.
Эти две даты по сути являются временным промежутком по которому получается статистика.
* '''GroupBy''' - Временная единица, по которой следует группировать данные. Например, если выбран параметр группировки по дням, то записи статистики из одного дня будут агрегироваться с другими записями из этого же дня и в результате будут возвращены эти проагрегированные записи. Тип данных - перечисление. Возможные значения:
** Hour - По часам.
** Day - По дням.
** Week - По неделям.
** Month - По месяцам.
** Year - По годам.
=== Получение статистики поисков ===
===== Запрос =====
* '''DateStart'''
* '''DateEnd'''
* '''GroupBy'''
* '''SubAgenciesIDs''' - Идентификаторы субагентств, по которым получаем статистику. Тип данных - массив элементов ID.
* '''SubAgenciesIDs.ID''' - Идентификатор субагента. Тип данных - целое 32-битное число.
* '''AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).
* '''AggregateBy''' - Агрегировать данные. тип данных - перечисление. Возможные значения (может быть несколько через пробел)(может быть пустым):
** None - Не агрегировать
** Agencies (1) по агентствам
** SubAgencies (2) по субагентствам
** Users (4) по пользователям
** Requisites (8) по реквизитам
** SuppliersAndRequisites (24) по поставщикам и реквизитам
* '''SortParams''' - Параметры сортировки результатов статистики. Можно указать до двух параметров. Тип данных - массив элементов SortParam.
* '''SortParams.SortParam''' - Параметр сортировки элементов. Тип данных - сложный.
* '''SortParams.SortParam.SortValue''' - Поле, по которому элементы будут сортироваться. Тип данных - перечисление. Возможные значения:
** DateTime (0) по дате
** SearchCount (1) по количеству поисков
* '''SortParams.SortParam.OrderBy''' - Порядок сортировки. Тип данных - перечисление. Возможные значения (может быть пустым):
** Asc (0) по возрастанию
** Desc (1) по убыванию
* '''Top''' - Ограничение сверху количества элементов в результате. тип данных - целое 32-битное число.
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
===== Пример запроса (XML)=====
<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;">
<GetSearchStatistics>
<request>
<RequestBody>
<DateStart>04.08.2014</DateStart>
<DateEnd>12.08.2014</DateEnd>
<GroupBy>Week</GroupBy>
<!--Optional:-->;
<SubAgenciesIDs>
<!--Zero or more repetitions:-->;
<ID></ID><
</SubAgenciesIDs></font>
<!--Optional:-->
<AgencyID></AgencyID>
<!--Optional:-->
<AggregateBy></font>SuppliersAndRequisites</AggregateBy>
<!--Optional:-->;
<SortParams>
<!--Zero or more repetitions:-->;
<SortParam>
<SortValue>DateTime</SortValue>
<OrderBy>Desc</OrderBy>
</SortParam>
<SortParam>
<SortValue>SearchCount</SortValue>
<OrderBy>Asc</OrderBy>
</SortParam>
</SortParams>
<!--Optional:-->;
<Top>2</Top>
</RequestBody>
</request>
</GetSearchStatistics>
</syntaxhighlight>
</div>
</div>
===== Ответ =====
* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов SearchStatsItem.
* '''StatisticsItems.SearchStatsItem''' - Объект статистики поисков. Тип данных - сложный.
* '''StatisticsItems.SearchStatsItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения:
** Avia (0) авиа услуга (перелёт)
** Hotel (1) отель
** Rail (2) ж/д услуга
** Other (33) прочие услуги неизвестного типа
* '''StatisticsItems.SearchStatsItem.DateTime''' - Время начала периода сбора статистики.
* '''StatisticsItems.SearchStatsItem.UserID''' - Идентификатор пользователя. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.SearchStatsItem.AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.SearchStatsItem.SubAgencyID''' - Идентификатор субагенства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.SearchStatsItem.Supplier''' - Поставщик. Тип данных - перечисление. Возможные значения:
* '''StatisticsItems.SearchStatsItem.SearchRequisites''' - Поисковые реквизиты. Тип данных - строка.
* '''StatisticsItems.SearchStatsItem.SearchCount''' - Число поисков. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchStatsItem.SearchWithErrorCount''' - Число поисков с ошибками. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchStatsItem.EmptySearchCount''' - Число поисков без результатов. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchStatsItem.AvgResultsCount''' - Среднее кол-во результатов в поиске. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchStatsItem.MinResultsCount''' - Минимальное кол-во результатов в поиске. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchStatsItem.MaxResultsCount''' - Максимальное кол-во результатов в поиске. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchStatsItem.AvgSearchDuration''' - Средняя продолжительность поиска. Тип данных - TimeSpan.
* '''StatisticsItems.SearchStatsItem.MinSearchDuration''' - Минимальная продолжительность поиска. Тип данных - TimeSpan.
* '''StatisticsItems.SearchStatsItem.MaxSearchDuration''' - Максимальная продолжительность поиска. Тип данных - TimeSpan.
* '''StatisticsItems.SearchStatsItem.Supplier''' - Название поставщика. Тип данных - строка.
* '''StatisticsItems.SearchStatsItem.SearchRequisites''' - Поисковые реквизиты. Тип данных - строка.
* '''StatisticsItems.SearchStatsItem.GDSScans''' - Число запросов к ГДС во время поиска. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchStatsItem.CacheSearchCount''' - Число поисков в кэше. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchStatsItem.AvgGDSSearchDuration''' - Средняя продолжительность поиска в ГДС. Тип данных - TimeSpan.
* '''StatisticsItems.SearchStatsItem.MinGDSSearchDuration''' - Минимальная продолжительность поиск в ГДС. Тип данных - TimeSpan.
* '''StatisticsItems.SearchStatsItem.MaxGDSSearchDuration''' - Максимальная продолжительность поиска в ГДС. Тип данных - TimeSpan.
===== Пример ответа (XML)=====
<GetSearchStatisticsResponse>
<GetSearchStatisticsResult>
<RequestID>62393</RequestID>
<ResponseBody>
<StatisticsItems>
<SearchStatsItem>
<ServiceType>Avia</ServiceType>
<DateTime>2014-08-11T00:00:00</DateTime>
<UserID>2</UserID>
<AgencyID>2</AgencyID>
<SubAgencyID>2</SubAgencyID>
<font color="blue"><Supplier <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SearchRequisites <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SearchCount></font>20575<font color="blue"></SearchCount></font>
<font color="blue"><SearchWithErrorCount></font>0<font color="blue"></SearchWithErrorCount></font>
<font color="blue"><EmptySearchCount></font>924<font color="blue"></EmptySearchCount></font>
<font color="blue"><GDSScans></font>468<font color="blue"></GDSScans></font>
<font color="blue"><CacheSearchCount></font>746<font color="blue"></CacheSearchCount></font>
<font color="blue"><AvgResultsCount></font>9<font color="blue"></AvgResultsCount></font>
<font color="blue"><MinResultsCount></font>1<font color="blue"></MinResultsCount></font>
<font color="blue"><MaxResultsCount></font>19<font color="blue"></MaxResultsCount></font>
<font color="blue"><AvgSearchDuration></font>PT0.4400852S<font color="blue"></AvgSearchDuration></font>
<font color="blue"><MinSearchDuration></font>PT0.001S<font color="blue"></MinSearchDuration></font>
<font color="blue"><MaxSearchDuration></font>PT4.2582435S<font color="blue"></MaxSearchDuration></font>
<font color="blue"><AvgGDSSearchDuration></font>PT0S<font color="blue"></AvgGDSSearchDuration></font>
<font color="blue"><MinGDSSearchDuration></font>PT0S<font color="blue"></MinGDSSearchDuration></font>
<font color="blue"><MaxGDSSearchDuration></font>PT0S<font color="blue"></MaxGDSSearchDuration></font>
<font color="blue"></SearchStatsItem></font>
<font color="blue"><SearchStatsItem></font>
<font color="blue"><ServiceType></font>Avia<font color="blue"></ServiceType></font>
<font color="blue"><DateTime></font>2014-08-04T00:00:00<font color="blue"></DateTime></font>
<font color="blue"><UserID></font>2<font color="blue"></UserID></font>
<font color="blue"><AgencyID></font>2<font color="blue"></AgencyID></font>
<font color="blue"><SubAgencyID></font>2<font color="blue"></SubAgencyID></font>
<font color="blue"><Supplier <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SearchRequisites <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SearchCount></font>341322<font color="blue"></SearchCount></font>
<font color="blue"><SearchWithErrorCount></font>0<font color="blue"></SearchWithErrorCount></font>
<font color="blue"><EmptySearchCount></font>17804<font color="blue"></EmptySearchCount></font>
<font color="blue"><GDSScans></font>7572<font color="blue"></GDSScans></font>
<font color="blue"><CacheSearchCount></font>11434<font color="blue"></CacheSearchCount></font>
<font color="blue"><AvgResultsCount></font>9<font color="blue"></AvgResultsCount></font>
<font color="blue"><MinResultsCount></font>1<font color="blue"></MinResultsCount></font>
<font color="blue"><MaxResultsCount></font>19<font color="blue"></MaxResultsCount></font>
<font color="blue"><AvgSearchDuration></font>PT0.5500934S<font color="blue"></AvgSearchDuration></font>
<font color="blue"><MinSearchDuration></font>PT0.001S<font color="blue"></MinSearchDuration></font>
<font color="blue"><MaxSearchDuration></font>PT3.5072006S<font color="blue"></MaxSearchDuration></font>
<font color="blue"><AvgGDSSearchDuration></font>PT0S<font color="blue"></AvgGDSSearchDuration></font>
<font color="blue"><MinGDSSearchDuration></font>PT0S<font color="blue"></MinGDSSearchDuration></font>
<font color="blue"><MaxGDSSearchDuration></font>PT0S<font color="blue"></MaxGDSSearchDuration></font>
<font color="blue"></SearchStatsItem></font>
<font color="blue"></StatisticsItems></font>
<font color="blue"></ResponseBody></font>
<font color="blue"></GetSearchStatisticsResult></font>
<font color="blue"></GetSearchStatisticsResponse></font>
</code>
=== Получение количества поисков. (Облегчённый вариант запроса на получение статистики поисков) ===
===== Запрос =====
===== Пример запроса (XML)=====
<code>
<font color="blue"><GetSearchCountStatistics></font>
<font color="blue"><request></font>
<font color="blue"><RequestBody></font>
<font color="blue"><DateStart></font>01.08.2014<font color="blue"></DateStart></font>
<font color="blue"><DateEnd></font>13.08.2014<font color="blue"></DateEnd></font>
<font color="blue"><GroupBy></font>Month<font color="blue"></GroupBy></font>
<font color="blue"><SubAgencyId></font>4<font color="blue"></SubAgencyId></font>
<font color="blue"></RequestBody></font>
<font color="blue"></request></font>
<font color="blue"></GetSearchCountStatistics></font>
</code>
===== Ответ =====
* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов SearchCountItem.
* '''StatisticsItems.SearchCountItem''' - Объект статистики количества поисков. Тип данных - сложный.
* '''StatisticsItems.SearchCountItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.
* '''StatisticsItems.SearchCountItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру '''''StatisticsItems.SearchStatsItem.ServiceType''''' из [[#Ответ|ответа на получение статистики поисков]].
* '''StatisticsItems.SearchCountItem.Supplier''' - Поставщик. Тип данных - строка.
* '''StatisticsItems.SearchCountItem.SearchRequisites''' - Реквизиты поиска. Тип данных - строка.
* '''StatisticsItems.SearchCountItem.GDSScans''' - Количество поисковых запросов к ГДС. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchCountItem.CacheSearchCount''' - Количество поисков в кеше (поиски без обращений к ГДС). Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchCountItem.SearchCount''' - Общее количество поисков. Тип данных - целое 32-битное число.
===== Пример ответа (XML)=====
<code>
<font color="blue"><GetSearchCountStatisticsResponse></font>
<font color="blue"><GetSearchCountStatisticsResult></font>
<font color="blue"><RequestID></font>5969455<font color="blue"></RequestID></font>
<font color="blue"><ResponseBody></font>
<font color="blue"><StatisticsItems></font>
<font color="blue"><SearchCountItem></font>
<font color="blue"><DateTime></font>2014-08-01T00:00:00<font color="blue"></DateTime></font>
<font color="blue"><ServiceType></font>Avia<font color="blue"></ServiceType></font>
<font color="blue"><Supplier></font>Sabre<font color="blue"></Supplier></font>
<font color="blue"><SearchRequisites></font>FJ9F<font color="blue"></SearchRequisites></font>
<font color="blue"><GDSScans></font>0<font color="blue"></GDSScans></font>
<font color="blue"><CacheSearchCount></font>4<font color="blue"></CacheSearchCount></font>
<font color="blue"><SearchCount></font>4<font color="blue"></SearchCount></font>
<font color="blue"></SearchCountItem></font>
<font color="blue"></StatisticsItems></font>
<font color="blue"></ResponseBody></font>
<font color="blue"></GetSearchCountStatisticsResult></font>
<font color="blue"></GetSearchCountStatisticsResponse></font>
</code>
=== Получение статистики направлений===
===== Запрос =====
* '''DateStart'''
* '''DateEnd'''
* '''GroupBy'''
* '''SubAgenciesIDs''' - Идентификаторы субагентств, по которым получаем статистику. Тип данных - массив элементов ID.
* '''SubAgenciesIDs.ID''' - Идентификатор субагента. Тип данных - целое 32-битное число.
* '''AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).
* '''AggregateBy''' - По каким полям следует агрегировать объекты статистики. Тип данных - перечисление. Возможные значения (может быть несколько через пробел)(может быть пустым):
** None (0) не аггрегировать объекты с неагрегируемыми свойствами
** Agencies (1) по агенствам
** SupAgencies (2) по субагенствам
** Users (4) по пользователям.
** RequisitesPackages (8) по пакетам реквизитов
** Suppliers (16) по поставщикам
** DestTypes (32) по типам направлений
** BookingPlaces (64) по местам бронирования
** DepPoints (128) по пунктам отправления
** ArrPoints (256) по пунктам прибытия
* '''SortParams''' - Параметры сортировки результатов статистики. Тип данных - массив элементов SortParam. Аналогичен параметру '''''SortParams''''' из [[#Запрос|запроса на получение статистики поисков]].
* '''Top''' - Ограничение сверху количества элементов в результате. тип данных - целое 32-битное число.
===== Пример запроса (XML)=====
<code>
<font color="blue"><GetDestinationsStatistics></font>
<font color="blue"><request></font>
<font color="blue"><RequestBody></font>
<font color="blue"><DateStart></font>10.08.2014<font color="blue"></DateStart></font>
<font color="blue"><DateEnd></font>14.08.2014<font color="blue"></DateEnd></font>
<font color="blue"><GroupBy></font>Day<font color="blue"></GroupBy></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><SubAgenciesIDs></font>
<font color="green"><!--Zero or more repetitions:--></font>
<font color="blue"><ID></font>2<font color="blue"></ID></font>
<font color="blue"></SubAgenciesIDs></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><AgencyID></font>2<font color="blue"></AgencyID></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><AggregateBy></font>RequisitesPackages Suppliers DestTypes BookingPlaces DepPoints ArrPoints<font color="blue"></AggregateBy></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><SortParams></font>
<font color="green"><!--Zero or more repetitions:--></font>
<font color="blue"><SortParam></font>
<font color="blue"><SortValue></font>DateTime<font color="blue"></SortValue></font>
<font color="blue"><OrderBy></font>Desc<font color="blue"></OrderBy></font>
<font color="blue"></SortParam></font>
<font color="blue"><SortParam></font>
<font color="blue"><SortValue></font>SearchCount<font color="blue"></SortValue></font>
<font color="blue"><OrderBy></font>Asc<font color="blue"></OrderBy></font>
<font color="blue"></SortParam></font>
<font color="blue"></SortParams></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><Top></font>2<font color="blue"></Top></font>
<font color="blue"></RequestBody></font>
<font color="blue"></request></font>
<font color="blue"></GetDestinationsStatistics></font>
</code>
===== Ответ =====
* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов DestinationStatsItem.
* '''StatisticsItems.DestinationStatsItem''' - Объект статистики направлений. Тип данных - сложный.
* '''StatisticsItems.DestinationStatsItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру '''''StatisticsItems.SearchStatsItem.ServiceType''''' из [[#Ответ|ответа на получение статистики поисков]].
* '''StatisticsItems.DestinationStatsItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.
* '''StatisticsItems.DestinationStatsItem.UserID''' - Идентификатор пользователя. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.DestinationStatsItem.AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.DestinationStatsItem.SubAgencyID''' - Идентификатор субагенства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.DestinationStatsItem.Supplier''' - Поставщик. Тип данных - перечисление. Возможные значения аналогичны параметру
* '''StatisticsItems.DestinationStatsItem.DeparturePoint''' - Пункт отправления. Тип данных - сложный.
* '''StatisticsItems.DestinationStatsItem.DeparturePoint.TransportPointCode''' - Код пункта. Тип данных - строка.
* '''StatisticsItems.DestinationStatsItem.DeparturePoint.TransportPointCodeType''' - Тип пункта. Тип данных - перечисление. Возможные значения:
** IATAAirportCode (0) ИАТА код аэропорта
* '''StatisticsItems.DestinationStatsItem.DeparturePoint.TransportSubPointCode''' - Дополнительный код пункта, например, терминал в аэропорту. Тип данных - строка.
* '''StatisticsItems.DestinationStatsItem.DeparturePoint.CityCode''' - Код города. Тип данных - строка.
* '''StatisticsItems.DestinationStatsItem.ArrivalPoint''' - Пункт прибытия. Тип данных - сложный, аналогичен параметру '''''StatisticsItems.DestinationStatsItem.DeparturePoint'''''.
* '''StatisticsItems.DestinationStatsItem.FlightDirectionType''' - Тип направления. Тип данных - перечисление (может быть пустым). Возможные значения:
** OW (0) В одну сторону
** RT (1) Туда - обратно
** CT (2) Сложный маршрут
** SingleOJ (3) Вылет из точки А в точку Б и возврат в точку В. Т.е. есть разрыв между ап прилета и вылета
** DoubleOJ (4) Как single OJ, но есть 2 разрыва между ап прилета и вылета.
** hRT (5) HalfRT, он же RT/2
** mOW (6) MultiOW, он же OW+OW+
* '''StatisticsItems.DestinationStatsItem.SearchCount''' - Число поисков. Тип данных - целое 32-битное число.
* '''StatisticsItems.DestinationStatsItem.AvgResultsCount''' - Среднее число результатов в поиске. Тип данных - целое 32-битное число.
* '''StatisticsItems.DestinationStatsItem.MinResultsCount''' - Минимальное число результатов в поиске. Тип данных - целое 32-битное число.
* '''StatisticsItems.DestinationStatsItem.MaxResultsCount''' - Максимальное число результатов в поиске. Тип данных - целое 32-битное число.
* '''StatisticsItems.DestinationStatsItem.SuccessBooksCount''' - Количество успешно созданных броней. Тип данных - целое 32-битное число.
* '''StatisticsItems.DestinationStatsItem.FailedBooksCount''' - Количество отменённых броней и неудачных попыток бронирования. Тип данных - целое 32-битное число.
* '''StatisticsItems.DestinationStatsItem.MadeBooksCount''' - Количество выполненных броней (не отменённые до начала выполнения). Тип данных - целое 32-битное число.
* '''StatisticsItems.DestinationStatsItem.BookingPlace''' - Место создания брони. Тип данных - перечисление (может быть пустым). Возможные значения:
** UNKNOWN - неизвестно.
* '''StatisticsItems.DestinationStatsItem.RequisitesPackageID''' - Идентификатор пакета реквизитов бронирования (может быть пустым). Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.DestinationStatsItem.AdultPassengerCount''' - Число забронированных пассажиров - взрослых. Тип данных - целое 32-битное число.
* '''StatisticsItems.DestinationStatsItem.ChildPassengerCount''' - Число забронированных пассажиров - детей. Тип данных - целое 32-битное число.
* '''StatisticsItems.DestinationStatsItem.TotalPassengersCount''' - Общее число забронированных пассажиров. Тип данных - целое 32-битное число.
===== Пример ответа (XML)=====
<code>
<font color="blue"><GetDestinationsStatisticsResponse></font>
<font color="blue"><GetDestinationsStatisticsResult></font>
<font color="blue"><RequestID></font>62403<font color="blue"></RequestID></font>
<font color="blue"><ResponseBody></font>
<font color="blue"><StatisticsItems></font>
<font color="blue"><DestinationStatsItem></font>
<font color="blue"><ServiceType></font>Avia<font color="blue"></ServiceType></font>
<font color="blue"><DateTime></font>2014-08-12T00:00:00<font color="blue"></DateTime></font>
<font color="blue"><UserID></font>2<font color="blue"></UserID></font>
<font color="blue"><AgencyID></font>2<font color="blue"></AgencyID></font>
<font color="blue"><SubAgencyID></font>2<font color="blue"></SubAgencyID></font>
<font color="blue"><Supplier <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><DeparturePoint <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><ArrivalPoint <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><FlightDirectionType <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SearchCount></font>291<font color="blue"></SearchCount></font>
<font color="blue"><AvgResultsCount></font>10<font color="blue"></AvgResultsCount></font>
<font color="blue"><MinResultsCount></font>0<font color="blue"></MinResultsCount></font>
<font color="blue"><MaxResultsCount></font>19<font color="blue"></MaxResultsCount></font>
<font color="blue"><SuccessBooksCount></font>0<font color="blue"></SuccessBooksCount></font>
<font color="blue"><FailedBooksCount></font>0<font color="blue"></FailedBooksCount></font>
<font color="blue"><MadeBooksCount></font>0<font color="blue"></MadeBooksCount></font>
<font color="blue"><BookingPlace <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><RequisitesPackageID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><AdultPassengerCount></font>0<font color="blue"></AdultPassengerCount></font>
<font color="blue"><ChildPassengerCount></font>0<font color="blue"></ChildPassengerCount></font>
<font color="blue"><TotalPassengersCount></font>0<font color="blue"></TotalPassengersCount></font>
<font color="blue"></DestinationStatsItem></font>
<font color="blue"><DestinationStatsItem></font>
<font color="blue"><ServiceType></font>Avia<font color="blue"></ServiceType></font>
<font color="blue"><DateTime></font>2014-08-11T00:00:00<font color="blue"></DateTime></font>
<font color="blue"><UserID></font>2<font color="blue"></UserID></font>
<font color="blue"><AgencyID></font>2<font color="blue"></AgencyID></font>
<font color="blue"><SubAgencyID></font>2<font color="blue"></SubAgencyID></font>
<font color="blue"><Supplier <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><DeparturePoint <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><ArrivalPoint <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><FlightDirectionType <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SearchCount></font>923<font color="blue"></SearchCount></font>
<font color="blue"><AvgResultsCount></font>9<font color="blue"></AvgResultsCount></font>
<font color="blue"><MinResultsCount></font>0<font color="blue"></MinResultsCount></font>
<font color="blue"><MaxResultsCount></font>19<font color="blue"></MaxResultsCount></font>
<font color="blue"><SuccessBooksCount></font>0<font color="blue"></SuccessBooksCount></font>
<font color="blue"><FailedBooksCount></font>0<font color="blue"></FailedBooksCount></font>
<font color="blue"><MadeBooksCount></font>0<font color="blue"></MadeBooksCount></font>
<font color="blue"><BookingPlace <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><RequisitesPackageID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><AdultPassengerCount></font>0<font color="blue"></AdultPassengerCount></font>
<font color="blue"><ChildPassengerCount></font>0<font color="blue"></ChildPassengerCount></font>
<font color="blue"><TotalPassengersCount></font>0<font color="blue"></TotalPassengersCount></font>
<font color="blue"></DestinationStatsItem></font>
<font color="blue"></StatisticsItems></font>
<font color="blue"></ResponseBody></font>
<font color="blue"></GetDestinationsStatisticsResult></font>
<font color="blue"></GetDestinationsStatisticsResponse></font>
</code>
=== Получение статистики LookToBook ===
===== Запрос =====
* '''DateStart'''
* '''DateEnd'''
* '''GroupBy'''
* '''SubAgenciesIDs''' - Идентификаторы субагентств, по которым получаем статистику. Тип данных - массив элементов ID.
* '''SubAgenciesIDs.ID''' - Идентификатор субагента. Тип данных - целое 32-битное число.
* '''AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).
* '''AggregateBy''' - По каким полям следует агрегировать объекты статистики. Тип данных - перечисление. Возможные значения (может быть несколько через пробел)(может быть пустым):
** None (0) не аггрегировать объекты с неагрегируемыми свойствами
** Agencies (1) по агенствам
** SupAgencies (2) по субагенствам
** UserTypes (4) по типам пользователей (анонимы и зарегистрированные)
** DepPoints (8) по пунктам отправления
** ArrPoints (16) по пунктам прибытия
** BookingPlaces (32) по местам бронирования
** RequisitesPackages (64) по пакетам реквизитов
===== Пример запроса (XML)=====
<code>
<font color="blue"><GetLookToBookStatistics></font>
<font color="blue"><request></font>
<font color="blue"><RequestBody></font>
<font color="blue"><DateStart></font>28.07.2014<font color="blue"></DateStart></font>
<font color="blue"><DateEnd></font>10.08.2014<font color="blue"></DateEnd></font>
<font color="blue"><GroupBy></font>Week<font color="blue"></GroupBy></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><SubAgenciesIDs></font>
<font color="green"><!--Zero or more repetitions:--></font>
<font color="blue"><ID></font>2<font color="blue"></ID></font>
<font color="blue"></SubAgenciesIDs></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><AgencyID></font>2<font color="blue"></AgencyID></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><AggregateBy></font>DepPoints ArrPoints<font color="blue"></AggregateBy></font>
<font color="blue"></RequestBody></font>
<font color="blue"></request></font>
<font color="blue"></GetLookToBookStatistics></font>
</code>
===== Ответ =====
* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов LookToBookStatsItem.
* '''StatisticsItems.LookToBookStatsItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру
* '''StatisticsItems.LookToBookStatsItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.
* '''StatisticsItems.LookToBookStatsItem.IsAnonimUser''' - Анонимные пользователи. Тип данных - булев (может быть пустым).
* '''StatisticsItems.LookToBookStatsItem.AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.LookToBookStatsItem.SubAgencyID''' - Идентификатор субагенства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.LookToBookStatsItem.RequisitesPackageID''' - Идентификатор пакета реквизитов бронирования (может быть пустым). Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.LookToBookStatsItem.BookingPlace''' - Место создания брони. Тип данных - перечисление (может быть пустым). Возможные значения аналогичны параметру '''StatisticsItems.DestinationStatsItem.BookingPlace''' из [[#Ответ_3|ответа на получение статистики направлений]].
* '''StatisticsItems.LookToBookStatsItem.DepartureCityCode''' - Код города отправления. Тип данных - строка.
* '''StatisticsItems.LookToBookStatsItem.ArrivalCityCode''' - Код города прибытия. Тип данных - строка.
* '''StatisticsItems.LookToBookStatsItem.LookToBookCoef''' - Отношение поисков к броням. Рассчитывается по формуле (ЕСЛИ кол-во броней > 0, ТО кол-во поисков / кол-во броней, ИНАЧЕ кол-во поисков). Тип данных - дробное число.
===== Пример ответа (XML)=====
<code>
<font color="blue"><GetLookToBookStatisticsResponse></font>
<font color="blue"><GetLookToBookStatisticsResult></font>
<font color="blue"><RequestID></font>62429<font color="blue"></RequestID></font>
<font color="blue"><ResponseBody></font>
<font color="blue"><StatisticsItems></font>
<font color="blue"><LookToBookStatsItem></font>
<font color="blue"><ServiceType></font>Avia<font color="blue"></ServiceType></font>
<font color="blue"><DateTime></font>2014-08-04T00:00:00<font color="blue"></DateTime></font>
<font color="blue"><IsAnonimUser></font>false<font color="blue"></IsAnonimUser></font>
<font color="blue"><AgencyID></font>2<font color="blue"></AgencyID></font>
<font color="blue"><SubAgencyID></font>2<font color="blue"></SubAgencyID></font>
<font color="blue"><RequisitesPackageID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><BookingPlace <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><DepartureCityCode <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><ArrivalCityCode <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><LookToBookCoef></font>18749<font color="blue"></LookToBookCoef></font>
<font color="blue"></LookToBookStatsItem></font>
<font color="blue"><LookToBookStatsItem></font>
<font color="blue"><ServiceType></font>Avia<font color="blue"></ServiceType></font>
<font color="blue"><DateTime></font>2014-07-28T00:00:00<font color="blue"></DateTime></font>
<font color="blue"><IsAnonimUser></font>false<font color="blue"></IsAnonimUser></font>
<font color="blue"><AgencyID></font>2<font color="blue"></AgencyID></font>
<font color="blue"><SubAgencyID></font>2<font color="blue"></SubAgencyID></font>
<font color="blue"><RequisitesPackageID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><BookingPlace <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><DepartureCityCode <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><ArrivalCityCode <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><LookToBookCoef></font>20<font color="blue"></LookToBookCoef></font>
<font color="blue"></LookToBookStatsItem></font>
<font color="blue"></StatisticsItems></font>
<font color="blue"></ResponseBody></font>
<font color="blue"></GetLookToBookStatisticsResult></font>
<font color="blue"></GetLookToBookStatisticsResponse></font>
</code>
=== Получение статистики BookToCancel ===
===== Запрос =====
Запрос аналогичен запросу на получение статистики LookToBook
===== Пример запроса (XML)=====
<code>
<font color="blue"><GetBookToCancelStatistics></font>
<font color="blue"><request></font>
<font color="blue"><RequestBody></font>
<font color="blue"><DateStart></font>12.08.2014<font color="blue"></DateStart></font>
<font color="blue"><DateEnd></font>12.08.2014<font color="blue"></DateEnd></font>
<font color="blue"><GroupBy></font>Day<font color="blue"></GroupBy></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><SubAgenciesIDs></font>
<font color="green"><!--Zero or more repetitions:--></font>
<font color="blue"><ID></font>2<font color="blue"></ID></font>
<font color="blue"></SubAgenciesIDs></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><AgencyID></font>2<font color="blue"></AgencyID></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><AggregateBy></font>DepPoints ArrPoints<font color="blue"></AggregateBy></font>
<font color="blue"></RequestBody></font>
<font color="blue"></request></font>
<font color="blue"></GetBookToCancelStatistics></font>
</code>
===== Ответ =====
* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов BookToCancelStatsItem.
* '''StatisticsItems.BookToCancelStatsItem.ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру
* '''StatisticsItems.BookToCancelStatsItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.
* '''StatisticsItems.BookToCancelStatsItem.IsAnonimUser''' - Анонимные пользователи. Тип данных - булев (может быть пустым).
* '''StatisticsItems.BookToCancelStatsItem.AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.BookToCancelStatsItem.SubAgencyID''' - Идентификатор субагенства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.BookToCancelStatsItem.RequisitesPackageID''' - Идентификатор пакета реквизитов бронирования (может быть пустым). Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.BookToCancelStatsItem.BookingPlace''' - Место создания брони. Тип данных - перечисление (может быть пустым). Возможные значения аналогичны параметру '''StatisticsItems.DestinationStatsItem.BookingPlace''' из [[#Ответ_2|ответа на получение статистики направлений]].
* '''StatisticsItems.BookToCancelStatsItem.DepartureCityCode''' - Код города отправления. Тип данных - строка.
* '''StatisticsItems.BookToCancelStatsItem.ArrivalCityCode''' - Код города прибытия. Тип данных - строка.
* '''StatisticsItems.BookToCancelStatsItem.BookToCancelCoef''' - Отношение броней к отменённым броням. Рассчитывается по формуле (ЕСЛИ кол-во броней > 0 И кол-во отменённых броней > 0, ТО кол-во броней / кол-во отменённых броней, ИНАЧЕ 0). Тип данных - дробное число.
===== Пример ответа (XML)=====
<code>
<font color="blue"><GetBookToCancelStatisticsResponse></font>
<font color="blue"><GetBookToCancelStatisticsResult></font>
<font color="blue"><RequestID></font>62437<font color="blue"></RequestID></font>
<font color="blue"><ResponseBody></font>
<font color="blue"><StatisticsItems></font>
<font color="blue"><BookToCancelStatsItem></font>
<font color="blue"><ServiceType></font>Avia<font color="blue"></ServiceType></font>
<font color="blue"><DateTime></font>2014-08-12T00:00:00<font color="blue"></DateTime></font>
<font color="blue"><IsAnonimUser></font>false<font color="blue"></IsAnonimUser></font>
<font color="blue"><AgencyID></font>2<font color="blue"></AgencyID></font>
<font color="blue"><SubAgencyID></font>2<font color="blue"></SubAgencyID></font>
<font color="blue"><RequisitesPackageID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><BookingPlace <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><DepartureCityCode <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><ArrivalCityCode <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><BookToCancelCoef></font>0<font color="blue"></BookToCancelCoef></font>
<font color="blue"></BookToCancelStatsItem></font>
<font color="blue"></StatisticsItems></font>
<font color="blue"></ResponseBody></font>
<font color="blue"></GetBookToCancelStatisticsResult></font>
<font color="blue"></GetBookToCancelStatisticsResponse></font>
</code>
=== Получение ТОПов поисковых запросов ===
Позволяет делать выборки, отвечающие на вопросы:<br/>
Какие аэропорты или страны отправления чаще всего искали?<br/>
Какие аэропорты или страны прибытия чаще всего искали?<br/>
У каких агентств, субагентств или пользователей больше всего поисков?
===== Запрос =====
* '''DateStart'''
* '''DateEnd'''
* '''GroupBy'''
* '''SubAgenciesIDs''' - Идентификаторы субагентств, по которым получаем статистику. Тип данных - массив элементов ID.
* '''SubAgenciesIDs.ID''' - Идентификатор субагента. Тип данных - целое 32-битное число.
* '''AgencyID''' - Идентификатор агенства. Тип данных - целое 32-битное число (может быть пустым).
* '''ServiceType''' - Тип услуги (авиа/отели/...). Тип данных - перечисление. Возможные значения аналогичны параметру '''''StatisticsItems.SearchStatsItem.ServiceType''''' из [[#Ответ|ответа на получение статистики поисков]].
* '''TopBy''' - Определяет по какому параметру формируется ТОП поисковых запросов. Тип данных - перечисление. Возможные значения:
** DepPoint - по точке отправления
** ArrPoint - по точке прибытия
** DepCountry - по стране отправления
** ArrCountry - по стране прибытия
** Agency - по агентствам
** SubAgency - по субагентствам
** User - по пользователям
* '''Top''' - Ограничение количества результатов сверху. Тип данных - целое 32-битное число.
===== Пример запроса (XML)=====
<code>
<font color="blue"><GetSearchTopStatistics></font>
<font color="blue"><request></font>
<font color="blue"><RequestBody></font>
<font color="blue"><DateStart></font>01.12.2014<font color="blue"></DateStart></font>
<font color="blue"><DateEnd></font>31.12.2014<font color="blue"></DateEnd></font>
<font color="blue"><GroupBy></font>Month<font color="blue"></GroupBy></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><SubAgenciesIDs></font>
<font color="blue"><ID></font>5<font color="blue"></ID></font>
<font color="blue"><ID></font>6<font color="blue"></ID></font>
<font color="blue"></SubAgenciesIDs></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><AgencyID></font>4<font color="blue"></AgencyID></font>
<font color="green"><!--Optional:--></font>
<font color="green"><!<ServiceType>Avia</ServiceType>></font>
<font color="blue"><TopBy></font>DepCountry<font color="blue"></TopBy></font>
<font color="green"><!--Optional:--></font>
<font color="blue"><Top></font>2<font color="blue"></Top></font>
<font color="blue"></RequestBody></font>
<font color="blue"></request></font>
<font color="blue"></GetSearchTopStatistics></font>
</code>
===== Ответ =====
* '''StatisticsItems''' - Объекты статистики. Тип данных - массив элементов
* '''StatisticsItems.SearchTopStatsItem.DateTime''' - Дата и время начала периода, по которому группируется статистика. Формат yyyy-MM-ddThh:mm:ss. Тип данных - дата и время.
* '''StatisticsItems.SearchTopStatsItem.UserID''' - Идентификатор пользователя. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.SearchTopStatsItem.AgencyID''' - Идентификатор агентства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.SearchTopStatsItem.SubAgencyID''' - Идентификатор субагентства. Тип данных - целое 32-битное число (может быть пустым).
* '''StatisticsItems.SearchTopStatsItem.SearchCount''' - Число поисков. Тип данных - целое 32-битное число.
* '''StatisticsItems.SearchTopStatsItem.DepPoint''' - Код точки отправления. Тип данных - строка.
* '''StatisticsItems.SearchTopStatsItem.ArrPoint''' - Код точки прибытия. Тип дынных - строка.
* '''StatisticsItems.SearchTopStatsItem.DepCountry''' - Двубуквенный код страны отправления. Тип данных - строка.
* '''StatisticsItems.SearchTopStatsItem.ArrCountry''' - Двубуквенный код страны прибытия. Тип данных - строка.
===== Пример ответа (XML)=====
<code>
<font color="blue"><GetSearchTopStatisticsResponse></font>
<font color="blue"><GetSearchTopStatisticsResult></font>
<font color="blue"><RequestID></font>22945<font color="blue"></RequestID></font>
<font color="blue"><ResponseBody></font>
<font color="blue"><StatisticsItems></font>
<font color="blue"><SearchTopStatsItem></font>
<font color="blue"><DateTime></font>2014-12-01T00:00:00<font color="blue"></DateTime></font>
<font color="blue"><UserID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><AgencyID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SubAgencyID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SearchCount></font>120<font color="blue"></SearchCount></font>
<font color="blue"><DepPoint <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><ArrPoint <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><DepCountry></font>RU<font color="blue"></DepCountry></font>
<font color="blue"><ArrCountry <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"></SearchTopStatsItem></font>
<font color="blue"><SearchTopStatsItem></font>
<font color="blue"><DateTime></font>2014-12-01T00:00:00<font color="blue"></DateTime></font>
<font color="blue"><UserID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><AgencyID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SubAgencyID <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><SearchCount></font>4<font color="blue"></SearchCount></font>
<font color="blue"><DepPoint <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><ArrPoint <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"><DepCountry></font>EG<font color="blue"></DepCountry></font>
<font color="blue"><ArrCountry <font color="orangered">nil</font>=<font color="purple">"true"</font>/></font>
<font color="blue"></SearchTopStatsItem></font>
<font color="blue"></StatisticsItems></font>
<font color="blue"></ResponseBody></font>
<font color="blue"></GetSearchTopStatisticsResult></font>
<font color="blue"></GetSearchTopStatisticsResponse></font>
</code>
→Выгрузки статистики продаж через API
==Выгрузки статистики продаж через API==
==Выгрузка информации о продажах в формате Nemo XML==
