Campañas de video

Las campañas de video te permiten mostrar anuncios de video en YouTube y en sitios web y apps que se ejecutan en Socios de video de Google.

Limitaciones de la API

La API de Google Ads admite principalmente la recuperación y la generación de informes sobre las campañas de video, los grupos de anuncios, los anuncios y los criterios existentes. No se pueden crear ni modificar campañas de video con la API de Google Ads, con las siguientes excepciones y comportamientos específicos de la versión:

• Mutabilidad de VideoResponsiveAdInfo: A partir de v24, los objetos VideoResponsiveAdInfo son mutables (en versiones anteriores, son inmutables). Cuando creas o modificas VideoResponsiveAdInfo, los campos videos, business_name y logo_images son obligatorios.
• Idoneidad para la seguridad de la marca: A partir de v24, se quitará el parámetro campaign.video_brand_safety_suitability a nivel de la campaña. Consulta la idoneidad de la seguridad de la marca a nivel de la cuenta con customer.video_brand_safety_suitability.
• Experimentos de campañas de video: A partir de la versión v24, experiment.video_experiment está disponible para configurar experimentos de YOUTUBE_CUSTOM que consisten en campañas de video.

Alternativas para la administración de campañas

Si necesitas crear o administrar campañas de video de manera programática, considera las siguientes opciones:

• Scripts de Google Ads: Puedes administrar las campañas de video con los scripts de Google Ads. Esto permite la administración automatizada dentro de la interfaz de Google Ads.
• Campañas de generación de demanda: Si tu objetivo es publicar anuncios de video en las propiedades de Google, incluido YouTube, las campañas de generación de demanda son totalmente compatibles con la API de Google Ads para su creación y administración.

Obtén datos de rendimiento

Puedes recuperar los datos de rendimiento de tus campañas de video, grupos de anuncios y criterios con GoogleAdsService.SearchStream filtrando por campaign.advertising_channel_type = 'VIDEO'.

Nota: Usa metrics.video_trueview_views, metrics.video_trueview_view_rate y metrics.trueview_average_cpv para las métricas de vistas de TrueView. A partir de v25, también puedes seleccionar segments.ad_sub_format_type (junto con segments.ad_format_type) para desglosar los anuncios in-stream que no se pueden omitir por duración, así como las métricas de participación social de los videos (metrics.youtube_comments, metrics.youtube_likes y metrics.youtube_shares).

Rendimiento del grupo de anuncios

La siguiente consulta recupera las métricas de la campaña de video y del grupo de anuncios, incluidas las vistas de video de TrueView y las tasas de vistas completas por cuartil, del recurso ad_group:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  ad_group.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.video_trueview_views,
  metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'

Informes de posiciones y criterios de video

Debido a que ad_group_criterion no admite métricas ni segmentos directamente, usa recursos de vista de criterios, como managed_placement_view, para recuperar métricas de rendimiento de los videos de YouTube, los canales de YouTube o cualquier otra posición administrada que se hayan segmentado:

SELECT
  campaign.id,
  ad_group.id,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.youtube_channel.channel_id,
  metrics.impressions,
  metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
  AND segments.date DURING LAST_30_DAYS

Informes de alcance y frecuencia de las campañas

En el caso de las campañas de video, puedes consultar las métricas de Unique Reach en el recurso campaign para medir la cantidad de personas únicas a las que se les mostraron tus anuncios con frecuencias de impresiones específicas.

Las siguientes métricas de usuarios únicos miden el alcance de público en los segmentos de frecuencia:

• metrics.unique_users: Es la cantidad de personas únicas que vieron tu anuncio al menos una vez dentro del período seleccionado (hasta 92 días). No se puede agregar en varias filas.
• metrics.unique_users_two_plus a metrics.unique_users_ten_plus: Es la cantidad de personas únicas que vieron tu anuncio al menos de 2 a 10 veces, respectivamente, para períodos de hasta 31 días (con metrics.unique_users_six_plus a metrics.unique_users_nine_plus que completan el conjunto de 2 o más a 10 o más en la versión 26 y posteriores).
• metrics.average_impression_frequency_per_user: Es la cantidad promedio de veces que un usuario único vio tu anuncio durante el período solicitado (hasta 92 días). No se puede agregar en filas y no tiene un campo _info complementario.

En la versión 26 y posteriores, cada métrica de alcance tiene un campo de metadatos complementario de tipo ReachMetricInfo: metrics.unique_users_info y metrics.unique_users_two_plus_info a metrics.unique_users_ten_plus_info.

En el lenguaje de consulta de Google Ads (GAQL), los campos de alcance complementario son métricas de MESSAGE que se seleccionan directamente en la cláusula SELECT (por ejemplo, metrics.unique_users_info). No agregues .reach_metric_states en la cláusula SELECT, ya que la selección de campos de mensajes anidados en GAQL falla con UNRECOGNIZED_FIELD. En su lugar, si seleccionas metrics.unique_users_info, se muestra un mensaje ReachMetricInfo que contiene el campo de enumeración repetido reach_metric_states de tipo ReachMetricState, que describe si la métrica se suprimió o está completa.

Cada vez que se suprime una métrica de alcance o se encuentra fuera de la ventana de retención (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION o DATE_RANGE_BEYOND_RETENTION), su campo optional int64 en Metrics no se establece (lo que se evalúa como 0 si no se verifica la presencia del campo), mientras que LOW_QUALITY aún propaga la métrica numérica.

Los valores de la enumeración ReachMetricState indican el estado de los datos de alcance:

• COMPLETE: La métrica de alcance está completa y no se suprimió debido a la privacidad, la calidad ni otros límites.
• PRIVACY_SUPPRESSION: Se suprimieron los datos de alcance para proteger la privacidad del usuario (por ejemplo, cuando el volumen del público no cumple con los umbrales de k-anonimato).
• QUALITY_SUPPRESSION: Se suprimieron los datos de alcance debido a los requisitos de calidad de los datos.
• LOW_QUALITY: Se calculó la métrica de alcance, pero se marcó como de baja calidad.
• DATE_RANGE_BEYOND_RETENTION: Las métricas de alcance no están disponibles porque el período seleccionado supera el período de retención de datos de 3 años para los datos de alcance.

La siguiente consulta recupera las métricas de alcance y sus estados de supresión para una campaña de video:

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  segments.device,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.average_impression_frequency_per_user,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_three_plus,
  metrics.unique_users_three_plus_info,
  metrics.unique_users_four_plus,
  metrics.unique_users_four_plus_info,
  metrics.unique_users_five_plus,
  metrics.unique_users_five_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_seven_plus,
  metrics.unique_users_seven_plus_info,
  metrics.unique_users_eight_plus,
  metrics.unique_users_eight_plus_info,
  metrics.unique_users_nine_plus,
  metrics.unique_users_nine_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date BETWEEN '2026-01-01' AND '2026-01-31'

Nota: Las métricas de alcance y frecuencia no se pueden agregar en todas las filas. Si bien metrics.unique_users y metrics.average_impression_frequency_per_user admiten períodos de hasta 92 días y se pueden segmentar por segments.date, segments.device, segments.adjusted_age_range y segments.adjusted_gender, las métricas de intervalos de frecuencia de unique_users_*_plus (hasta 31 días) y todos los campos complementarios de metrics.unique_users*_info solo admiten segments.date y segments.device. Además, los campos complementarios de metrics.unique_users*_info son métricas de MESSAGE con filterable: false y sortable: false, por lo que no se pueden usar en cláusulas WHERE ni ORDER BY. Consulta Supresión de métricas de alcance y valores cero para obtener más detalles sobre cómo controlar las métricas de alcance suprimidas en los informes.