Video: Mira la charla sobre los informes de Anuncios de hoteles del taller de 2019
Con la API de Google Ads, puedes diseñar consultas para obtener los informes de Anuncios de hoteles que necesitas. Luego, puedes incorporar estas consultas en tus aplicaciones cliente.
Requisitos previos
- Obtén información sobre cómo funcionan los informes y las consultas en general.
- Obtén información sobre cómo se pueden realizar consultas en diferentes recursos.
- Obtén información sobre cómo usar una consulta en una aplicación cliente, como se muestra en este ejemplo de rendimiento de anuncios de hoteles.
Consultas básicas sobre Anuncios de hoteles
Consulta estas consultas de ejemplo a fin de familiarizarte con el uso de la API de Google Ads para los informes de Anuncios de hoteles.
Obtener métricas de clics
En la siguiente consulta de ejemplo, se muestra la cantidad de clics desde la vista de rendimiento del hotel.
SELECT metrics.clicks
FROM hotel_performance_view
Los resultados de la consulta se verían de la siguiente manera:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Obtenga métricas segmentadas de clics
En la siguiente consulta de ejemplo de vistas de rendimiento de hoteles, se obtienen los clics y los resultados segmentados por el ID de hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Los resultados de la consulta se verían similares a la string JSON que se muestra a continuación. Los clics están segmentados por partnerHotelID y, por lo tanto, se pueden mostrar dos o más objetos para el mismo hotelPerformanceView.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Obtener métricas del grupo de anuncios
La siguiente consulta de ejemplo de grupos de anuncios obtiene impresiones y clics durante los últimos 30 días, segmentados por fecha.
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
Los resultados de la consulta se verían similares a la string JSON que se muestra a continuación. Se filtra la respuesta solo para las métricas que cumplen con las condiciones de la cláusula WHERE. El campo de fecha se completa con la última fecha incluida en el período de 30 días.
{
"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"
}
}
]
}
Obtener anuncios del grupo de anuncios habilitados
La siguiente consulta de ejemplo de anuncios de grupos de anuncios obtiene los grupos de anuncios que se publicarán. Para que cualquier grupo de anuncios se publique, el anuncio del grupo de anuncios, el grupo de anuncios y la campaña deben estar habilitados.
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
Los resultados de la consulta se verían similares a la string JSON que se muestra a continuación.
{
"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"
}
}
}
]
}
Vistas útiles de los informes de Anuncios de hoteles
En las API anteriores para los informes de Anuncios de hoteles, podías recuperar un informe específico, como uno de rendimiento. En la API de Google Ads, este tipo de datos se representa en recursos *_view
separados, como hotel_performance_view
y hotel_group_view
. En esta sección, se describen los recursos *_view
que son útiles para los informes de Anuncios de hoteles. También se proporcionan consultas de ejemplo.
Ten en cuenta que cada recurso *_view
tiene campos de recursos, segmentos y métricas específicos. Consulta la documentación a la que se hace referencia a continuación para el recurso *_view
específico antes de construir tu consulta.
Vista del grupo de hoteles
La vista de grupos de hoteles es una vista de criterios, por lo que es útil a fin de recuperar métricas para un tipo de criterio específico de un grupo de hoteles.
En la siguiente consulta de ejemplo de vistas de grupos de hoteles, se obtienen clics por cada hotel en un grupo de fichas de todo el árbol de grupos de fichas de hoteles, incluido el nodo raíz (“Todos los hoteles”).
SELECT
metrics.clicks,
ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view
Los resultados de la consulta se verían similares a la string JSON a continuación.
Dado que case_value
no está definido para el nodo raíz (“Todos los hoteles”), es evidente que la primera fila representa las métricas del grupo de fichas “Todos los hoteles”, mientras que la segunda fila representa las métricas del grupo de fichas secundario que representan “Otros”.
{
"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"
}
},
]
}
Vista del rendimiento del hotel
La vista de rendimiento del hotel es útil si deseas recuperar métricas de rendimiento de un hotel con datos que no provienen de una agrupación de hoteles, incluso si tienes una subdivisión basada en el ID de hotel.
En la siguiente consulta de ejemplo de vistas de rendimiento de hoteles, se obtienen los clics y los resultados segmentados por el ID de hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Los resultados de la consulta se verían similares a la string JSON que se muestra a continuación. Los clics están segmentados por partner_hotel_id
y, por lo tanto, se pueden mostrar dos o más objetos para la misma vista de rendimiento del hotel.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Vista de público del grupo de anuncios
La Vista del público del grupo de anuncios es útil si desea recuperar métricas de rendimiento para los públicos adjuntos a nivel del grupo de anuncios.
Ten en cuenta que esta es una vista general de varios tipos de campañas, no solo de los hoteles. Esta vista también proporciona la capacidad de segmentar los resultados por hotel_date_selection_type
, que se puede usar para especificar si el usuario seleccionó la fecha del hotel o si fue una fecha predeterminada para la búsqueda establecida por Google. Si segmentas por hotel_date_selection_type
, solo se muestran los resultados de las campañas de hoteles.
A continuación, se muestra un ejemplo de consulta. La consulta muestra una fila por cada 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
Los resultados de la consulta se verían similares a la string JSON que se muestra a continuación.
{
"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"
}
}
]
}
Vista de público de la campaña
La Vista de público de la campaña es útil si deseas recuperar las métricas de rendimiento de los públicos adjuntos a nivel de la campaña.
Ten en cuenta que esta es una vista general de varios tipos de campañas, no solo de los hoteles. Esta vista también proporciona la capacidad de segmentar los resultados por hotel_date_selection_type
, que se puede usar para especificar si el usuario seleccionó la fecha del hotel o si fue una fecha predeterminada para la búsqueda establecida por Google. Si segmentas por hotel_date_selection_type
, solo se muestran los resultados de las campañas de hoteles.
A continuación, se muestra un ejemplo de consulta. La consulta muestra una fila por cada 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
Los resultados de la consulta se verían similares a la string JSON que se muestra a continuación.
{
"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"
}
}
]
}
Informes útiles para los Anuncios de hoteles
En esta sección, se proporcionan varios informes útiles diseñados específicamente para los anuncios de hoteles.
Informes de rendimiento
Estas consultas aprovechan la vista de rendimiento del hotel para obtener datos de rendimiento.
Rendimiento
Consulta de ejemplo:
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
Ejemplo de respuesta 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"
}
}
]
}
Rendimiento con tipo de clic
Consulta de ejemplo:
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
Ejemplo de respuesta 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"
}
}
]
}
Informe de rendimiento de tarifas condicionales
La consulta de informes que se muestra a continuación obtiene métricas de rendimiento segmentadas por:
campaign
hotel_center_id
hotel_country
hotel_rate_rule_id
hotel_rate_type
device
partner_hotel_id
Consulta HotelRateType
para obtener una descripción de los tipos.
Se pueden incluir varios segmentos en una consulta. Sin embargo, la cantidad de filas mostradas puede aumentar de forma significativa con segmentos adicionales.
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
Los resultados de la consulta se verían similares a la string JSON que se muestra a continuación.
{
"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"
}
}
]
}
Informe de competitividad de precios
Puedes obtener estadísticas sobre cómo se comparan tus precios con los de la competencia en los mismos itinerarios del hotel.
Consulta de ejemplo:
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
Ejemplo de respuesta JSON:
{
"results": [
{
"metrics": {
"hotelAverageLeadValueMicros": "96416341.829268292",
"hotelPriceDifferencePercentage": "-0.014627310872986811"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Informe de precio promedio reservado
Puedes obtener los datos necesarios para calcular el precio promedio reservado (all_conversions_value
dividido por conversions
) de los hoteles.
Consulta de ejemplo:
SELECT
segments.hotel_center_id,
segments.partner_hotel_id,
segments.hotel_price_bucket,
metrics.all_conversions_value,
metrics.conversions
FROM hotel_performance_view
Ejemplo de respuesta JSON:
{
"results": [
{
"metrics": {
"allConversionsValue": "123.5",
"conversions": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Informes de público
Los informes de público muestran el rendimiento de los multiplicadores de oferta en las listas de público de Google Ads. Para ver ejemplos de informes de público, consulta las consultas de ejemplo en la Vista de público del grupo de anuncios y la Vista del público de la campaña.