Vídeo: Confira a palestra sobre relatórios de anúncios de hotel do workshop de 2019
Com a API Google Ads, você pode criar consultas para gerar os relatórios dos Anúncios de hotéis de que precisa. Depois, você pode incorporar essas consultas aos seus aplicativos cliente.
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 e se familiarize com o uso da API Google Ads para os relatórios dos Anúncios de hotéis.
Métricas de obtenção de cliques
O exemplo de consulta 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 mais ou menos assim:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Receber métricas de cliques segmentados
O exemplo de consulta a seguir para visualizações de desempenho do hotel 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 semelhantes à 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"
}
},
...
]
}
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 seriam semelhantes à 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"
}
}
]
}
Exiba anúncios de grupos de anúncios ativados
O exemplo de consulta a seguir para anúncios de grupo de anúncios mostra os grupos de anúncios que serão veiculados. Para que qualquer grupo de anúncios seja veiculado, o anúncio do grupo de anúncios, o grupo de anúncios 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 semelhantes à 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 os relatórios dos Anúncios de hotéis
Nas APIs anteriores dos relatórios de Anúncios de hotéis, era possível recuperar um relatório específico, como um relatório de desempenho. 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 gerar relatórios dos Anúncios de hotéis. Também são fornecidos exemplos de consultas.
Observe que 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. Portanto, é útil para recuperar métricas de 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 para toda a árvore do grupo, 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 semelhantes à string JSON a seguir.
Como case_value
não está definido 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 do desempenho do hotel
A Visualização de desempenho do hotel é útil se você quiser 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 do hotel 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 semelhantes à 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 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 do público-alvo do grupo de anúncios será útil se você quiser recuperar métricas de performance dos públicos-alvo anexados no nível do grupo de anúncios.
Esta é uma visão geral de vários tipos de campanhas, não apenas de campanhas de hotel. 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 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 semelhantes à 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 se você quiser recuperar métricas de performance dos públicos-alvo anexados no nível da campanha.
Esta é uma visão geral de vários tipos de campanhas, não apenas de campanhas de hotel. 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 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 semelhantes à 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, você encontra vários relatórios úteis criados especificamente para anúncios de hotel.
Relatórios de desempenho
Essas consultas usam a Visualização de desempenho do hotel 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 acessar métricas de desempenho 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 desempenho das tarifas condicionais
A consulta a seguir exibe 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 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 semelhantes à 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
Você pode ter insights sobre como seus preços se comparam aos preços dos concorrentes para os 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 médio de preços reservados
É possível acessar os dados necessários para calcular o preço médio de reserva (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 conferir exemplos de Relatórios de público-alvo, confira 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.
Relatório de reconciliação de hotel
O Relatório de reconciliação de hotel contém informações de conversão de reservas de hotéis para fazer a reconciliação 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. As principais colunas desse relatório são:
Coluna da interface | Coluna de 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 de reserva que você dá como lance para uma impressão de anúncio |
Custo da comissão |
Se for |
O valor que você deverá pagar ou pagou pela estadia |