Vídeo: confira a palestra sobre relatórios dos Anúncios de hotéis do workshop de 2019
Com a API Google Ads, é possível criar consultas para gerar os relatórios de Anúncios de hotéis que você precisa. Depois, você pode incorporar essas consultas aos seus aplicativos clientes.
Pré-requisitos
- Saiba como os relatórios e as consultas funcionam em geral.
- Saiba como diferentes recursos podem ser consultados.
Consultas básicas para Anúncios de hotéis
Confira estas consultas de exemplo para se familiarizar com o uso da API Google Ads para Relatórios de Anúncios de hotéis.
Obter métricas de cliques
A consulta de exemplo a seguir retorna o número de cliques da visualização de desempenho do hotel.
SELECT metrics.clicks
FROM hotel_performance_view
Os resultados da consulta seriam parecidos com estes:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Ver métricas de cliques segmentados
O exemplo de consulta a seguir para visualizações de desempenho de hotéis recebe cliques e segmenta os resultados por ID do hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Os resultados da consulta seriam parecidos com a string JSON a seguir.
Os cliques são segmentados por partnerHotelID
e, portanto, dois ou mais objetos podem ser retornados para o mesmo hotelPerformanceView.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Acessar métricas do grupo de anúncios
O exemplo de consulta a seguir para grupos de anúncios mostra impressões e cliques nos últimos 30 dias, segmentados por data.
SELECT
campaign.name,
campaign.status,
ad_group.name,
segments.date,
metrics.impressions,
metrics.clicks
FROM ad_group
WHERE ad_group.type = HOTEL_ADS
AND segments.date DURING LAST_30_DAYS
Os resultados da consulta seriam parecidos com a string JSON a seguir.
A resposta é filtrada apenas para as métricas que atendem às condições da cláusula WHERE
. O campo de data é preenchido pela última data incluída no período de 30 dias.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"name": "test campaign",
"status": "ENABLED"
},
"adGroup": {
"resourceName": "customers/123456789/adGroups/11111111",
"name": "test adgroup"
},
"metrics": {
"clicks": "91",
"impressions": "5145"
},
"segments": {
"date": "2020-05-10"
}
}
]
}
Receber anúncios do grupo de anúncios ativados
O exemplo de consulta a seguir para anúncios do grupo de anúncios mostra os grupos de anúncios que serão veiculados. Para que um grupo de anúncios seja veiculado, o anúncio, o grupo e a campanha precisam estar ativados.
SELECT
ad_group.id,
ad_group.name,
ad_group.status,
campaign.name,
campaign.status,
ad_group_ad.status
FROM ad_group_ad
WHERE ad_group_ad.status = ENABLED
AND campaign.status = ENABLED
AND ad_group.status = ENABLED
Os resultados da consulta seriam parecidos com a string JSON a seguir.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"name": "test campaign",
"status": "ENABLED"
},
"adGroup": {
"resourceName": "customers/123456789/adGroups/111111111111",
"id": "106121857411",
"name": "test adgroup",
"status": "ENABLED"
},
"adGroupAd": {
"resourceName": "customers/123456789/adGroupAds/111111111111~33333333333",
"status": "ENABLED",
"ad": {
"resourceName": "customers/123456789/ads/77777777777"
}
}
}
]
}
Visualizações úteis para relatórios dos Anúncios de hotéis
Em APIs anteriores para relatórios de Anúncios de hotéis, era possível recuperar um relatório específico, como um de performance. Na API Google Ads, esse tipo de dado é representado em recursos *_view
separados, como hotel_performance_view
e hotel_group_view
. Esta seção descreve os recursos de *_view
que são
úteis para os relatórios de Anúncios de hotéis. Também são fornecidos exemplos de consultas.
Cada recurso *_view
tem campos de recursos, segmentos e métricas específicos. Consulte a documentação do recurso *_view
específico antes de criar sua consulta.
Visualização do grupo de hotéis
A Visualização de grupo de hotéis é uma visualização de critérios. Por isso, é útil para recuperar métricas para um tipo de critério específico de um grupo de hotéis.
O exemplo de consulta a seguir para visualizações de grupo de hotéis recebe cliques para cada hotel em um grupo de fichas em toda a árvore de grupos, incluindo o nó raiz ("Todos os hotéis").
SELECT
metrics.clicks,
ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view
Os resultados da consulta seriam parecidos com a string JSON a seguir.
Como case_value
está indefinido para o nó raiz ("Todos os hotéis"), é aparente que a primeira linha representa as métricas do grupo de fichas "Todos os hotéis", enquanto a segunda linha representa as métricas do grupo filho que representa "Outros".
{
"results": [
{
"metrics": {
"clicks": "5"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111111"
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111111"
}
},
{
"metrics": {
"clicks": "0"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111112"
"listingGroup": {
"caseValue": {
"hotelId": {
}
}
}
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111112"
}
},
{
"metrics": {
"clicks": "3"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111113"
"listingGroup": {
"caseValue": {
"hotelId": {
"value": "11111111111111111"
}
}
}
}
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111113"
}
},
{
"metrics": {
"clicks": "2"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111114"
"listingGroup": {
"caseValue": {
"hotelId": {
"value": "11111111111111112"
}
}
}
}
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111114"
}
},
]
}
Visualização de desempenho de hotéis
A Visualização de desempenho do hotel é útil se você quer recuperar métricas de desempenho de um hotel usando dados que não vêm de um agrupamento de hotéis, mesmo que você tenha uma subdivisão com base no ID do hotel.
O exemplo de consulta a seguir para visualizações de desempenho de hotéis recebe cliques e segmenta os resultados por ID do hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Os resultados da consulta seriam parecidos com a string JSON a seguir.
Os cliques são segmentados por partner_hotel_id
e, portanto, dois ou mais objetos podem ser retornados para a mesma visualização de desempenho de hotel.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Visualização do público-alvo do grupo de anúncios
A visualização de público-alvo do grupo de anúncios é útil para recuperar métricas de desempenho dos públicos-alvo anexados no nível do grupo de anúncios.
Esta é uma visão geral para vários tipos de campanhas, não apenas campanhas de hotel. Nessa visualização, também é possível segmentar os resultados por hotel_date_selection_type
, que pode ser usado para especificar se a data do hotel foi selecionada pelo usuário ou se era uma data padrão para a pesquisa definida pelo Google. Se você segmentar por hotel_date_selection_type
, somente os resultados das campanhas de hotel serão retornados.
A consulta a seguir retorna uma linha por ad_group_criterion.user_list.user_list
.
SELECT
ad_group.id,
campaign.id,
ad_group_criterion.user_list.user_list,
segments.device,
segments.hotel_date_selection_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions,
metrics.all_conversions_value
FROM ad_group_audience_view
Os resultados da consulta seriam parecidos com a string JSON a seguir.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0",
"costMicros": "0",
"impressions": "3",
"allConversionsValue": "0"
},
"adGroupCriterion": {
"resourceName": "customers/123456789/adGroupCriteria/23456789~789456",
"userList": {
"userList": "customers/123456789/userLists/456789"
}
},
"adGroupAudienceView": {
"resourceName": "customers/8005193609/adGroupAudienceViews/23456789~789456"
},
"segments": {
"device": "TABLET",
"hotelDateSelectionType": "USER_SELECTED"
}
}
]
}
Visualização do público-alvo da campanha
A Visualização de público-alvo da campanha é útil para recuperar métricas de desempenho dos públicos-alvo anexados no nível da campanha.
Esta é uma visão geral para vários tipos de campanhas, não apenas campanhas de hotel. Nessa visualização, também é possível segmentar os resultados por hotel_date_selection_type
, que pode ser usado para especificar se a data do hotel foi selecionada pelo usuário ou se era uma data padrão para a pesquisa definida pelo Google. Se você segmentar por hotel_date_selection_type
, somente os resultados das campanhas de hotel serão retornados.
A consulta a seguir retorna uma linha por campaign_criterion.user_list.user_list
.
SELECT
campaign.id,
campaign_criterion.user_list.user_list,
segments.device,
segments.hotel_date_selection_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions,
metrics.all_conversions_value
FROM campaign_audience_view
Os resultados da consulta seriam parecidos com a string JSON a seguir.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0",
"costMicros": "0",
"impressions": "3",
"allConversionsValue": "0"
},
"campaignCriterion": {
"resourceName": "customers/123456789/campaignCriteria/23456789~789456",
"userList": {
"userList": "customers/123456789/userLists/456789"
}
},
"campaignAudienceView": {
"resourceName": "customers/8005193609/campaignAudienceViews/23456789~789456"
},
"segments": {
"device": "TABLET",
"hotelDateSelectionType": "USER_SELECTED"
}
}
]
}
Relatórios úteis para Anúncios de hotéis
Nesta seção, há vários relatórios úteis criados especificamente para anúncios de hotel.
Relatórios de desempenho
Essas consultas usam a Visualização de desempenho de hotéis para obter dados de desempenho.
Um hotel_performance_view
permite que você use o recurso campaign
para segmentar métricas. Por exemplo, é possível usar o campo campaign.id
para conferir métricas de performance por campanha.
Desempenho
Exemplo de consulta:
SELECT
segments.hotel_center_id,
segments.device,
segments.partner_hotel_id,
segments.hotel_check_in_day_of_week,
segments.hotel_date_selection_type,
segments.hotel_length_of_stay,
segments.hotel_booking_window_days,
metrics.search_top_impression_share,
metrics.search_absolute_top_impression_share,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions,
metrics.all_conversions_value,
metrics.search_impression_share
FROM hotel_performance_view
Exemplo de resposta JSON:
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0.0",
"costMicros": "0",
"impressions": "0",
"searchImpressionShare": "0.0999",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "0.0999",
"allConversionsValue": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "3",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "MONDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "123"
}
},
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1",
"searchImpressionShare": "1.0",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "1.0",
"allConversionsValue": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "3",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "MONDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "123"
}
}
]
}
Performance com tipo de clique
Exemplo de consulta:
SELECT
segments.click_type,
segments.hotel_center_id,
segments.device,
segments.partner_hotel_id,
segments.hotel_check_in_day_of_week,
segments.hotel_date_selection_type,
segments.hotel_length_of_stay,
segments.hotel_booking_window_days,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions,
metrics.all_conversions_value
FROM hotel_performance_view
Exemplo de resposta JSON:
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1",
"allConversionsValue": "0.0"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "0",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "TUESDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "123",
"clickType": "HOTEL_PRICE"
}
},
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789"
},
"metrics": {
"clicks": "1",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1",
"allConversionsValue": "0.0"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "0",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "TUESDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "12345",
"clickType": "HOTEL_PRICE"
}
}
]
}
Relatório de performance de tarifas condicionais
A consulta a seguir busca métricas de desempenho segmentadas por:
campaign
hotel_center_id
hotel_country
hotel_rate_rule_id
hotel_rate_type
device
partner_hotel_id
Consulte HotelRateType
para ver uma descrição dos tipos.
Vários segmentos podem ser incluídos em uma consulta. No entanto, o número de linhas retornadas pode aumentar significativamente com segmentos adicionais.
SELECT
campaign.id,
segments.hotel_center_id,
segments.hotel_country,
segments.hotel_rate_rule_id,
segments.hotel_rate_type,
segments.device,
segments.partner_hotel_id,
metrics.search_top_impression_share,
metrics.search_absolute_top_impression_share,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions
FROM hotel_performance_view
Os resultados da consulta seriam parecidos com a string JSON a seguir.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "1",
"conversions": "0.0",
"costMicros": "0",
"impressions": "24",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "0.17073170731707318"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "TABLET",
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelRateRuleId": "desktop",
"hotelRateType": "PUBLIC_RATE"
}
},
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "107",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1668",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "0.3581201665675193"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "TABLET",
"hotelCenterId": "1234",
"partnerHotelId": "1235",
"hotelRateRuleId": "desktop",
"hotelRateType": "PUBLIC_RATE"
}
}
]
}
Relatório de competitividade de preço
É possível conseguir insights sobre como seus preços se comparam aos preços dos concorrentes nos mesmos itinerários de hotel.
Exemplo de consulta:
SELECT
segments.hotel_center_id,
segments.partner_hotel_id,
segments.hotel_price_bucket,
metrics.hotel_average_lead_value_micros,
metrics.hotel_price_difference_percentage
FROM hotel_performance_view
Exemplo de resposta JSON:
{
"results": [
{
"metrics": {
"hotelAverageLeadValueMicros": "96416341.829268292",
"hotelPriceDifferencePercentage": "-0.014627310872986811"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Relatório de preço médio de reservas
É possível ver os dados necessários para calcular o preço médio reservado
(all_conversions_value
dividido por conversions
) para hotéis.
Exemplo de consulta:
SELECT
segments.hotel_center_id,
segments.partner_hotel_id,
segments.hotel_price_bucket,
metrics.all_conversions_value,
metrics.conversions
FROM hotel_performance_view
Exemplo de resposta JSON:
{
"results": [
{
"metrics": {
"allConversionsValue": "123.5",
"conversions": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Relatórios de público-alvo
Os Relatórios de público-alvo mostram a performance dos multiplicadores de lance nas listas de público-alvo do Google Ads. Para ver exemplos de Relatórios de público-alvo, confira os exemplos de consultas em Visualização do público-alvo do grupo de anúncios e Visualização do público-alvo da campanha.
Relatório de Reconciliação de hotéis
O Relatório de reconciliação de hotel contém informações de conversão das reservas de hotéis para reconciliar com os registros do anunciante. É possível fazer o upload de dados usando uploads em massa para informar ao Google quais reservas foram canceladas ou concluídas. Estas são as principais colunas neste relatório:
Coluna da interface | Coluna "API" | Explicação |
---|---|---|
Valor da reserva | metrics.value_per_conversions_by_conversion_date |
O valor da conversão, conforme informado pela tag |
Data da conversão | segments.date |
A data da reserva |
Taxa de comissão | metrics.hotel_commission_rate_micros |
A porcentagem do valor da reserva que você definiu como lance para uma impressão de anúncio |
Custo da comissão |
Se for |
O valor que você vai pagar ou já pagou pela estadia |