Vídeo: confira a palestra sobre relatórios dos Anúncios de hotéis no workshop de 2019
Com a API Google Ads, é possível criar consultas para gerar os relatórios de Anúncios de hotéis necessários. Você pode então 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.
- Saiba como usar uma consulta em um aplicativo cliente, conforme mostrado neste exemplo de desempenho dos anúncios de hotéis.
Consultas básicas para Anúncios de hotéis
Confira estes exemplos de consultas para se familiarizar com o uso da API Google Ads para os relatórios de Anúncios de hotéis.
Ver métricas de cliques
A consulta de exemplo a seguir retorna o número de cliques a partir da visualização de desempenho do hotel.
SELECT metrics.clicks
FROM hotel_performance_view
O resultado da consulta vai ser semelhante a este:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Ver métricas de cliques segmentados
A consulta de exemplo a seguir para visualizações de desempenho de hotéis recebe cliques e segmenta os resultados por ID.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Os resultados da consulta vão ser semelhantes à string JSON mostrada abaixo. Os cliques são segmentados por partnerHotelID e, assim, 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"
}
},
...
]
}
Ver métricas do grupo de anúncios
O exemplo de consulta a seguir para grupos de anúncios recebe 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 vão ser semelhantes à string JSON mostrada abaixo. 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"
}
}
]
}
Ativar anúncios do grupo de anúncios
O exemplo de consulta a seguir para anúncios de grupos de anúncios recebe os grupos de anúncios que serão veiculados. Para que qualquer grupo de anúncios seja veiculado, ele, a campanha e o grupo de anúncios 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 vão ser semelhantes à string JSON mostrada abaixo.
{
"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 nos relatórios dos Anúncios de hotéis
Em APIs anteriores, é possível recuperar um relatório específico, como um relatório de desempenho. Na API Google Ads, esses dados são representados em recursos de *_view
separados, como hotel_performance_view
e hotel_group_view
. Esta seção descreve os recursos do *_view
que são úteis para os relatórios dos Anúncios de hotéis. Exemplos de consultas também são fornecidos.
Observe que cada recurso *_view
tem campos,
métricas e segmentos de recursos específicos. Consulte a documentação abaixo para acessar o recurso *_view
específico antes de criar sua consulta.
Visualização do Grupo de hotéis
A visualização de grupos de hotéis é uma visualização de critérios. Portanto, é útil para recuperar métricas de um tipo de critério específico de um grupo de hotéis.
O seguinte exemplo de consulta de visualizações de grupo de hotéis recebe cliques para cada hotel em um grupo de fichas para toda a árvore do grupo de hotéis, 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 vão ser parecidos com a string JSON abaixo.
Considerando que case_value
é indefinido para o nó raiz ("Todos os hotéis"), é aparente que a primeira linha representa as métricas para o grupo de fichas de hotéis "Todos", enquanto a segunda linha representa as métricas para o grupo de fichas 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 do hotel
A visualização de desempenho por hotel é útil se você quer recuperar métricas de desempenho de um hotel usando dados que não são provenientes de um agrupamento de hotéis, mesmo que tenha uma subdivisão baseada no ID do hotel.
A consulta de exemplo a seguir para visualizações de desempenho de hotéis recebe cliques e segmenta os resultados por ID.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Os resultados da consulta vão ser semelhantes à string JSON mostrada
abaixo. Os cliques são segmentados por partner_hotel_id
e, assim, dois ou mais
objetos podem ser retornados para a mesma visualização de desempenho do 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 se você quer recuperar métricas de desempenho para públicos-alvo anexados no nível do grupo de anúncios.
Essa é uma visão geral de vários tipos de campanha, não apenas de hotéis. Essa visualização também permite 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 como uma data padrão para a pesquisa definida pelo Google. Se você segmentar por hotel_date_selection_type
, somente os resultados de campanhas de hotel serão retornados.
Veja a seguir um exemplo de consulta. A consulta 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 vão ser semelhantes à string JSON mostrada abaixo.
{
"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 se você quer recuperar métricas de desempenho para públicos-alvo anexados no nível da campanha.
Essa é uma visão geral de vários tipos de campanha, não apenas de hotéis. Essa visualização também permite 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 como uma data padrão para a pesquisa definida pelo Google. Se você segmentar por hotel_date_selection_type
, somente os resultados de campanhas de hotel serão retornados.
Veja a seguir um exemplo de consulta. A consulta 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 vão ser semelhantes à string JSON mostrada abaixo.
{
"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 os Anúncios de hotéis
Esta seção fornece vários relatórios úteis projetados especificamente para anúncios de hotéis.
Relatórios de desempenho
Essas consultas usam a visualização de desempenho do hotel para ver dados de desempenho.
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 desempenho das tarifas condicionais
A consulta de relatório mostrada abaixo tem as 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 vão ser semelhantes à string JSON mostrada abaixo.
{
"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 ver insights sobre a comparação entre seus preços e 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 reservado
É possível receber 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 o desempenho de multiplicadores de lance nas listas de público-alvo do Google Ads. Para conferir exemplos de Relatórios de público-alvo, consulte os exemplos de consultas na Visualização de público-alvo do grupo de anúncios e na Visualização de público-alvo da campanha.