Method: accounts.participationReportViews.query

string

O nome do recurso da conta que está sendo consultada. O formato é accounts/{account_id}.

string

São as condições (campos e expressões) usadas para filtrar as métricas de participação da conta que está sendo consultada. A sintaxe requer espaços ao redor do operador in. Caso contrário, é possível omitir espaços. As condições podem ser mescladas usando o operador and.

O campo date é obrigatório. Todos os outros campos são opcionais.

Veja abaixo exemplos de condições válidas:

• 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

Especifica como segmentar as métricas retornadas pela consulta. Por exemplo, se userRegionCode for especificado como o valor aggregateBy, o participationResult vai fornecer métricas agregadas por região do usuário.

O valor da string é uma lista de campos separada por vírgulas. Os campos válidos são: date, userRegionCode, deviceType, partnerHotelId, hotelRegionCode, advanceBookingWindow, lengthOfStayDays, checkinDate e occupancy. Os campos não especificados não são incluídos no ParticipationResult.

Usar uma especificação aggregateBy que produz um grande número de linhas causará um erro. Isso é especialmente verdadeiro ao agregar por partnerHotelId ou mais de dois campos. Para reduzir a possibilidade de um erro, filtre por partnerHotelId e date para incluir apenas um número específico de hotéis e datas. Contas com muitos hotéis precisarão reduzir ainda mais os dados com mais filtragem.

integer

O número máximo de resultados de participação a serem retornados. O serviço pode retornar menos que esse valor. Se não for especificado, serão retornados no máximo 10.000 resultados. O valor máximo é 10.000. Valores maiores serão convertidos para 10.000.

string

Um token de página, recebido de uma solicitação requestReportViews.query anterior. Forneça isso para receber a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para participantesReportReports.query precisam corresponder à chamada que forneceu o token da página.

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

object (Key)

Chave do resultado.

string (int64 format)

O número total de oportunidades disponíveis para um hotel específico. "Oportunidades" é o número total de vezes que um anúncio de hotel pode ser exibido a um usuário.

string (int64 format)

O número total de oportunidades em que você teve qualificação para entrar no processo de leilão do Google Ads.

number

A taxa de participação percentual em que o número de oportunidades de participação é dividido pelo número total de oportunidades. Por exemplo, se uma propriedade estiver qualificada para participar do leilão do Google Ads 90 vezes de 100 oportunidades, a taxa de participação será de 90%.

string (int64 format)

O número total de oportunidades não qualificadas para o processo de leilão do Google Ads. Ter o seguinte:

• Página de destino ausente
• Preço ausente
• Problema no preço
• Preço indisponível
• Outro

object (MissedParticipationCountDetails)

Os motivos que contribuíram para a contagem de participação perdida (por exemplo, sem disponibilidade) e a contagem total para cada motivo.

string

Nome de exibição do hotel do parceiro. Este campo só é preenchido quando o resultado é agregado por partnerHotelId.

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

object (Date)

A data para a qual você está solicitando métricas.

Se date não for um valor do parâmetro aggregateBy na chamada da solicitação, o campo date não será retornado no Key.

string

Código regional ISO 3116 do país/região do usuário.

Se userRegionCode não for um valor do parâmetro aggregateBy na chamada da solicitação, o campo userRegionCode não será retornado no Key.

enum (Device)

O tipo de dispositivo do usuário.

Se deviceType não for um valor do parâmetro aggregateBy na chamada da solicitação, o campo deviceType não será retornado no Key.

string

ID do hotel do parceiro.

Se partnerHotelId não for um valor do parâmetro aggregateBy na chamada da solicitação, o campo partnerHotelId não será retornado no Key.

string

Código regional do CLDR do país/região do hotel.

Se hotelRegionCode não for um valor do parâmetro aggregateBy na chamada da solicitação, o campo hotelRegionCode não será retornado no Key.

integer

O número de dias de antecedência com que o usuário quer reservar o itinerário.

Se advanceBookingWindow não for um valor do parâmetro aggregateBy na chamada da solicitação, o campo advanceBookingWindow não será retornado no Key.

integer

O número de noites do itinerário.

Se lengthOfStayDays não for um valor do parâmetro aggregateBy na chamada da solicitação, o campo lengthOfStayDays não será retornado no Key.

object (Date)

A data do check-in do itinerário.

Se checkinDate não for um valor do parâmetro aggregateBy na chamada da solicitação, o campo checkinDate não será retornado no Key.

integer

Ocupação total do itinerário.

Se occupancy não for um valor do parâmetro aggregateBy na chamada da solicitação, o campo occupancy não será retornado no 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)

O número total de participantes perdidos devido à indisponibilidade do hotel/itinerário ou porque o viajante não estava qualificado para as tarifas. Para participar dos leilões, forneça mais informações sobre os preços.

string (int64 format)

O número total de participações perdidas devido a uma ou mais hotéis que estão sendo suspensos devido a violações do nível de precisão do preço.

string (int64 format)

O número total de participantes perdidos devido a um ou mais hotéis que não especificam tributos e taxas separadamente.

string (int64 format)

Nenhuma página de destino correspondeu ao usuário.

string (int64 format)

O número total de participações perdidas devido a um preço não oferecido para o itinerário solicitado.

object (NoPriceCountDetails)

Os motivos que contribuíram para a contagem de sem preço (por exemplo, preço em tempo real não disponível) e a contagem total para cada motivo.

string (int64 format)

O hotel não participou por um motivo desconhecido.

string (int64 format)

O número total de participações perdidas devido a um preço que não está presente no cache do Google ou à falta de resposta ao preço ativo. Ter o seguinte:

• Largura de banda esgotada
• Taxa de cache ausente
• Itinerário bloqueado
• Preço ativo não configurado
• Tempo limite do preço ativo
• Erro no preço em tempo real

object (PriceMissingCountDetails)

Os motivos que contribuíram para a ausência do preço.

string (int64 format)

O número total de participantes perdidos devido a um problema na precisão do preço fornecido para o itinerário. Ter o seguinte:

• Hotel suspenso
• Preço excepcionalmente alto
• Preço excepcionalmente baixo
• Tributos e feeds ausentes

object (PriceProblemCountDetails)

Os motivos que contribuíram para a contagem de problemas de preço.

string (int64 format)

O número total de participações perdidas devido ao preço listado como indisponível (-1) para o itinerário solicitado. Ter o seguinte:

• Preço indisponível
• Participação pouco provável
• Outro

object (PriceUnavailableCountDetails)

Os motivos que contribuíram para a contagem de preço indisponível.

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

string (int64 format)

É o número total de participantes perdidos devido a problemas técnicos com o preço ativo por qualquer um dos motivos a seguir:

• Você não respondeu rápido o suficiente e excedeu o prazo de resposta (cerca de 4.000 milissegundos).
• Você retornou um erro.
• Sua resposta estava incorreta.

string (int64 format)

O número total de participantes perdidos devido ao acionamento de preços em tempo real por qualquer um dos motivos a seguir:

• Você não definiu um lance.
• Você não tem uma página de destino válida.
• Não há preços suficientes no cache.

string (int64 format)

O número total de participantes perdidos devido ao acionamento de preços em tempo real por qualquer um dos motivos a seguir:

• Os preços ativos não estão configurados para essas pesquisas.
• Você restringiu o Google a acessar o itinerário do hotel em questão.

string (int64 format)

O número total de participantes perdidos devido a preços em tempo real indisponíveis. O preço em tempo real não será acionado para alguns itinerários ou IUs padrão. Neste cenário, os parceiros precisarão de um preço em cache para participar.

string (int64 format)

O número de participações perdidas devido a outros problemas de preços em tempo real.

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

string (int64 format)

Não há preço no cache para esse itinerário. Não foi possível fazer uma consulta ao vivo devido a restrições de página.

string (int64 format)

O itinerário não faz parte dos seus parâmetros básicos. Por isso, ele não extrai nenhum preço da consulta ativa ou do preenchimento de cache.

string (int64 format)

Nenhum preço foi armazenado em cache para esse itinerário, e a consulta em tempo real não foi configurada para esta conta.

string (int64 format)

Nenhum preço foi armazenado em cache para esse itinerário e não restou uma cota de consulta ativa.

string (int64 format)

Nenhum preço foi armazenado em cache para esse itinerário, e uma consulta em tempo real foi enviada para seu sistema.

string (int64 format)

Nenhum preço foi armazenado em cache para esse itinerário. Uma consulta em tempo real não expirou, mas seu sistema retornou um erro.

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

string (int64 format)

O hotel foi suspenso. Isso pode ser devido a problemas persistentes em áreas como tributos e taxas incorretos.

string (int64 format)

O preço fornecido para esse itinerário parecia estranho em comparação com as tendências regionais.

string (int64 format)

O preço fornecido para esse itinerário parecia estranho em comparação com as tendências regionais.

string (int64 format)

Faltavam tributos e taxas no preço.

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

string (int64 format)

O hotel não participou porque não estava disponível para as datas do itinerário.

string (int64 format)

Nenhum preço foi armazenado em cache para esse itinerário, e nenhuma consulta em tempo real foi feita porque seu servidor normalmente nos informa que o hotel está indisponível ou esgotado.