Informes

Video: Mira la charla sobre informes de Anuncios de hoteles del taller de 2019

Con la API de Google Ads, puedes diseñar búsquedas para obtener los informes de Anuncios de hoteles que necesites. Luego, puedes incorporar estas consultas en las aplicaciones cliente.

Requisitos previos

Búsquedas básicas para Anuncios de hoteles

Revisa estas consultas de ejemplo para familiarizarte con el uso de la API de Google Ads para los informes de Anuncios de hoteles.

Obtén métricas de clics

En la siguiente consulta de ejemplo, se muestra la cantidad de clics en 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"
}

Obtener métricas de clics segmentadas

La siguiente consulta de ejemplo de vistas de rendimiento de hoteles obtiene clics y segmenta los resultados por ID de hotel.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Los resultados de la consulta se verían como la siguiente cadena JSON. Los clics se segmentan por partnerHotelID y, por lo tanto, se pueden mostrar dos o más objetos para la misma 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 de grupos de anuncios

La siguiente consulta de ejemplo para grupos de anuncios obtiene impresiones y clics de 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 como la siguiente cadena JSON. Se filtra la respuesta solo para las métricas que cumplen con las condiciones de la cláusula WHERE. El campo date se propaga 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 para anuncios de grupos de anuncios obtiene los grupos de anuncios que se publicarán. Para que se publique un grupo de anuncios, el anuncio, 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 como la siguiente cadena 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"
        }
      }
    }
  ]
}

Vistas útiles para los informes de Anuncios de hoteles

En las APIs anteriores de informes de Anuncios de hoteles, podías recuperar un informe específico, como un informe de rendimiento. En la API de Google Ads, este tipo de datos se representan en recursos *_view independientes, como hotel_performance_view y hotel_group_view. En esta sección, se describen los recursos de *_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 del recurso *_view específico antes de crear tu consulta.

Vista del grupo de hoteles

La vista de grupo de hoteles es una vista de criterios, por lo que es útil para recuperar las métricas de un tipo de criterio específico de un grupo de hoteles.

La siguiente consulta de ejemplo de vistas de un grupo de hoteles obtiene clics para cada hotel de un grupo de fichas correspondiente a todo el árbol del grupo 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 como la siguiente cadena JSON. 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 representa "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 de hoteles es útil si deseas recuperar las métricas de rendimiento de un hotel mediante datos que no provienen de una agrupación de hoteles, incluso si tienes una subdivisión basada en el ID de hotel.

La siguiente consulta de ejemplo de vistas de rendimiento de hoteles obtiene clics y segmenta los resultados por ID de hotel.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Los resultados de la consulta se verían como la siguiente cadena JSON. Los clics se segmentan 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 de público del grupo de anuncios es útil si deseas recuperar métricas de rendimiento de 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 las campañas de 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 que estableció Google. Si segmentas por hotel_date_selection_type, solo se mostrarán los resultados para las campañas de hoteles.

La siguiente consulta muestra una fila 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

Los resultados de la consulta se verían como la siguiente cadena 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"
      }
    }
  ]
}

Vista de público de la campaña

La vista de público de la campaña es útil si deseas recuperar métricas de rendimiento para 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 las campañas de 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 que estableció Google. Si segmentas por hotel_date_selection_type, solo se mostrarán los resultados para las campañas de hoteles.

La siguiente consulta muestra una fila 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

Los resultados de la consulta se verían como la siguiente cadena 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"
      }
    }
  ]
}

Informes útiles para 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 usan la vista de rendimiento de hoteles para obtener datos de rendimiento.

Un hotel_performance_view te permite usar el recurso campaign para segmentar las métricas. Por ejemplo, puedes usar el campo campaign.id para obtener métricas de rendimiento por campaña.

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 siguiente consulta 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 que se muestran puede aumentar de manera 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 como la siguiente cadena 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"
      }
    }
  ]
}

Informe de competitividad de los precios

Puedes obtener estadísticas sobre cómo se comparan tus precios con los de la competencia en los mismos itinerarios de 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 ofertas en las listas de público de Google Ads. Para ver ejemplos de informes de público, revisa las consultas de ejemplo en Vista de público del grupo de anuncios y Vista de público de la campaña.

Informe de conciliación de hoteles

El informe de conciliación de hoteles contiene información de conversiones de reservas de hoteles para conciliar con los registros del anunciante. Puedes subir datos a través de cargas masivas para informar a Google qué reservas se cancelaron o se completaron. Las columnas principales de este informe son las siguientes:

Columna de la IU Columna de API Explicación
Valor de reserva metrics.value_per_conversions_by_conversion_date El valor de conversión, tal como lo informa la etiqueta
Fecha de conversión segments.date La fecha de la reserva
Porcentaje de comisión metrics.hotel_commission_rate_micros El porcentaje del valor de reserva que oferta para una impresión de anuncios
Costo de la comisión

Si es status == RECONCILED o CANCELED, este valor se puede calcular como metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros. En todos los demás casos, este valor se puede obtener de la columna metrics.hotel_expected_commission_cost o calcular como metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date

El importe que se espera que pagues o que hayas pagado por la estadía del huésped