Realiza un seguimiento de la posición y el rendimiento de los anuncios

La API de Google Ads ofrece varias vistas para analizar dónde aparecieron tus anuncios y cómo tienen un buen rendimiento: managed_placement_view, group_placement_view, detail_placement_view y performance_max_placement_view. Cada vista proporciona una perspectiva diferente de tus datos de posición. Para obtener consultas listas para ejecutar en el lenguaje de consulta de Google Ads (GAQL) y curl que repliquen las pantallas de posiciones en la IU de Google Ads, consulta la guía de consultas.

Vista de posiciones administradas

• Qué muestra: El recurso managed_placement_view proporciona datos de rendimiento agregados por los criterios de posición positivos que segmentas en tus grupos de anuncios. Esta vista incluye los cinco tipos de criterios que se administran en Contenido > Posiciones en la IU de Google Ads: sitios web, canales de YouTube, videos de YouTube, apps para dispositivos móviles y categorías de apps para dispositivos móviles.
• Equivalente en la IU: Contenido > Posiciones
• Compilador de consultas: Explora en el compilador de consultas

Tipos de criterios de posición de segmentación

Cada fila del recurso managed_placement_view propaga el campo AdGroupCriterion que coincide con su valor ad_group_criterion.type y deja los otros campos de posición sin establecer:

Tipo de posición en la IU	Valor ad_group_criterion.type	Campos de detalles de los criterios	Notas
Sitios web	PLACEMENT	ad_group_criterion.placement.url	Es la URL del sitio web o dominio de destino.
Canales de YouTube	YOUTUBE_CHANNEL	ad_group_criterion.youtube_channel.channel_id	ID del canal de YouTube El campo ad_group_criterion.display_name devuelve el nombre del canal.
Videos de YouTube	YOUTUBE_VIDEO	ad_group_criterion.youtube_video.video_id	ID de video de YouTube El campo ad_group_criterion.display_name devuelve el título del video.
Apps	MOBILE_APPLICATION	ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name	ID de la app en formato {platform}-{platform_native_id} (1- para iOS, 2- para Android) y nombre de la app.
Categorías de apps	MOBILE_APP_CATEGORY	ad_group_criterion.mobile_app_category.mobile_app_category_constant	Es el nombre del recurso en formato mobileAppCategoryConstants/{mobile_app_category_id}. Consulta Nombres y jerarquía de las categorías de apps para dispositivos móviles.

Consulta de ejemplo

Para recuperar las métricas de rendimiento de todos los tipos de posiciones de segmentación de los últimos 30 días, selecciona el campo ad_group_criterion.type junto con los campos específicos del tipo:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.display_name,
  ad_group_criterion.placement.url,
  ad_group_criterion.youtube_channel.channel_id,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.mobile_application.app_id,
  ad_group_criterion.mobile_application.name,
  ad_group_criterion.mobile_app_category.mobile_app_category_constant,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

Nota: Seleccionar campos de segments (como segments.date) en la cláusula SELECT excluye las posiciones de segmentación con métricas de cero (consulta Excluye las métricas de cero con la segmentación). Para recuperar todos los criterios de posición configurados sin métricas, consulta el recurso ad_group_criterion directamente.

Nombres y jerarquía de las categorías de apps para dispositivos móviles

En la IU de Google Ads, las categorías de apps para dispositivos móviles segmentadas muestran su ruta de acceso completa a la tienda, como Categorías de aplicación > App Store de Apple > Educación. Cuando realices consultas en la API de Google Ads, ten en cuenta los siguientes comportamientos:

• Atribución de constantes de categoría de app para dispositivos móviles: El recurso mobile_app_category_constant no es un recurso atribuido del recurso managed_placement_view. En su lugar, selecciona el campo ad_group_criterion.mobile_app_category.mobile_app_category_constant (por ejemplo, mobileAppCategoryConstants/60503) o consulta el recurso ad_group_criterion cuando no necesites métricas.
• Nombres visibles solo de hoja: Los campos ad_group_criterion.display_name y mobile_app_category_constant.name devuelven solo el nombre de la categoría de hoja, como "Education" o "Games". Ninguno de los campos incluye la ruta de acceso de la tienda de aplicaciones superior.
• Resolución de la ruta de acceso de la tienda de aplicaciones: Google Play y la App Store de Apple comparten nombres de categorías de hoja en distintos IDs de criterios. Por ejemplo, los IDs de criterios 60005 (/All Apps/Google Play/Education), 60060 (/All Apps/Google Play/Family/Education) y 60503 (/All Apps/Apple App Store/Education) devuelven "Education" en los campos name y display_name. Extrae el sufijo {mobile_app_category_id} del nombre del recurso y busca su ruta de jerarquía completa en la tabla o el archivo CSV de Categorías de apps para dispositivos móviles.

Vista de posición en el grupo

• Qué muestra: El recurso group_placement_view muestra dónde se publicaron realmente tus anuncios en la Red de Display y YouTube, independientemente de si las posiciones se segmentaron de forma explícita o si el sistema de Google las descubrió automáticamente. Esto puede incluir sitios web, canales o videos de YouTube y apps.
• Equivalente en la IU: Contenido > Posiciones donde se mostraron los anuncios
• Compilador de consultas: Explora en el compilador de consultas

Consulta de ejemplo

La siguiente consulta recupera las métricas de rendimiento de los dominios, las aplicaciones para dispositivos móviles y los canales de YouTube en los que se mostraron anuncios durante los últimos 30 días:

SELECT
  campaign.id,
  ad_group.id,
  group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS

Fila "Total: Otros"

Para acelerar la generación de informes, los recursos group_placement_view y detail_placement_view excluyen las posiciones individuales que no cumplen con un umbral de actividad mínimo de impresiones o interacciones.

• En la IU de Google Ads: La IU agrega las posiciones que no cumplen con este umbral de actividad en una fila de resumen etiquetada como Total: Otras.
• En la API de Google Ads: La API omite las posiciones que no cumplen con el umbral de actividad de los resultados del informe y no devuelve una fila de resumen en la que el campo group_placement_view.placement o detail_placement_view.placement tenga el valor "Other".

Como resultado, la suma de las filas de posiciones individuales en los recursos group_placement_view y detail_placement_view podría ser inferior a las métricas totales del grupo de anuncios o de la campaña. Para obtener más información, consulta Acerca del informe "Posiciones donde se mostraron los anuncios". Para obtener detalles sobre cómo los umbrales y los metadatos faltantes afectan las comparaciones entre vistas, consulta Diferencias en las métricas entre las vistas de posición y Filas con detalles de posición no disponibles.

Configuración de la segmentación por posición

El comportamiento y la utilidad de group_placement_view se ven influenciados por TargetingSetting para la dimensión PLACEMENT a nivel del grupo de anuncios. Este parámetro de configuración contiene una lista de objetos target_restrictions, cada uno con un campo booleano bid_only que determina si tus anuncios se muestran solo en las posiciones de segmentación o también en otras posiciones. Consulta Acerca de la configuración de "Segmentación" y "Observación".

• bid_only = false: Este valor corresponde a Segmentación en la IU de Google Ads para las posiciones. Si tu grupo de anuncios está configurado como "Segmentación", tus anuncios solo se mostrarán en las posiciones que hayas agregado explícitamente como criterios. Puedes aplicar ajustes de la oferta a estas posiciones. En esta situación, group_placement_view refleja en gran medida managed_placement_view, pero sigue sujeto a umbrales de actividad mínimos.
• bid_only = true: Este valor corresponde a Observación en la IU de Google Ads para las posiciones. Si tu grupo de anuncios está configurado en "Observación", tus anuncios pueden mostrarse en cualquier posición apta de la Red de Display y YouTube. También puedes aplicar ajustes de la oferta a cualquier posición que hayas incluido en la segmentación. En este caso, group_placement_view es fundamental para descubrir posiciones nuevas en las que se muestran tus anuncios, que luego puedes agregar como posiciones administradas o exclusiones.

Vista de posiciones detallada

• Qué muestra: El recurso detail_placement_view proporciona un desglose más detallado de las posiciones, con información que va más allá del nivel del dominio o del canal. Por ejemplo, puede mostrar URLs o IDs de videos de YouTube específicos en los que aparecieron tus anuncios.
• Equivalente en la IU: Es equivalente a seleccionar filas en Contenido > Posiciones donde se mostraron los anuncios y, luego, hacer clic en Ver detalles.
• Compilador de consultas: Explora en el compilador de consultas
• Consideraciones importantes: Al igual que el recurso group_placement_view, esta vista omite las posiciones con poca actividad que no cumplen con los umbrales mínimos de actividad (consulta la sección Fila "Total: Otras").

Nota: El recurso detail_placement_view genera informes detallados (URLs individuales y IDs de video) y puede devolver datos de alta cardinalidad. Siempre filtra las consultas por períodos o campañas y grupos de anuncios específicos para evitar tamaños de carga útil grandes y tiempos de espera de consultas.

Consulta de ejemplo

Para limitar el volumen de resultados, la siguiente consulta recupera las métricas de posición a nivel de la URL y del video durante un período de 7 días. En el caso de las cuentas grandes, filtra aún más por el campo campaign.id o ad_group.id:

SELECT
  campaign.id,
  ad_group.id,
  detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

Para excluir las filas en las que no están disponibles los metadatos de posición, agrega AND detail_placement_view.target_url IS NOT NULL (consulta Filas con detalles de posición no disponibles). Cuando no necesites que se devuelvan campos resource_name, agrega la cláusula PARAMETERS omit_unselected_resource_names = true.

Diferencias de las métricas entre las vistas de posiciones

El umbral de actividad mínimo se evalúa de forma independiente en cada nivel de detallado:

• El recurso group_placement_view evalúa el umbral en el dominio, la app para dispositivos móviles o el canal de YouTube agregados.
• El recurso detail_placement_view evalúa el umbral por separado para cada URL de página o video de YouTube individual.

El recurso detail_placement_view omite las URLs de páginas individuales o los videos de YouTube que no cumplen con el umbral. Como resultado, sumar las filas de detail_placement_view para un dominio o canal de YouTube (filtradas por el campo detail_placement_view.group_placement_target_url) puede devolver menos impresiones que la fila de group_placement_view correspondiente.

Filas con detalles de posición no disponibles

Una consulta en el recurso group_placement_view o detail_placement_view puede devolver varias filas en el mismo grupo de anuncios con campos placement, display_name y target_url sin configurar y un valor resource_name idéntico (por ejemplo, que termine en ~MTRf).

Este comportamiento se produce por los siguientes motivos:

• Agrupación de posiciones internas: Ambas vistas agrupan las métricas de rendimiento por un identificador de posición interna único, en lugar de por los campos de cadena resource_name o placement.
• Metadatos de posición no disponibles: En la IU de Google Ads, las posiciones sin metadatos en las tablas de consulta de backend aparecen como Desconocido, El canal ya no está disponible o El video ya no está disponible. En la API, cada identificador de posición distinto sigue devolviendo una fila de métricas, con los campos placement, display_name y target_url sin establecer.
• Nombres de recursos sintetizados: El sufijo {base64_placement} en el campo resource_name está codificado en Base64 a partir de {type_id}_{placement}, donde {type_id} es un identificador interno del tipo de posición, en lugar del número de enumeración PlacementType. Cuando el campo placement_type es WEBSITE (ID interno 14) y el campo placement no está configurado, la cadena "14_" se codifica como MTRf (de manera similar, MOBILE_APPLICATION codifica "55_" como NTVf, YOUTUBE_VIDEO codifica "89_" como ODlf y YOUTUBE_CHANNEL codifica "90_" como OTBf). Por lo tanto, varias posiciones del mismo tipo con metadatos no disponibles en el mismo grupo de anuncios comparten el mismo valor de resource_name, mientras que informan filas de métricas independientes.

Cuando proceses los resultados de group_placement_view o detail_placement_view en el código del cliente, no anules la duplicación de filas solo por el campo resource_name, ya que, si lo haces, se pueden reemplazar las métricas en distintas posiciones con metadatos no disponibles. Para excluir filas con metadatos no disponibles en GAQL, filtra por el campo target_url o display_name, ya que los campos placement y resource_name no se pueden filtrar. Por ejemplo, usa WHERE group_placement_view.target_url IS NOT NULL o WHERE detail_placement_view.target_url IS NOT NULL.

Vista de posiciones de las campañas de máximo rendimiento

• Qué muestra: El recurso performance_max_placement_view proporciona datos de impresiones (metrics.impressions) para las posiciones en las que se publicaron anuncios de campañas de máximo rendimiento. En la versión 24 y posteriores, puedes segmentar performance_max_placement_view por segments.ad_network_type (no se admite en la versión 23).
• Equivalente en la IU: Informes y estadísticas > Editor de informes > Posición de las campañas de máximo rendimiento
• Compilador de consultas: Explora en el compilador de consultas

Consulta de ejemplo

La siguiente consulta recupera las impresiones de posición segmentadas por tipo de red de publicidad para las campañas de máximo rendimiento durante los últimos 30 días:

SELECT
  campaign.id,
  performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  segments.ad_network_type,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS

Elige una vista de posición

• Usa managed_placement_view para evaluar el rendimiento de las posiciones para las que estableces ofertas y segmentaciones de forma activa.
• Usa group_placement_view para comprender el alcance completo de los lugares en los que aparecen tus anuncios, especialmente cuando usas el parámetro de configuración "Observación", para descubrir nuevas oportunidades de segmentación o exclusiones.
• Usa detail_placement_view para obtener los detalles más detallados sobre las URLs o los videos específicos en los que se mostraron tus anuncios, que suelen usarse después de identificar un dominio o canal de interés en group_placement_view.
• Usa performance_max_placement_view para inspeccionar las impresiones de posición de las campañas de máximo rendimiento.