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. Las campañas de video no se pueden crear ni mutar con la API de Google Ads, con las siguientes excepciones y comportamientos específicos de la versión:

  • Mutabilidad de VideoResponsiveAdInfo: A partir de la versión 24, 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 la versión 24, se quita 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 24, 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:

  • Secuencias de comandos de Google Ads: Puedes administrar las campañas de video con las secuencias de comandos 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, tanto para su creación como para su 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'.

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

En el caso de las campañas de video, puedes consultar las métricas de Unique Reach en los recursos campaign y customer (a partir de la versión 26) 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.
  • De 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 completando 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). Esta métrica solo está disponible en el recurso campaign, no se puede agregar en las filas y no tiene un campo _info complementario.

En la versión 26 y posteriores, cada métrica de alcance de usuarios únicos 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 complementarios de metrics.unique_users*_info son métricas de MESSAGE con filterable: false y sortable: false, por lo que no puedes usarlos en cláusulas WHERE ni ORDER BY. Selecciona estos campos 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 del período 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 límites de privacidad, calidad o de otro tipo.
  • 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 sin duplicaciones de 30 días y sus estados de supresión para las campañas de video, segmentadas por dispositivo y formato del anuncio. Omite el segmento segments.date de la cláusula SELECT para que las métricas de alcance y frecuencia de N+ se anulen en todo el período, en lugar de por día:

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  segments.ad_format_type,
  segments.ad_sub_format_type,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

Recursos, períodos y segmentos admitidos

Las consultas de alcance y frecuencia requieren un filtro segments.date finito dentro de la ventana de fechas máxima de la métrica. Las consultas sin un filtro de fecha o que exceden la ventana devuelven campos de alcance sin establecer:

Métrica Recursos Período máximo Segmentos compatibles
metrics.unique_users campaign, customer (v26 y versiones posteriores) 92 días segments.date, segments.device, segmentos de formato del anuncio (v26 y versiones posteriores), segmentos de red de publicidad (v26 y versiones posteriores) y segmentos demográficos ajustados
metrics.average_impression_frequency_per_user campaign 92 días segments.date, segments.device y segmentos demográficos ajustados
metrics.unique_users_two_plus a metrics.unique_users_ten_plus campaign, customer (v26 y versiones posteriores) 31 días segments.date, segments.device, segmentos de formato del anuncio (v26 y versiones posteriores) y segmentos de red de publicidad (v26 y versiones posteriores)
metrics.unique_users*_info (v26 y versiones posteriores) campaign, customer Coincide con la métrica base segments.date, segments.device, segmentos de formato del anuncio y segmentos de red de publicidad

Cuando segmentes las consultas de alcance, aplica las siguientes restricciones de segmentación conjunta:

  • Segmentos de formato del anuncio frente a los de red de publicidad: Puedes segmentar por formato del anuncio (segments.ad_format_type, de forma opcional con segments.ad_sub_format_type) o por red de publicidad (segments.ad_network_type, de forma opcional con segments.ad_sub_network_type), pero no puedes combinar los segmentos de formato del anuncio y de red de publicidad en la misma consulta. Siempre selecciona el segmento superior (segments.ad_format_type o segments.ad_network_type) cuando selecciones su subsegmento. El segmento segments.ad_sub_format_type desglosa los anuncios in-stream que no se pueden omitir por duración y devuelve UNSEGMENTED para otros formatos de anuncios, mientras que el segmento segments.ad_sub_network_type desglosa las plataformas de YouTube (YOUTUBE_INSTREAM, YOUTUBE_INFEED y YOUTUBE_SHORTS) solo para las campañas de generación de demanda y devuelve UNSEGMENTED para las campañas de video.
  • Segmentos demográficos ajustados: Los segmentos segments.adjusted_age_range y segments.adjusted_gender solo están disponibles para las cuentas incluidas en la lista de entidades permitidas, se deben seleccionar juntos y no se pueden combinar con las métricas metrics.unique_users_*_plus, los campos metrics.unique_users*_info ni los segmentos de red de publicidad.