Relatórios

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

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.

Anterior
Ajuste os lances
Próxima
Criar uma campanha do Reservas no Google