Quer compartilhar seu feedback sobre a API Google Ads? Faça sua inscrição para receber um convite para participar da pesquisa com usuários.

Esta página foi traduzida pela API Cloud Translation.

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

Saiba como os relatórios e as consultas funcionam em geral.
Saiba como consultar diferentes recursos.

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 semelhantes à 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"
      }
    },
  ]
}

Visualização de 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 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ê quiser recuperar métricas de performance de públicos-alvo anexados ao nível do 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 parecidos com a 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.

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 à 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 hotel

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

Ajuste os lances

Feeds de viagem para anúncios de pesquisa

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

Pré-requisitos

Consultas básicas para Anúncios de hotéis

Acessar métricas de cliques

Receber métricas segmentadas de cliques

Conferir as métricas do grupo de anúncios

Ativar anúncios de grupos de anúncios

Visualizações úteis para relatórios de Anúncios de hotéis

Visualização de grupo de hotéis

Visualização de performance do hotel

Visualização do público-alvo do grupo de anúncios

Visualização do público-alvo da campanha

Relatórios úteis para anúncios de hotéis

Relatórios de desempenho

Desempenho

Performance com tipo de clique

Relatório de performance de tarifas condicionais

Relatório de competitividade de preço

Relatório de preço médio da reserva

Relatórios de público-alvo

Relatório de reconciliação de hotel

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