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, você pode criar consultas para receber os relatórios de Anúncios de hotéis necessários. Em seguida, é possível 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 relatórios de anúncios de hotéis.

Acessar métricas de cliques

O exemplo de consulta a seguir retorna o número de cliques da visualização de performance 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 segmentadas de cliques

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 vão ser semelhantes à seguinte string JSON. Os cliques são segmentados por partnerHotelID e, portanto, dois ou mais objetos podem ser retornados para a mesma hotelPerformanceView.

{
  "results": [
    {
      "metrics": {
        "clicks": "7055"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1111"
      }
    },
    {
      "metrics": {
        "clicks": "3047"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1112"
      }
    },
    ...
  ]
}

Conferir as métricas do grupo de anúncios

O exemplo de consulta para grupos de anúncios a seguir 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 à seguinte string JSON. A resposta é filtrada apenas para as métricas que atendem às condições da cláusula WHERE. O campo de data é preenchido com a ú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 de grupos 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 um grupo de anúncios seja veiculado, o anúncio, 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 vão ser parecidos com a seguinte string JSON.

{
  "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 de Anúncios de hotéis

Nas APIs anteriores para relatórios de anúncios de hotéis, era possível recuperar um relatório específico, como um relatório de performance. Na API Google Ads, esse tipo de dados é representado em recursos *_view separados, como hotel_performance_view e hotel_group_view. Esta seção descreve os recursos *_view que são úteis para gerar relatórios de anúncios de hotéis. Também são fornecidos exemplos de consultas.

Cada recurso *_view tem campos, segmentos e métricas específicos. Consulte a documentação do recurso *_view específico antes de criar a consulta.

Visualização de grupo de hotéis

A visualização de grupo de hotéis é uma visualização de critérios, então é útil para recuperar métricas de um tipo específico de critérios de um grupo de hotéis.

O exemplo de consulta a seguir para visualizações de grupo de hotéis recebe cliques de cada hotel em um grupo de listagens para toda a árvore de grupos de listagens 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 semelhantes à seguinte string JSON. Como case_value não está definido para o nó raiz ("Todos os hotéis"), é óbvio que a primeira linha representa as métricas do grupo de listagem "Todos os hotéis", enquanto a segunda linha representa as métricas do grupo de listagem filha 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"
      }
    },
  ]
}

Visão geral da performance do hotel

A Visualização de performance do hotel é útil se você quiser recuperar as métricas de performance de um hotel usando dados que não vêm de um grupo 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 vão ser semelhantes à seguinte string JSON. Os cliques são segmentados por partner_hotel_id e, portanto, dois ou mais objetos podem ser retornados para a mesma visualização de performance 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ê quiser recuperar métricas de performance dos públicos-alvo anexados ao grupo de anúncios.

Essa é uma visualização geral para vários tipos de campanhas, não apenas as 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 se foi uma data padrão para a pesquisa definida pelo Google. Se você segmentar por hotel_date_selection_type, só 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 vão ser semelhantes à seguinte string JSON.

{
  "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 as métricas de performance dos públicos-alvo anexados à campanha.

Essa é uma visualização geral para vários tipos de campanhas, não apenas as 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 se foi uma data padrão para a pesquisa definida pelo Google. Se você segmentar por hotel_date_selection_type, só 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 vão ser semelhantes à seguinte string JSON.

{
  "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

Esta seção oferece vários relatórios úteis criados especificamente para anúncios de hotéis.

Relatórios de desempenho

Essas consultas usam a visualização "Desempenho do hotel" para receber dados de performance.

Um hotel_performance_view permite usar o recurso campaign para segmentar métricas. Por exemplo, é possível usar o campo campaign.id para receber 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 recebe as métricas de performance 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 vão ser semelhantes à seguinte string JSON.

{
  "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 conferir insights sobre como seus preços se comparam aos da concorrência nos mesmos itinerários de hotéis.

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 da reserva

Você pode 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 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, consulte as consultas de exemplo em Visualização de público-alvo do grupo de anúncios e Visualização de público-alvo da campanha.

Relatório de reconciliação de hotéis

O relatório de conciliação de hotéis contém informações de conversão das reservas de hotéis para conciliar com os registros do anunciante. É possível fazer upload de dados em massa para informar ao Google quais reservas foram canceladas ou concluídas. As colunas principais deste relatório são as seguintes:

Coluna da interface Coluna da API Explicação
Valor da reserva metrics.value_per_conversions_by_conversion_date O valor da conversão 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ê dá como lance para uma impressão de anúncio
Custo da comissão

Se status == RECONCILED ou CANCELED, esse valor pode ser calculado como metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros. Em todos os outros casos, esse valor pode ser obtido 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ê deverá pagar ou pagou pela estadia
Anterior
Ajuste os lances
Próxima
Feeds de viagem para anúncios de pesquisa