Comparativas de YouTube

Importante: Esta función solo está disponible para las cuentas que se encuentran en una lista de entidades permitidas. Comunícate con tu representante de Google si necesitas acceder a esta función.

La BenchmarksService permite que los anunciantes y las agencias comparen el rendimiento de sus anuncios de YouTube con las comparativas de la industria. Con este servicio, puedes evaluar el rendimiento de tus campañas en relación con las verticales de la industria o con todos los anunciantes en categorías de productos y servicios específicas.

Funciones clave

Con el BenchmarksService, puedes hacer lo siguiente:

• Comparar el rendimiento: Evalúa las métricas de tasa promedio de un cliente (como el CPM, el CPV, la CTR y la visibilidad) en comparación con los promedios agregados de la industria.
• Analiza la participación de mercado: Comprende la presencia relativa de un cliente en el mercado a través de la cuota publicitaria de la marca (impresiones relativas) y el porcentaje de inversión.
• Evalúa la posición competitiva: Mide la posición competitiva de un cliente con métricas de percentiles que clasifican el rendimiento en dimensiones clave en niveles competitivos (como Líder del mercado o Competidor).
• Segmentar por tiempo: Agrupa las métricas de comparativas por granularidades temporales semanales, mensuales o trimestrales.
• Descubre las dimensiones de comparativas admitidas: Consulta los períodos disponibles, las ubicaciones geográficas, los productos publicitarios y las fuentes de comparativas (verticales de la industria o categorías de productos y servicios).

Nota: Debes proporcionar un ID de cliente final en tus solicitudes. Un ID de cliente de cuenta de administrador no devolverá métricas de clientes porque las cuentas de administrador no publican campañas publicitarias directamente.

Métodos de descubrimiento

Antes de generar métricas de comparativas, usa los métodos de descubrimiento para recuperar los parámetros válidos y los criterios de alcance de tus solicitudes.

Enumera las fechas disponibles

El método ListBenchmarksAvailableDates devuelve los rangos de fechas históricos que admiten datos de comparativas en un ListBenchmarksAvailableDatesResponse.

La respuesta proporciona dos períodos distintos:

• supported_dates: Es el período general en el que se admiten las métricas de comparativas (inclusive). Las solicitudes de comparativas pueden consultar fechas dentro de este rango.
• supported_dates_for_all_metrics (en la versión 25 y posteriores): Es un subconjunto de supported_dates que admite el conjunto completo de métricas de comparativas. Ciertas métricas, específicamente las métricas de participación del cliente (share_of_voice y share_of_spend) y las métricas de tasa promedio de la fuente de comparativas, solo están disponibles dentro de este período debido a la disponibilidad limitada de datos. Estas métricas se omiten de la respuesta si el date_range solicitado no se encuentra por completo dentro de supported_dates_for_all_metrics.

Mostrar lista de ubicaciones

El método ListBenchmarksLocations devuelve la lista de ubicaciones geográficas (como países) que admiten datos de comparativas.

Cada BenchmarksLocation de la respuesta incluye lo siguiente:

• location_name: Es el nombre único de la ubicación en inglés (por ejemplo, "United States").
• location_type: Es el tipo de ubicación que corresponde al target_type en la API de Google Ads (por ejemplo, "Country").
• location_info: Es un objeto LocationInfo que contiene la constante de ubicación geográfica objetivo (como geo_target_constant: "geoTargetConstants/2840").

Enumera productos

El método ListBenchmarksProducts devuelve la lista de productos y objetivos de marketing disponibles para la comparativa.

Cada entrada BenchmarksProductMetadata incluye lo siguiente:

• product_name: Es el nombre del producto fácil de usar.
• product_code: Es la cadena del identificador único del producto, que se usa cuando se construye un objeto ProductFilter.
• marketing_objective: Es el objetivo de marketing asociado (BenchmarksMarketingObjective):
  • AWARENESS: Son campañas diseñadas para aumentar el reconocimiento de la marca o el producto.
  • CONSIDERATION: Son campañas diseñadas para incentivar a los clientes potenciales a considerar la marca o los productos.
  • ACTION: Son campañas diseñadas para generar una acción de conversión específica.

Enumera las fuentes de comparativas

El método ListBenchmarksSources recupera las fuentes de comparativas disponibles. Especifica los tipos de fuentes que se recuperarán con BenchmarksSourceType:

• INDUSTRY_VERTICAL: Son las clasificaciones de los segmentos de la industria (por ejemplo, "Technology" o "Finance").
• CATEGORY (en la versión 25 y posteriores): Son las categorías de productos y servicios (por ejemplo, "/Apparel/Clothing"). Las categorías se pueden usar como filtros para definir el alcance de las comparativas cuando se comparan con todos los anunciantes.

La respuesta devuelve una lista de objetos BenchmarksSourceMetadata que contienen lo siguiente:

• IndustryVerticalInfo: Contiene industry_vertical_name, industry_vertical_id y parent_industry_vertical_id (si corresponde).
• CategoryInfo (en la versión 25 y posteriores): Contiene category_name, category_id y category_path (la jerarquía de categorías completa).

Genera métricas de comparativas

Llama a GenerateBenchmarksMetrics para comparar las métricas de anuncios de YouTube de un cliente con las comparativas de sectores.

Parámetros de solicitud

Un GenerateBenchmarksMetricsRequest define el alcance del análisis. Como mínimo, debes especificar un customer_id de cliente, un location geográfico (LocationInfo), un benchmarks_source (un industry_vertical_id o, en la versión 25 y posteriores, un all_advertisers con alcance de category_filter) y un product_filter. De manera opcional, puedes hacer lo siguiente:

• Proporciona un date_range (si se omite, se devuelven los datos del trimestre más reciente con datos disponibles).
• Agrupa las métricas con un breakdown_definition.
• Especifica un código de moneda ISO 4217 de tres caracteres currency_code (si se omite, las métricas monetarias, como el CPM y el costo, se establecen de forma predeterminada en USD).
• Especifica un nombre de customer_benchmarks_group definido por el usuario para el cliente para el que se planifica.
• Solicita funciones adicionales, como PERCENTILE_DATA, a través de supplemental_data (en la versión 25 y posteriores).

Para obtener definiciones y requisitos completos de los parámetros, consulta la documentación de referencia de GenerateBenchmarksMetricsRequest.

Desgloses de fechas

Puedes agrupar las métricas configurando breakdown_definition.date_breakdown con BenchmarksTimeGranularity. Cuando se establece date_breakdown, se requiere date_range en GenerateBenchmarksMetricsRequest y debe alinearse con los límites del nivel de detalle seleccionado:

• WEEK: Agrega las métricas por semana. La date_range debe comenzar un domingo y terminar un sábado (ten en cuenta que esto difiere de la norma ISO 8601).
• MONTH: Agrega métricas por mes. El date_range debe comenzar el primer día del mes y finalizar el último día del mes.
• QUARTER: Agrega métricas por trimestre calendario. El date_range debe comenzar el primer día del trimestre y finalizar el último día del trimestre.

Métricas de respuesta

GenerateBenchmarksMetricsResponse devuelve lo siguiente:

• customer_metrics (del tipo CustomerMetrics en la versión 25 y posteriores; del tipo Metrics que solo contiene average_rate_metrics en la versión 24 y anteriores): Son métricas que representan el rendimiento de los anuncios de YouTube de un cliente, incluidas las siguientes:
  • average_rate_metrics: Son las métricas de tasa promedio para el cliente.
  • share_metrics (en la versión 25 y posteriores): Métricas de presencia relativa en el mercado (share_of_voice y share_of_spend). Solo se propaga cuando benchmarks_source selecciona all_advertisers = true (con category_filter establecido) y date_range se encuentra dentro de supported_dates_for_all_metrics.
  • aggregate_metrics (en la versión 25 y posteriores): Totales agregados para el cliente (como cost, impressions, clicks y video_trueview_views).
  • percentile_metrics (en la versión 25 y posteriores): Son los niveles de percentil de posición competitiva en las dimensiones clave.
• average_benchmarks_metrics: Son las métricas de tasa agregadas (RateMetrics) en la fuente de comparativas seleccionada.
• breakdown_metrics: Es una lista de métricas segmentadas por los desgloses definidos en breakdown_definition.

Para obtener las especificaciones completas de los campos, consulta la documentación de referencia de GenerateBenchmarksMetricsResponse.

Métricas de percentil

Nota: supplemental_data (BenchmarksSupplementalData) y percentile_metrics están disponibles en la versión 25 y posteriores.

Las métricas de percentil representan la posición competitiva de un cliente como niveles de percentil entre otros anunciantes dentro del análisis de alcance.

Requisitos previos

Para recuperar las métricas de percentiles, tu solicitud debe cumplir con los siguientes requisitos:

1. Fuente de comparativas: benchmarks_source debe seleccionar all_advertisers = true.
2. Filtro de categoría: Se debe proporcionar category_filter, que debe contener uno o más category_ids válidos recuperados de ListBenchmarksSources.
3. Datos complementarios: Debes agregar PERCENTILE_DATA al campo supplemental_data en GenerateBenchmarksMetricsRequest.

Niveles de percentiles

El rendimiento de un cliente se clasifica en uno de los siguientes valores de enumeración BenchmarksCustomerPercentileTier:

• DEVELOPING: Por debajo del percentil 10 ([0%, 10%)).
• ENTRY_LEVEL: Percentil 10 a 25 ([10%, 25%)).
• EMERGING_PLAYER: Percentil 25 a 50 ([25%, 50%)).
• COMPETITOR: percentil 50 a 75 ([50%, 75%)).
• STRONG_COMPETITOR: Percentil 75 a 90 ([75%, 90%)).
• MARKET_LEADER: En el percentil 90 o por encima de este ([90%, 100%]).

Ejemplo de solicitud

En el siguiente ejemplo, se ilustra una carga útil de solicitud JSON de REST para generar métricas de comparativas con niveles de percentiles para un usuario que compara el rendimiento de los anuncios de YouTube de su cliente con el de otros anunciantes que publican anuncios en la categoría /Apparel/Clothing:

{
  "customerId": "1234567890",
  "location": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "benchmarksSource": {
    "allAdvertisers": true
  },
  "categoryFilter": {
    "categoryIds": ["10176"]
  },
  "productFilter": {
    "marketingObjectiveList": {
      "marketingObjectives": ["AWARENESS", "CONSIDERATION"]
    }
  },
  "supplementalData": [
    "PERCENTILE_DATA"
  ]
}

La respuesta que incluye los datos de percentiles adicionales solicitados:

{
  "customerMetrics": {
    "averageRateMetrics": {
      "averageCpm": 5.42,
      "clickThroughRate": 0.0185
    },
    "shareMetrics": {
      "shareOfVoice": 0.0345,
      "shareOfSpend": 0.0410
    },
    "aggregateMetrics": {
      "cost": 15200.0,
      "impressions": 2800000.0,
      "clicks": 51800.0
    },
    "percentileMetrics": {
      "costPercentileTier": "STRONG_COMPETITOR",
      "impressionsPercentileTier": "STRONG_COMPETITOR",
      "clicksPercentileTier": "MARKET_LEADER",
      "videoTrueviewViewsPercentileTier": "COMPETITOR",
      "viewableImpressionsPercentileTier": "STRONG_COMPETITOR",
      "interactionsPercentileTier": "MARKET_LEADER",
      "engagementsPercentileTier": "COMPETITOR"
    }
  },
  "averageBenchmarksMetrics": {
    "averageRateMetrics": {
      "averageCpm": 6.15,
      "clickThroughRate": 0.0142
    }
  }
}

Manejo de errores

Cuando llamas a BenchmarksService, es posible que encuentres errores específicos de las consultas de comparativas en BenchmarksError:

• MAX_QUERY_COMPLEXITY_EXCEEDED: La combinación de entradas solicitadas es demasiado compleja para procesarla. Para reducir la complejidad de la consulta, haz lo siguiente:
  • Selecciona una fuente de comparativas o un filtro de categoría más específico o detallado.
  • Acorta el date_range solicitado.
  • Reduce la cantidad de productos en product_filter.
• NO_METRICS_FOUND (en la versión 25 y posteriores): No se encontraron métricas para la combinación de entradas solicitada (por ejemplo, una categoría de nicho en una ubicación y un período específicos en los que ningún anunciante publicó campañas). Intenta ajustar la categoría, la ubicación, el período o los productos.

Para conocer las prácticas recomendadas y el manejo general de errores de la API, consulta la guía de manejo de errores.

Herramienta de seguimiento de errores de Google

Usa la Herramienta de seguimiento de errores de Google para hacer preguntas de asistencia, informar errores o enviar solicitudes de funciones. Google hace un seguimiento, prioriza y publica actualizaciones sobre tus solicitudes directamente en Issue Tracker. Para obtener más información, consulta Crea un error en la Herramienta de seguimiento de errores de Google.

Crea un problema con una de las siguientes plantillas de Issue Tracker:

• Haz una pregunta de asistencia general o envía comentarios sobre la documentación
• Cómo informar un error técnico
• Envía una solicitud de función de la API

Completa todos los campos de la plantilla con información detallada para que Google pueda reproducir y priorizar tu solicitud. Google podría cerrar los informes incompletos y pedirte que envíes un nuevo problema con los detalles faltantes.