Relatórios

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

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 status == RECONCILED ou CANCELED, esse valor poderá ser calculado como metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros. Em todos os outros casos, esse valor pode ser recebido na coluna metrics.hotel_expected_commission_cost ou calculado como metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date

 O valor que você vai pagar ou já pagou pela estadia
Anterior
Ajuste os lances