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.
Vista de posiciones administradas
- Qué muestra: El recurso
managed_placement_viewproporciona datos de rendimiento agregados por las posiciones a las que segmentas tus anuncios de forma explícita (posiciones administradas). Refleja el rendimiento de tus criterios dePlacement. - Equivalente en la IU: Contenido > Posiciones
- Compilador de consultas: Explora en el compilador de consultas
Consulta de ejemplo
Para recuperar las métricas de rendimiento de las posiciones administradas de los últimos 30 días, haz lo siguiente:
SELECT
campaign.id,
ad_group.id,
managed_placement_view.resource_name,
ad_group_criterion.placement.url,
metrics.impressions,
metrics.clicks,
metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS
Vista de posición en el grupo
- Qué muestra: El recurso
group_placement_viewmuestra 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
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.placementodetail_placement_view.placementtenga 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.
Opciones de TargetingSetting
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_viewrefleja en gran medidamanaged_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_viewes 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_viewproporciona 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").
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_viewevalúa el umbral en el dominio, la app para dispositivos móviles o el canal de YouTube agregados. - El recurso
detail_placement_viewevalú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_nameoplacement. - 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_nameytarget_urlsin establecer. - Nombres de recursos sintetizados: El sufijo
{base64_placement}en el camporesource_nameestá 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ónPlacementType. Cuando el campoplacement_typeesWEBSITE(ID interno14) y el campoplacementno está configurado, la cadena"14_"se codifica comoMTRf(de manera similar,MOBILE_APPLICATIONcodifica"55_"comoNTVf,YOUTUBE_VIDEOcodifica"89_"comoODlfyYOUTUBE_CHANNELcodifica"90_"comoOTBf). Por lo tanto, varias posiciones del mismo tipo con metadatos no disponibles en el mismo grupo de anuncios comparten el mismo valor deresource_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 el lenguaje de consulta de Google Ads, filtra por el campo target_url o display_name (por ejemplo, WHERE
detail_placement_view.target_url IS NOT NULL), ya que los campos placement y resource_name no se pueden filtrar.
Vista de posiciones de las campañas de máximo rendimiento
- Qué muestra: El recurso
performance_max_placement_viewproporciona 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 segmentarperformance_max_placement_viewporsegments.ad_network_type(no se admite en la versión 23). - Compilador de consultas: Explora en el compilador de consultas
¿Qué vista usar?
- Usa
managed_placement_viewpara evaluar el rendimiento de las posiciones para las que estableces ofertas y segmentaciones de forma activa. - Usa
group_placement_viewpara 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_viewpara 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 engroup_placement_view. - Usa
performance_max_placement_viewpara inspeccionar las impresiones de posición de las campañas de máximo rendimiento.