Method: accounts.participationReportViews.query

string

Имя ресурса запрашиваемой учетной записи. Формат: accounts/{account_id} .

string

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

Поле date обязательно. Все остальные поля являются необязательными.

Ниже приведены примеры допустимых условий:

• advanceBookingWindow = 2
• advanceBookingWindow >= 0
• advanceBookingWindow <= 5
• advanceBookingWindow between 1 and 5
• checkinDate = '2020-10-01'
• checkinDate >= '2020-10-01'
• checkinDate <= '2020-10-01'
• checkinDate between '2020-10-01' and '2020-10-05'
• date = '2020-02-04'
• date between '2020-02-04' and '2020-02-09'
• deviceType = 'TABLET'
• deviceType in ('MOBILE', 'TABLET')
• hotelRegionCode = 'US'
• hotelRegionCode in ('US', 'CA')
• lengthOfStayDays = 2
• lengthOfStayDays >= 0
• lengthOfStayDays <= 5
• lengthOfStayDays between 1 and 5
• occupancy = 2
• occupancy >= 0
• occupancy <= 5
• occupancy between 1 and 5
• partnerHotelId = 'AAA'
• partnerHotelId in ('AAA', 'BBB')
• userRegionCode = 'US'
• userRegionCode in ('US', 'CA')

string

Указывает, как сегментировать метрики, возвращаемые запросом. Например, если userRegionCode указан как значениеaggregateBy, participationResult предоставит метрики, aggregateBy по региону пользователя.

Строковое значение представляет собой список полей, разделенных запятыми. Допустимые поля: date , userRegionCode , deviceType , partnerHotelId , hotelRegionCode , advanceBookingWindow , lengthOfStayDays , checkinDate и occupancy . Поля, которые не указаны, не включаются в PartitionResult.

Использование aggregateBy , создающей большое количество строк, вызовет ошибку. Это особенно актуально при агрегировании по partnerHotelId или более чем по двум полям. Чтобы уменьшить вероятность ошибки, отфильтруйте по partnerHotelId и date , чтобы включить только выбранное количество отелей и дат. Аккаунтам с большим количеством отелей потребуется дополнительно сократить данные с помощью дополнительной фильтрации.

integer

Максимальное количество возвращаемых результатов участия. Служба может вернуть меньшее значение, чем это значение. Если не указано, будет возвращено не более 10 000 результатов. Максимальное значение — 10 000; значения выше 10 000 будут приведены к 10 000.

string

Маркер страницы, полученный из предыдущего запроса memberReportViews.query. Укажите это, чтобы получить следующую страницу.

При разбиении на страницы все остальные параметры, предоставленные для участияReportViews.query, должны соответствовать вызову, предоставившему токен страницы.

{
  "key": {
    object (Key)
  },
  "opportunityCount": string,
  "participationCount": string,
  "participationPercent": number,
  "missedParticipationCount": string,
  "missedParticipationCountDetails": {
    object (MissedParticipationCountDetails)
  },
  "partnerHotelDisplayName": string
}

object ( Key )

Ключ результата.

string ( int64 format)

Общее количество доступных возможностей для конкретного отеля. Возможности — это общее количество случаев, когда реклама отеля могла быть показана пользователю.

string ( int64 format)

Общее количество возможностей, для которых вы имели право участвовать в аукционе Google Реклама.

number

Процент участия, при котором количество успешно использованных возможностей делится на общее количество возможностей. Например, если недвижимость имела право участвовать в аукционе Google Реклама 90 раз из 100, коэффициент участия составляет 90 %.

string ( int64 format)

Общее количество возможностей, не подходящих для аукциона Google Рекламы. Состоит из следующего:

• Отсутствует целевая страница
• Цена отсутствует
• Проблема с ценой
• Цена недоступна
• Другой

object ( MissedParticipationCountDetails )

Причины, которые способствовали подсчету пропущенного участия (например, отсутствие доступности) и общее количество по каждой причине.

string

Отображаемое название отеля партнера. Это поле заполняется только тогда, когда результат агрегируется по partnerHotelId .

{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "hotelRegionCode": string,
  "advanceBookingWindow": integer,
  "lengthOfStayDays": integer,
  "checkinDate": {
    object (Date)
  },
  "occupancy": integer
}

object ( Date )

Дата, для которой вы запрашиваете метрики.

Если date не является значением параметра aggregateBy в вызове запроса, то поле date не возвращается в Key .

string

Код региона ISO 3116 страны/региона пользователя.

Если userRegionCode не является значением параметра aggregateBy в вызове запроса, то поле userRegionCode не возвращается в Key .

enum ( Device )

Тип устройства пользователя.

Если deviceType не является значением параметра aggregateBy в вызове запроса, то поле deviceType не возвращается в Key .

string

Идентификатор отеля партнера.

Если partnerHotelId не является значением параметра aggregateBy в вызове запроса, то поле partnerHotelId не возвращается в Key .

string

CLDR региональный код страны/региона отеля.

Если hotelRegionCode не является значением параметра aggregateBy в вызове запроса, то поле hotelRegionCode не возвращается в Key .

integer

Количество дней, за которое пользователь хочет забронировать маршрут.

Если advanceBookingWindow не является значением параметра aggregateBy в вызове запроса, то поле advanceBookingWindow не возвращается в Key .

integer

Количество ночей в маршруте.

Если lengthOfStayDays не является значением параметра aggregateBy в вызове запроса, поле lengthOfStayDays не возвращается в Key .

object ( Date )

Дата регистрации маршрута.

Если checkinDate не является значением параметра aggregateBy в вызове запроса, то поле checkinDate не возвращается в Key .

integer

Общая заполняемость маршрута.

Если occupancy не является значением параметра aggregateBy в вызове запроса, то поле occupancy не возвращается в Key .

{
  "noAvailabilityCount": string,
  "hotelSuspendedCount": string,
  "noTaxBreakdownCount": string,
  "noLandingPageCount": string,
  "noPriceCount": string,
  "noPriceCountDetails": {
    object (NoPriceCountDetails)
  },
  "otherReasonCount": string,
  "priceMissingCount": string,
  "priceMissingCountDetails": {
    object (PriceMissingCountDetails)
  },
  "priceProblemCount": string,
  "priceProblemCountDetails": {
    object (PriceProblemCountDetails)
  },
  "priceUnavailableCount": string,
  "priceUnavailableCountDetails": {
    object (PriceUnavailableCountDetails)
  }
}

string ( int64 format)

Общее количество пропущенных участников из-за недоступности комбинации отеля/маршрута или из-за того, что путешественник не имел права на участие в тарифах. Для участия в этих аукционах вам может потребоваться предоставить дополнительную информацию о ценах.

string ( int64 format)

Общее количество пропущенных посещений из-за того, что один или несколько ваших отелей были приостановлены из-за нарушения точности цен.

string ( int64 format)

Общее количество пропущенных участников из-за того, что один или несколько ваших отелей не указали отдельно налоги и сборы.

string ( int64 format)

Ни одна целевая страница не соответствует пользователю.

string ( int64 format)

Общее количество пропущенных посещений из-за того, что цена за запрашиваемый маршрут не была предложена.

object ( NoPriceCountDetails )

Причины, которые способствовали отсутствию подсчета цен (например, текущие цены недоступны) и общее количество для каждой причины.

string ( int64 format)

Отель не участвовал по неизвестной причине.

string ( int64 format)

Общее количество пропущенных участников из-за отсутствия цены в кеше Google или из-за того, что не удалось успешно отреагировать на текущие цены. Состоит из следующего:

• Пропускная способность исчерпана
• Отсутствует скорость кэширования
• Маршрут заблокирован
• Цены в реальном времени не настроены
• Тайм-аут ценообразования в реальном времени
• Ошибка ценообразования в реальном времени

object ( PriceMissingCountDetails )

Причины, которые способствовали отсутствию цены, учитываются.

string ( int64 format)

Общее количество пропущенных участников из-за проблем с точностью цены, предусмотренной для маршрута. Состоит из следующего:

• Отель приостановлен
• Цена непривычно высокая
• Цена необычайно низкая
• Налоги и корма отсутствуют

object ( PriceProblemCountDetails )

Причины, которые способствовали возникновению ценовой проблемы, учитываются.

string ( int64 format)

Общее количество пропущенных участников из-за того, что цена указана как недоступная (-1) для запрошенного маршрута. Состоит из следующего:

• Цена недоступна
• Участие маловероятно
• Другой

object ( PriceUnavailableCountDetails )

Причины, которые способствовали отсутствию цены, учитываются.

{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}

string ( int64 format)

Общее количество пропущенных участников из-за технических проблем с текущими ценами по любой из следующих причин:

• Вы ответили недостаточно быстро и превысили срок ответа (около 4000 миллисекунд).
• Вы вернули ошибку.
• Ваш ответ был искажен.

string ( int64 format)

Общее количество пропущенных участников из-за того, что цены в реальном времени не активировались по любой из следующих причин:

• Вы не установили ставку.
• У вас не было действительной целевой страницы.
• В кэше не хватило цен.

string ( int64 format)

Общее количество пропущенных участников из-за того, что цены в реальном времени не активировались по любой из следующих причин:

• Для этих поисковых запросов у вас не настроены цены в реальном времени.
• Вы запретили Google доступ к указанному маршруту отеля.

string ( int64 format)

Общее количество пропущенных участников из-за недоступности цен в реальном времени. Текущие цены не будут активированы для определенных маршрутов или интерфейсов по умолчанию. В этом случае для участия партнерам потребуется кешированная цена.

string ( int64 format)

Количество пропущенных посещений из-за других проблем с ценообразованием в реальном времени.

{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}

string ( int64 format)

В кэше нет цены для этого маршрута. Активный запрос не был выполнен из-за ограничений страницы.

string ( int64 format)

Маршрут не соответствовал вашим базовым параметрам, поэтому цена маршрута не была получена ни из оперативного запроса, ни из кэша.

string ( int64 format)

Цена для этого маршрута не кэшировалась, и для этой учетной записи не был настроен запрос в реальном времени.

string ( int64 format)

Цена для этого маршрута не кэшировалась, и не осталось квоты активных запросов.

string ( int64 format)

Цена для этого маршрута не была кэширована, а время ожидания запроса в реальном времени, отправленного в вашу систему, истекло.

string ( int64 format)

Цена для этого маршрута не была кэширована. Время ожидания оперативного запроса не истекло, но ваша система вернула ошибку.

{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string
}

string ( int64 format)

Отель был приостановлен. Это может быть связано с постоянными проблемами в таких областях, как неправильные налоги и сборы.

string ( int64 format)

Цена, указанная за этот маршрут, показалась странно высокой по сравнению с региональными тенденциями.

string ( int64 format)

Цена, указанная за этот маршрут, казалась странно низкой по сравнению с региональными тенденциями.

string ( int64 format)

Налоги и сборы отсутствовали в ценообразовании.

{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}

string ( int64 format)

Отель не участвовал, потому что он не был доступен на даты маршрута.

string ( int64 format)

Цена для этого маршрута не кэшировалась, и запрос в реальном времени не выполнялся, потому что ваш сервер обычно сообщает нам, что отель недоступен или распродан.