Informes de efectividad

Para medir el impacto causal de tus campañas publicitarias en la percepción de la marca, las conversiones, el valor de conversión y el comportamiento de búsqueda orgánica, consulta los recursos de informes de medición de efectividad en la API de Google Ads:

  • Informes de Brand Lift: Evalúan cómo la exposición a los anuncios influye en la percepción de la marca en los tipos de medición encuestados en la versión 25 y posteriores de la API de Google Ads.
  • Informes de Efectividad de conversiones: Miden las conversiones incrementales, el valor de conversión, el costo por conversión incremental (iCPA) y el retorno de la inversión publicitaria incremental (iROAS) en comparación con un grupo de control no expuesto en la API de Google Ads v25 y versiones posteriores, lo que incluye lo siguiente:
  • Informes de Efectividad de búsqueda: Cuantifican el aumento incremental en el volumen de búsquedas orgánicas en la Búsqueda de Google y YouTube impulsado por la exposición a los anuncios en la API de Google Ads v26 y versiones posteriores.

Para obtener informes de experimentos A/B estándar sobre los recursos experiment y campaign, consulta Cómo generar informes sobre experimentos.

Informes de Brand Lift

Para evaluar cómo tus campañas publicitarias influyen en la percepción de la marca en la API de Google Ads v25 y versiones posteriores, consulta los recursos dedicados de medición de Brand Lift.

Recursos de Brand Lift y vistas de desglose

Los parámetros de configuración, los períodos de publicación y las vistas de desglose de Brand Lift son de solo lectura en la API de Google Ads (todos los campos son OUTPUT_ONLY) y se configuran en la IU de Google Ads o con tu representante de Google o contacto de GPS. Consulta estos recursos con el parámetro customer_id de la cuenta (cuenta de administrador o cuenta infantil) propietaria del estudio.

Consulta el recurso LiftMeasurementFlight para recuperar los metadatos de la programación de Brand Lift y la recopilación de encuestas a nivel del período de publicación, incluido el estado del período de publicación (lift_measurement_flight.status, definido por la enumeración LiftMeasurementFlightStatus con los valores ENABLED para los períodos de publicación activos y STOPPED para los períodos de publicación detenidos manualmente), los intervalos de fechas del período de publicación (lift_measurement_flight.start_date y lift_measurement_flight.end_date) en la zona horaria del cliente y el progreso de la recopilación de respuestas de la encuesta objetivo (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, donde 0 equivale al 0% y 1000000 equivale al 100%). Para determinar si un vuelo de ENABLED está en curso o se completó, compara la fecha actual en la zona horaria del cliente con lift_measurement_flight.start_date y lift_measurement_flight.end_date, y verifica si response_collection_ratio_micros alcanzó 1000000.

Consulta el recurso LiftMeasurementConfig para recuperar las métricas generales de Brand Lift a nivel del estudio o consulta los siguientes recursos de desglose para analizar las métricas de Brand Lift en dimensiones específicas:

Incluye el segmento segments.brand_lift_measurement_type para desglosar las métricas de Brand Lift por tipo de pregunta de la encuesta, definido por la enumeración BrandLiftMeasurementType (como RECALL o AWARENESS). Cuando omites el segmento segments.brand_lift_measurement_type, la API devuelve métricas para un solo tipo de medición seleccionado automáticamente por porción. Incluye el segmento segments.date para desglosar las métricas de Brand Lift por fecha (YYYY-MM-DD). La métrica metrics.cost_per_lifted_cookie se devuelve en micros de la moneda de la cuenta propietaria del estudio.

En la versión 27 y posteriores de la API de Google Ads, también puedes seleccionar el campo lift_guidance de solo lectura (OUTPUT_ONLY) (lift_guidance.outcome y lift_guidance.guidance_message, de tipo LiftGuidance) en la cláusula SELECT del lenguaje de consulta de Google Ads (GAQL) en lift_measurement_config y en los cinco recursos de desglose de Brand Lift (lift_measurement_age_range, lift_measurement_campaign, lift_measurement_device, lift_measurement_gender y lift_measurement_video) para recibir una interpretación estadística a nivel de la fila. En lift_measurement_config, lift_guidance se propaga solo cuando la consulta también selecciona o filtra métricas o segmentos de efectividad (se omite en las consultas de configuración solo de metadatos), y lift_guidance.guidance_message puede contener vínculos de Markdown intercalados (como [Learn more](https://support.google.com/...)). No puedes filtrar ni ordenar los subcampos de lift_guidance en las cláusulas WHERE o ORDER BY. Para obtener descripciones de los valores de LiftOutcomeEnum.LiftOutcome que se devuelven en lift_guidance.outcome, consulta Interpreta los resultados de Brand Lift.

Umbrales de generación de informes y respuestas vacías

Los informes de Brand Lift están restringidos por latencia (requieren un retraso de la canalización de 24 a 48 horas después de que comienza un estudio) y restringidos por respuesta por tipo de medición encuestada (segments.brand_lift_measurement_type) para satisfacer los umbrales de privacidad y de generación de informes estadísticos:

  • Tasas de respuestas positivas (metrics.brand_lift_baseline_positive_response_rate* y metrics.brand_lift_exposed_positive_response_rate*): Al menos 50 respuestas de la encuesta en el grupo correspondiente (expuesto o de control).
  • Umbral estricto de efectividad positiva (estudio general sobre LiftMeasurementConfig o porción independiente): Efectividad estadísticamente positiva (p_value <= 0.50) con, al menos, 2,000 respuestas totales y 860 respuestas por grupo.
  • Umbral de efectividad positiva de porción relajado (en un recurso de desglose cuando el estudio general cumple con el umbral estricto con efectividad positiva): Efectividad estadísticamente positiva (p_value <= 0.50) con al menos 500 respuestas totales y 200 respuestas por grupo.
  • Umbral de efectividad no positiva completa (NO_SIGNIFICANT_LIFT en comparación con NOT_ENOUGH_DATA): Al menos 4,100 respuestas totales por métrica cuando no se detecta una efectividad estadísticamente positiva.

Las consultas a LiftMeasurementConfig y los cinco recursos de desglose de Brand Lift (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign y LiftMeasurementVideo) devuelven una respuesta vacía (results: []) en lugar de un error en los siguientes casos:

  • El parámetro customer_id consultado no está en la lista de entidades permitidas o no es el propietario del estudio.
  • Los filtros de fecha de WHERE quedan fuera de las fechas de publicación evaluadas (lift_measurement_flight.start_date y lift_measurement_flight.end_date).
  • El estudio o el segmento específico de datos demográficos, dispositivos, campañas o videos no cumplió con los umbrales de demora de informes de 24 a 48 horas ni con los de volumen de respuestas a la encuesta, incluso cuando LiftMeasurementConfig devuelve los resultados generales del estudio.

Para solucionar problemas de respuestas vacías, completa los siguientes pasos:

  1. Consulta lift_measurement_flight para verificar que lift_measurement_flight.status = 'ENABLED', comprueba que los filtros de fecha de WHERE estén dentro de lift_measurement_flight.start_date y lift_measurement_flight.end_date, y, luego, inspecciona el progreso de la encuesta en lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros (donde 1000000 es igual al 100%).
  2. Consulta LiftMeasurementConfig para confirmar si el estudio general generó métricas de Brand Lift que se puedan incluir en informes antes de consultar los recursos de desglose dimensional.

Interpreta los resultados de Brand Lift

En la versión 27 y posteriores de la API de Google Ads, el campo lift_guidance.outcome devuelve un valor LiftOutcomeEnum.LiftOutcome que clasifica el estado estadístico de cada fila devuelta junto con consejos de corrección legibles por humanos en lift_guidance.guidance_message:

  • Resultados del estudio en curso (cuando lift_measurement_flight.status es ENABLED y la fecha actual en la zona horaria del cliente es igual o anterior a lift_measurement_flight.end_date con lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros inferior a 1000000):
    • STUDY_IN_PROGRESS_WITH_LIFT: El estudio está en curso y está surgiendo una efectividad positiva preliminar.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: El estudio está en curso con un volumen inicial suficiente, y aún no se detectó una efectividad con importancia estadística.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: El estudio está en curso y recopila activamente las respuestas iniciales de la encuesta para alcanzar los umbrales de informes estadísticos.
  • Resultados del estudio completado (cuando transcurrió lift_measurement_flight.end_date o lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros alcanzó 1000000):
    • POSITIVE_LIFT_DETECTED: Se detectó una efectividad positiva con importancia estadística para el estudio o el segmento completado.
    • NO_SIGNIFICANT_LIFT: El estudio o segmento completado cumplió con los umbrales de precisión estadística (al menos 4,100 respuestas totales por métrica) y no se detectó una efectividad positiva con importancia estadística.
    • NOT_ENOUGH_DATA: El estudio o segmento completado no cumplió con los umbrales de respuestas de la encuesta requeridos para la generación de informes estadísticos (al menos 2,000 respuestas en total y 860 por grupo para la efectividad positiva en el estudio general, 500 respuestas en total y 200 por grupo para la efectividad positiva en un segmento cuando el estudio general tiene una efectividad positiva, o 4,100 respuestas en total por métrica cuando no se detecta una efectividad positiva).

Aplica los siguientes lineamientos cuando interpretes los resultados de Brand Lift:

  • Períodos de publicación en curso frente a completados (STUDY_IN_PROGRESS_*): Mientras un período de publicación del estudio de ENABLED aún está en curso (antes de que transcurran lift_measurement_flight.end_date y antes de que response_collection_ratio_micros alcance 1000000), las respuestas de la encuesta y el modelado con corrección de sesgo aún se están estabilizando. Trata las métricas en curso como preliminares y evita detener las campañas o reducir los presupuestos hasta que se complete el período de publicación.
  • Efectividad positiva (POSITIVE_LIFT_DETECTED): Cuando se detecta una efectividad de Brand Lift positiva, consulta los recursos de desglose dimensional (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign y LiftMeasurementVideo) para identificar las cohortes de público con un alto rendimiento ("puntos destacados") y evaluar la resonancia de las creatividades en todo el embudo de la marca.
  • Datos insuficientes o sin efectividad significativa (NOT_ENOUGH_DATA o NO_SIGNIFICANT_LIFT): Cuando el volumen de respuestas de la encuesta es insuficiente (menos de 4,100 respuestas totales por métrica sin efectividad positiva, o menos de los umbrales de porción estrictos de 2,000/860 o relajados de 500/200 para la efectividad positiva) o no se detecta una efectividad con importancia estadística en una porción, no consideres esto como un fracaso de la campaña ni excluyas públicos en función de la insuficiencia de la muestra de una sola porción. Verifica las métricas generales del estudio en LiftMeasurementConfig, consulta otros valores de segments.brand_lift_measurement_type encuestados (como RECALL o AWARENESS del embudo superior) y verifica las dimensiones de desglose restantes.

Ejemplos de consultas de Brand Lift

Debido a que los metadatos de la prueba de efectividad de diseño y las estadísticas de efectividad se encuentran en recursos separados, la consulta de los detalles de la prueba de efectividad de diseño y las estadísticas de rendimiento requiere consultas de GAQL separadas.

Consulta de detalles del vuelo

Para recuperar los metadatos de un período de Brand Lift, como su estado, tipo de medición, fechas programadas y progreso de la recopilación de encuestas, consulta el recurso LiftMeasurementFlight:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date,
  lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'SURVEY'

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad (lift_measurement_config.lift_measurement_config_id).

Consulta de estadísticas

Para recuperar las métricas de Brand Lift, consulta el recurso LiftMeasurementConfig o el recurso de desglose correspondiente. Por ejemplo, la siguiente consulta recupera las métricas de Brand Lift segmentadas por campaña y tipo de medición de Brand Lift del recurso LiftMeasurementCampaign:

SELECT
  lift_measurement_campaign.lift_measurement_config_id,
  lift_measurement_campaign.campaign,
  segments.brand_lift_measurement_type,
  metrics.absolute_brand_lift,
  metrics.relative_brand_lift
FROM lift_measurement_campaign
WHERE lift_measurement_campaign.lift_measurement_config_id = CONFIG_ID

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.

Informes de Efectividad de conversiones

En la versión 25 y posteriores de la API de Google Ads, los informes de efectividad de conversiones miden el impacto incremental de tus anuncios en las conversiones y el valor de conversión. Los estudios de Efectividad de conversiones comparan el comportamiento de conversión entre un grupo expuesto (usuarios que eran aptos para ver tus anuncios) y un grupo de control no expuesto (usuarios a los que se les impidió ver tus anuncios).

Los parámetros de configuración, los períodos de publicación y los vínculos de experimentos de Efectividad de conversiones son de solo lectura en la API de Google Ads (todos los campos son OUTPUT_ONLY) y se configuran en la IU de Google Ads o con tu representante de Google o contacto de GPS. Consulta el recurso lift_measurement_config con el parámetro customer_id de la cuenta propietaria del estudio. Una cuenta de administrador puede consultar directamente los estudios de efectividad de conversiones de varias cuentas que le pertenecen. Consulta los estudios que pertenecen a una cuenta secundaria con el parámetro customer_id de la cuenta secundaria (autenticado de forma opcional con el encabezado login-customer-id).

Los informes de efectividad de conversiones admiten dos flujos de trabajo de estudio, que comparten el mismo descubrimiento de estudios y períodos de publicación, intervalos de fechas acumulativos de instantáneas y alcances de acciones de conversión:

  • Informes de efectividad de conversiones independientes: Miden la incrementalidad general, el costo por conversión incremental (CPA incremental) y el retorno de la inversión publicitaria incremental (ROAS incremental) en las acciones de conversión seleccionadas o en todas las acciones de conversión de las campañas medidas en el estudio.
  • Informes de pruebas A/B y de efectividad de conversiones: Mide la incrementalidad por grupo y las puntuaciones bayesianas de los ganadores entre dos grupos experimentales que compiten (control frente a tratamiento), junto con la incrementalidad general del estudio.

Para obtener ayuda con la creación de consultas válidas para el recurso lift_measurement_config, utiliza la herramienta Compilador de consultas de Google Ads.

En la versión 27 y posteriores de la API de Google Ads, puedes seleccionar el campo de solo lectura (OUTPUT_ONLY) lift_measurement_config.lift_guidance (lift_guidance.outcome y lift_guidance.guidance_message, de tipo LiftGuidance) en la cláusula SELECT de GAQL en lift_measurement_config para recibir una interpretación estadística a nivel de la fila para las búsquedas independientes de efectividad de conversiones y de efectividad de conversiones + A/B. En lift_measurement_config, lift_guidance se propaga solo cuando la consulta también selecciona o filtra métricas o segmentos de efectividad (se omite en las consultas de configuración solo de metadatos), y lift_guidance.guidance_message puede contener vínculos de Markdown intercalados (como [Learn more](https://support.google.com/...)). No puedes filtrar ni ordenar subcampos de lift_guidance en cláusulas WHERE o ORDER BY. El campo lift_guidance.outcome devuelve uno de los siguientes valores de LiftOutcomeEnum.LiftOutcome:

  • Resultados del estudio en curso (cuando lift_measurement_flight.status es ENABLED y la fecha actual en la zona horaria del cliente es lift_measurement_flight.end_date o anterior):
    • STUDY_IN_PROGRESS_WITH_LIFT: El estudio está en curso y está surgiendo una efectividad positiva preliminar.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: El estudio está en curso con un volumen inicial suficiente, y aún no se detectó una efectividad con importancia estadística.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: El estudio está en curso y recopila activamente datos de conversiones iniciales para alcanzar los umbrales de informes estadísticos.
  • Resultados del estudio completado (cuando haya transcurrido lift_measurement_flight.end_date):
    • POSITIVE_LIFT_DETECTED: Se detectó una efectividad positiva con importancia estadística para el estudio, el grupo experimental o el segmento completados.
    • AB_WINNER_WITH_LIFT: Es un estudio de prueba A/B y de efectividad de conversiones que se completó con un grupo experimental ganador en una comparación directa y una efectividad positiva con importancia estadística en comparación con el grupo de control no expuesto.
    • AB_WINNER_PARITY_VS_CONTROL: Se completó un estudio de efectividad de conversiones y de tipo A/B con un grupo experimental ganador en una comparación directa, pero con paridad con el grupo de control no expuesto.
    • NO_SIGNIFICANT_LIFT: El estudio, el grupo experimental o la porción completados cumplieron con los umbrales de precisión estadística, y no se detectó una efectividad positiva con importancia estadística.
    • NOT_ENOUGH_DATA: El estudio, el grupo experimental o el segmento completados no acumularon suficientes conversiones para alcanzar los umbrales de precisión estadística.

Descubre las configuraciones de estudio y los vuelos

Para generar un informe sobre un estudio de Efectividad de conversiones, primero descubre la configuración del estudio y su programa de publicación:

  1. Recupera la configuración del estudio: Consulta el recurso LiftMeasurementConfig para recuperar el nombre del estudio, el porcentaje de aislamiento (lift_measurement_config.conversion_lift_holdback_ratio_micros), las acciones de conversión con seguimiento (lift_measurement_config.conversion_actions) y, en la versión 26 y posteriores de la API de Google Ads, las campañas vinculadas activamente (lift_measurement_config.campaigns). El campo conversion_lift_holdback_ratio_micros se expresa en micros, donde 1,000,000 equivale al 100% (por ejemplo, 300000 representa un grupo de aislamiento no expuesto del 30%). Si no conoces el CONFIG_ID del estudio, omite la cláusula WHERE para enumerar todas las configuraciones de estudio de la cuenta.
  2. Recupera los períodos de observación de vuelos: Consulta el recurso LiftMeasurementFlight para encontrar las fechas de los vuelos programados (lift_measurement_flight.start_date y lift_measurement_flight.end_date) en la zona horaria del cliente. Debido a que un solo recurso LiftMeasurementConfig puede agrupar períodos de Brand Lift (SURVEY), Efectividad de conversiones (CONVERSION) y Efectividad de búsqueda (SEARCH), incluye el campo lift_measurement_flight.lift_type en la cláusula SELECT y filtra por lift_measurement_flight.lift_type = 'CONVERSION' en la cláusula WHERE. Los campos lift_measurement_flight.start_date y lift_measurement_flight.end_date se pueden ordenar en cláusulas ORDER BY, pero no puedes filtrarlos en una cláusula WHERE.

La siguiente consulta recupera la configuración del estudio (omite el campo lift_measurement_config.campaigns en la versión 25 de la API de Google Ads, ya que ese campo requiere la versión 26 de la API de Google Ads y versiones posteriores):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  lift_measurement_config.name,
  lift_measurement_config.conversion_lift_holdback_ratio_micros,
  lift_measurement_config.conversion_actions,
  lift_measurement_config.campaigns
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad (lift_measurement_config.lift_measurement_config_id).

La siguiente consulta recupera el programa de publicación de la Efectividad de conversiones para el estudio:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'CONVERSION'

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad (lift_measurement_config.lift_measurement_config_id).

En la versión 26 y posteriores de la API de Google Ads, también puedes descubrir la configuración de la medición de efectividad vinculada a una campaña directamente desde el recurso campaign consultando el campo campaign.lift_measurement_config. Consultar este campo evita tener que comparar datos mediante referencia cruzada del recurso LiftMeasurementConfig por separado:

SELECT
  campaign.id,
  campaign.lift_measurement_config
FROM campaign
WHERE campaign.id = CAMPAIGN_ID

Reemplaza lo siguiente:

  • CAMPAIGN_ID: Es el ID de número entero de la campaña (campaign.id).

El campo campaign.lift_measurement_config devuelve un nombre de recurso en el formato customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID. Si una campaña participó en varios estudios de efectividad, este campo identifica la configuración vinculada más recientemente (activa o inactiva). En cambio, el campo lift_measurement_config.campaigns solo muestra las campañas vinculadas de forma activa.

Consulta los períodos de instantáneas acumulativas

Los resultados de la Efectividad de conversiones se estructuran como instantáneas de evaluación acumulativa diaria a partir de la fecha de inicio del período de publicación:

Tanto segments.conversion_lift_start_date como segments.conversion_lift_end_date son campos INT64 con formato de números enteros de 8 dígitos sin comillas ni guiones en formato YYYYMMDD (por ejemplo, 20260501). En cambio, los campos lift_measurement_flight.start_date y lift_measurement_flight.end_date devuelven cadenas de fecha en formato ISO 8601 YYYY-MM-DD (por ejemplo, 2026-05-01). A diferencia de las consultas de Brand Lift y de efectividad de búsqueda, el segmento segments.date no es compatible con ninguna métrica ni segmento de efectividad de conversiones. Si seleccionas el segmento segments.date junto con los segmentos de Efectividad de conversiones (como segments.conversion_lift_start_date) en la cláusula SELECT, se devuelve un error QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE, mientras que si combinas segments.date con las métricas de Efectividad de conversiones, se devuelve un error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.

La instantánea calculada más reciente puede retrasarse con respecto a la fecha de finalización de un vuelo activo mientras se procesan los datos. Siempre consulta el recurso lift_measurement_config para obtener los pares (segments.conversion_lift_start_date, segments.conversion_lift_end_date) disponibles ordenados por segments.conversion_lift_end_date DESC primero para identificar la instantánea evaluada más reciente.

La siguiente consulta recupera los períodos de instantáneas disponibles para un estudio:

SELECT
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'
ORDER BY segments.conversion_lift_end_date DESC

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.

Cómo filtrar por alcance de la acción de conversión

La efectividad de conversiones evalúa la incrementalidad en dos alcances definidos por el segmento segments.conversion_lift_included_conversion_action_types:

  • SELECTED: Son las acciones de conversión seleccionadas durante la configuración del estudio o todas las acciones de conversión aptas para ofertas (principales) si no se especificaron acciones de conversión personalizadas.
  • ALL: Todas las acciones de conversión de las campañas que se miden en el estudio.

Cuando consultas el recurso lift_measurement_config para obtener las métricas de efectividad de conversiones sin filtrar el segmento segments.conversion_lift_included_conversion_action_types, la API devuelve dos filas por porción: una para ALL y otra para SELECTED. En GAQL, cualquier campo de segmento que no sea de fecha (y cualquier segmento de fecha de instantánea de efectividad de conversiones) filtrado en la cláusula WHERE también debe aparecer en la cláusula SELECT. De lo contrario, la API devuelve un error QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE. Cuando filtres por segments.conversion_lift_included_conversion_action_types = 'SELECTED' en la cláusula WHERE, incluye ese segmento en la cláusula SELECT.

Informes de Efectividad de conversiones independientes

Los estudios de Efectividad de conversiones independientes miden el impacto incremental de tus anuncios en comparación con un grupo de aislamiento no expuesto sin dividir las campañas en grupos de tratamiento que compiten entre sí.

Cómo consultar la efectividad de conversiones y el CPA incremental

Los informes de Efectividad de conversiones muestran estimaciones puntuales junto con límites de confianza unilaterales del 90% (*_p90_lower_bound y *_p90_upper_bound, que juntos forman un intervalo de confianza bilateral del 80%) y valores p (p_value <= 0.10 corresponde a una importancia estadística unilateral del 90%):

La API omite las métricas de Efectividad de conversiones en las filas devueltas en los siguientes casos:

  • La ventana de instantánea inclusiva es de menos de 4 días.
  • El volumen de conversiones observadas sin ajustar es inferior a los umbrales de precisión mínimos (menos de 65 conversiones de referencia observadas en el grupo de aislamiento o menos de 150 conversiones expuestas observadas, evaluadas antes de ajustar metrics.conversion_lift_baseline_conversions).
  • La efectividad medida no es positiva (metrics.incremental_conversions_p_value > 0.5 para las métricas de conversiones o metrics.incremental_conversion_value_p_value > 0.5 para las métricas de valor de conversión).
  • En la API de Google Ads v27 y versiones posteriores, las métricas de iROAS (metrics.incremental_conversion_value_per_cost*) y las métricas de puntuación ganadora del valor de conversión (metrics.incremental_conversion_value_winner_score y metrics.incremental_conversion_value_per_cost_winner_score) se consultan en un estudio que se configuró durante la configuración con la cantidad de conversiones en lugar del valor de conversión como su métrica principal. Las métricas de valor de conversión sin costo (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* y metrics.relative_conversion_value_lift*) se siguen propagando en los estudios principales de recuento de conversiones cada vez que se puede informar la efectividad del valor de conversión.
  • Se agregan varias filas o estudios porque omitiste los campos lift_measurement_config.lift_measurement_config_id, segments.conversion_lift_start_date, segments.conversion_lift_end_date o segments.conversion_lift_included_conversion_action_types de la cláusula SELECT.

Aplica los siguientes lineamientos cuando interpretes los resultados de la Efectividad de conversiones independiente:

  • Vuelos en curso en comparación con los completados (STUDY_IN_PROGRESS_*): Mientras un vuelo de estudio de ENABLED aún está en curso (cuando la fecha actual en la zona horaria del cliente es el lift_measurement_flight.end_date o una fecha anterior), el modelado de conversiones de referencia y de tratamiento, y la atribución de conversiones retrasadas aún se están estabilizando. Trata las métricas en curso como preliminares y evita detener las campañas o reducir los presupuestos hasta que finalice el período de publicación.
  • Efectividad positiva (POSITIVE_LIFT_DETECTED): Es la capacidad de generar informes de la métrica de efectividad de conversiones y el activador lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED' cada vez que la efectividad medida es positiva (p_value <= 0.50, que corresponde a, al menos, un 50% de certeza con una estimación de puntos positiva, mientras que p_value <= 0.10 indica un 90% de importancia estadística unilateral donde *_p90_lower_bound >= 0) y se cumplen los umbrales de precisión mínimos (al menos 4 días de instantáneas, al menos 65 conversiones de referencia sin ajustar y al menos 150 conversiones expuestas sin ajustar). Cuando se detecte una efectividad positiva, consulta los desgloses dimensionales (datos demográficos, dispositivo, país o categoría de conversiones y acción de conversión) para identificar las cohortes de alto rendimiento ("puntos destacados").
  • Datos insuficientes o sin efectividad significativa (NOT_ENOUGH_DATA o NO_SIGNIFICANT_LIFT): Cuando el volumen de datos es insuficiente (menos de 65 conversiones de referencia sin ajustar o menos de 150 conversiones expuestas sin ajustar) o no se detecta una efectividad con importancia estadística en un segmento, no consideres que la campaña falló ni excluyas públicos en función de la insuficiencia de la muestra de un solo segmento. Verifica las métricas generales del estudio y consulta segments.conversion_lift_included_conversion_action_types = 'ALL' (si SELECTED no muestra efectividad) o los desgloses dimensionales restantes para verificar si la efectividad positiva se aisló en otro lugar.

La siguiente consulta recupera la incrementalidad de las conversiones generales, los límites de confianza y el iCPA:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.incremental_conversions_p90_lower_bound,
  metrics.incremental_conversions_p90_upper_bound,
  metrics.incremental_conversions_p_value,
  metrics.cost_per_incremental_conversion,
  metrics.cost_per_incremental_conversion_p90_lower_bound,
  metrics.cost_per_incremental_conversion_p90_upper_bound,
  metrics.relative_conversion_lift,
  metrics.relative_conversion_lift_p90_lower_bound,
  metrics.relative_conversion_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.
  • START_DATE: Es la fecha de inicio de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260501).
  • END_DATE: Es la fecha de finalización de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260515).

Cómo consultar el aumento del valor de conversión y el iROAS

Para evaluar los ingresos incrementales que genera tu inversión publicitaria, consulta las métricas de valor de conversión y la métrica metrics.incremental_conversion_value_per_cost. Las métricas de valor de conversión que no son de costo (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* y metrics.relative_conversion_value_lift*) se completan cada vez que el estudio tiene un aumento del valor de conversión que se puede registrar, independientemente de si la métrica principal del estudio es la cantidad de conversiones o el valor de conversión. En la versión 27 y posteriores de la API de Google Ads, las métricas de iROAS (metrics.incremental_conversion_value_per_cost*), junto con metrics.incremental_conversion_value_winner_score y metrics.incremental_conversion_value_per_cost_winner_score, solo se devuelven cuando el estudio se configuró durante la configuración con el valor de conversión como su métrica principal (y se omiten en los estudios de recuento de conversiones principales):

La siguiente consulta recupera la incrementalidad del valor de conversión, los límites de confianza y el iROAS:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversion_value,
  metrics.conversion_lift_exposed_conversion_value,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_p90_lower_bound,
  metrics.incremental_conversion_value_p90_upper_bound,
  metrics.incremental_conversion_value_p_value,
  metrics.incremental_conversion_value_per_cost,
  metrics.incremental_conversion_value_per_cost_p90_lower_bound,
  metrics.incremental_conversion_value_per_cost_p90_upper_bound,
  metrics.relative_conversion_value_lift,
  metrics.relative_conversion_value_lift_p90_lower_bound,
  metrics.relative_conversion_value_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.
  • START_DATE: Es la fecha de inicio de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260501).
  • END_DATE: Es la fecha de finalización de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260515).

Segmenta los resultados por dimensión

Segmenta las métricas de conversiones incrementales por categoría de conversiones, acción de conversión, datos demográficos, dispositivo o ubicación geográfica. Cuando consultes el recurso lift_measurement_config, selecciona solo las combinaciones de segmentos compatibles:

Si seleccionas segmentos incompatibles entre sí en la cláusula SELECT, la validación de la consulta fallará y se devolverá un error QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Usa el Compilador de consultas de Google Ads para validar las combinaciones de segmentos de forma interactiva.

Evalúa las métricas de rentabilidad (metrics.cost_per_incremental_conversion* y metrics.incremental_conversion_value_per_cost*) solo en las filas de estudio general o en las filas segments.experiment_arm. En las versiones 25 y 26 de la API de Google Ads, el esquema permite seleccionar las seis métricas de proporción de costos (metrics.cost_per_incremental_conversion, metrics.cost_per_incremental_conversion_p90_lower_bound, metrics.cost_per_incremental_conversion_p90_upper_bound, metrics.incremental_conversion_value_per_cost, metrics.incremental_conversion_value_per_cost_p90_lower_bound y metrics.incremental_conversion_value_per_cost_p90_upper_bound) con los ocho segmentos de porciones que no son de grupos (segments.conversion_action, segments.conversion_action_name, segments.conversion_lift_conversion_category, segments.age_range, segments.gender, segments.device, segments.country y segments.country_localized_name). A partir de la versión 27 de la API de Google Ads, si seleccionas cualquiera de estas seis métricas de proporción de costos con cualquiera de esos ocho segmentos de porciones que no son de grupos, se producirá un error en la validación de la consulta y se mostrará un error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE. Las métricas de valor de conversión sin costo (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* y metrics.relative_conversion_value_lift*) siguen siendo compatibles con los segmentos de categoría de conversión, acción de conversión, datos demográficos, dispositivo y país siempre que se pueda generar un informe sobre la efectividad del valor de conversión (independientemente de si la métrica principal del estudio es la cantidad de conversiones o el valor de conversión).

Para evaluar la efectividad en las categorías de conversiones definidas en la enumeración ConversionActionCategory (como PURCHASE, SIGNUP o SUBMIT_LEAD_FORM), segmenta los resultados por el segmento segments.conversion_lift_conversion_category:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.
  • START_DATE: Es la fecha de inicio de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260501).
  • END_DATE: Es la fecha de finalización de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260515).

El segmento segments.conversion_action devuelve el nombre del recurso de la acción de conversión en el formato customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID. Selecciona el segmento segments.conversion_action_name en el recurso lift_measurement_config para recuperar nombres de acciones de conversión legibles por humanos sin consultar el recurso conversion_action por separado. La siguiente consulta segmenta las métricas de Efectividad de conversiones por acción de conversión, nombre de la acción de conversión y categoría de conversiones:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_action,
  segments.conversion_action_name,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.
  • START_DATE: Es la fecha de inicio de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260501).
  • END_DATE: Es la fecha de finalización de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260515).

La siguiente consulta segmenta las métricas de Efectividad de conversiones por el segmento segments.device. Sustituye el segmento segments.age_range o segments.gender en solicitudes separadas para recuperar desgloses demográficos (opcionalmente combinados con segmentos de categoría de conversión o acción de conversión):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.device,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.
  • START_DATE: Es la fecha de inicio de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260501).
  • END_DATE: Es la fecha de finalización de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260515).

Para desglosar los resultados por ubicación geográfica, incluye los segmentos segments.country y segments.country_localized_name (que, de manera opcional, se pueden combinar con los segmentos de categoría de conversiones o de acción de conversión). El segmento segments.country devuelve un nombre de recurso de constante de segmentación geográfica global en el formato geoTargetConstants/CRITERION_ID (por ejemplo, geoTargetConstants/2840 para Estados Unidos).

La siguiente consulta segmenta las métricas de Efectividad de conversiones por el nombre del recurso del criterio de país y el nombre del país localizado:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.country,
  segments.country_localized_name,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.
  • START_DATE: Es la fecha de inicio de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260501).
  • END_DATE: Es la fecha de finalización de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260515).

Informes de pruebas A/B y de efectividad de conversiones

En la versión 25 y posteriores de la API de Google Ads, los estudios de efectividad de conversiones y pruebas A/B combinan un experimento de dos grupos (que compara las estrategias de control y de tratamiento) con la medición de aislamiento en la API de Google Ads para evaluar la incrementalidad de cada grupo y calcular las puntuaciones bayesianas de los ganadores. A diferencia de los informes de experimentos directos en el recurso experiment, que comparan las métricas de tráfico sin ajustar de un grupo experimental con las de otro, la consulta del recurso lift_measurement_config con el segmento segments.experiment_arm mide la efectividad incremental de cada grupo experimental en comparación con un modelo de referencia de aislamiento no expuesto.

Descubre experimentos y grupos experimentales

Un estudio de efectividad de conversiones y A/B vincula un recurso LiftMeasurementConfig a un recurso experiment de dos brazos a través del campo de solo lectura (OUTPUT_ONLY) experiment.lift_measurement_config.

Para descubrir el experimento vinculado y sus grupos en una sola solicitud, consulta el recurso ExperimentArm con los campos experiment atribuidos y filtra por el campo experiment.lift_measurement_config. La respuesta incluye el estado de control de cada grupo (experiment_arm.control), la división del tráfico (experiment_arm.traffic_split), las campañas vinculadas (experiment_arm.campaigns) y el nombre del recurso. Usa el valor experiment_arm.resource_name que se muestra (con el formato customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID) para filtrar el segmento segments.experiment_arm:

SELECT
  experiment.experiment_id,
  experiment.name,
  experiment.lift_measurement_config,
  experiment_arm.resource_name,
  experiment_arm.name,
  experiment_arm.control,
  experiment_arm.traffic_split,
  experiment_arm.campaigns
FROM experiment_arm
WHERE experiment.lift_measurement_config =
  'customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID'

Reemplaza lo siguiente:

  • CUSTOMER_ID: Es el ID de cliente de 10 dígitos de la cuenta propietaria del estudio (sin guiones).
  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.

Si comienzas con un EXPERIMENT_ID conocido (o quieres enumerar todos los experimentos con efectividad habilitada en la cuenta), ejecuta la misma consulta de experiment_arm filtrada por WHERE experiment.experiment_id = EXPERIMENT_ID (o WHERE experiment.lift_measurement_config IS NOT NULL).

Consulta la incrementalidad por brazo y las puntuaciones de los ganadores

Para medir la incrementalidad de cada grupo y evaluar la probabilidad estadística de que un grupo sea el ganador, incluye el segmento segments.experiment_arm en tu consulta al recurso lift_measurement_config.

Las siguientes métricas de puntuación bayesiana del ganador evalúan la probabilidad (de 0.0 a 1.0, que suma 1.0 en ambos grupos cuando ambos tienen una efectividad positiva que se puede informar) de que un grupo determinado sea superior:

  • metrics.incremental_conversions_winner_score: Es la probabilidad de que este grupo de anuncios sea el ganador en cuanto a las conversiones incrementales, normalizada por la división del tráfico del grupo de anuncios (experiment_arm.traffic_split).
  • metrics.incremental_conversion_value_winner_score: Es la probabilidad de que este grupo experimental sea el ganador en cuanto al valor de conversión incremental, normalizado por la división del tráfico del grupo experimental (experiment_arm.traffic_split). En la API de Google Ads v27 y versiones posteriores, solo se completa cuando la métrica principal del estudio es el valor de conversión y se omite (se deja sin establecer) en los estudios con la cantidad de conversiones como métrica principal.
  • metrics.cost_per_incremental_conversion_winner_score: Es la probabilidad de que este grupo de tratamiento sea el ganador en cuanto al costo por conversión incremental (CPA incremental más bajo), normalizado por la inversión.
  • metrics.incremental_conversion_value_per_cost_winner_score: Es la probabilidad de que este grupo de anuncios sea el ganador en cuanto al valor de conversión incremental por costo (ROAS incremental más alto), normalizado por la inversión. En la API de Google Ads v27 y versiones posteriores, solo se propaga cuando la métrica principal del estudio es el valor de conversión y se omite (no se establece) en los estudios de conversión-recuento-principal.

La siguiente consulta recupera la incrementalidad por brazo y las puntuaciones bayesianas de ganador para ambos brazos:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.cost_per_incremental_conversion,
  metrics.incremental_conversions_winner_score,
  metrics.cost_per_incremental_conversion_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score,
  metrics.incremental_conversion_value_per_cost_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.
  • START_DATE: Es la fecha de inicio de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260501).
  • END_DATE: Es la fecha de finalización de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260515).

Para filtrar por un solo grupo, agrega AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' a la cláusula WHERE, en la que EXPERIMENT_ID es el ID del experimento y ARM_ID es el ID del grupo que se muestra en el campo experiment_arm.resource_name. El segmento segments.experiment_arm admite el filtrado en cláusulas WHERE (=, !=, IN y NOT IN), pero no puedes ordenarlo en una cláusula ORDER BY.

Interpreta los resultados de las pruebas A/B y de efectividad de conversiones

Un estudio de efectividad de conversiones y de pruebas A/B evalúa dos hipótesis de forma simultánea: la superioridad de un grupo de anuncios en comparación con otro (metrics.*_winner_score) y la efectividad causal en comparación con el grupo de control no expuesto (metrics.incremental_* y *_p_value). Mientras un período de estudio de ENABLED aún está en curso (STUDY_IN_PROGRESS_*, cuando la fecha actual en la zona horaria del cliente es anterior o igual al lift_measurement_flight.end_date), la comparación de los grupos de anuncios y el modelado de conversiones del grupo de control aún se están estabilizando. Trata las métricas en curso como preliminares y evita promocionar un grupo experimental o reasignar presupuestos hasta que se complete el período de publicación.

En los estudios completados, un grupo experimental se clasifica como ganador de una comparación directa cuando cumple con los umbrales de precisión mínimos (al menos 4 días de instantáneas, 65 conversiones de referencia sin ajustar y 150 conversiones expuestas sin ajustar), tiene 0 <= p_value <= 0.50 y logra una puntuación bayesiana de ganador superior a 0.55 (> 0.55) en la métrica principal del estudio. Esta evaluación de hipótesis doble produce dos estados de ganador distintos (que también se reflejan en lift_guidance.outcome en la versión 27 y posteriores de la API de Google Ads):

  • Ganador claro con efectividad causal (AB_WINNER_WITH_LIFT): El grupo ganador supera al grupo de la competencia en una comparación directa (winner_score > 0.55) y genera conversiones incrementales o un valor de conversión con importancia estadística en comparación con el grupo de control no expuesto. Promociona o escala la estrategia del grupo de control ganador y consulta los desgloses dimensionales para revisar las cohortes de alto rendimiento.
  • Ganador de la comparación directa con paridad con el grupo de aislamiento (AB_WINNER_PARITY_VS_CONTROL): El grupo ganador supera al grupo de la competencia en la comparación directa (winner_score > 0.55), pero ninguno de los grupos produce una efectividad incremental con importancia estadística en comparación con el grupo de aislamiento no expuesto en el nivel consultado. Antes de aumentar la inversión en el grupo ganador, consulta los desgloses de las conversiones de ALL (segments.conversion_lift_included_conversion_action_types = 'ALL') y segments.conversion_lift_conversion_category para verificar si la efectividad causal positiva se aisló en otro lugar.

El resultado POSITIVE_LIFT_DETECTED se aplica a las siguientes granularidades de la consulta de pruebas A/B y efectividad de conversiones:

  • Filas de estudio de brazos combinados (OVERALL) (búsquedas sin segments.experiment_arm): El estudio generó una efectividad positiva en comparación con el grupo de control no expuesto (p_value <= 0.50), y ninguno de los brazos logró una puntuación de ganador de comparación directa superior a 0.55.
  • Filas por grupo (segments.experiment_arm): Cuando un grupo gana (winner_score > 0.55) y ambos grupos logran una efectividad positiva en comparación con el grupo de exclusión, la fila del grupo ganador devuelve AB_WINNER_WITH_LIFT, mientras que la fila del grupo no ganador devuelve POSITIVE_LIFT_DETECTED.
  • Filas de segmentación de categoría de conversión (segments.conversion_lift_conversion_category): Las filas de elevación positiva siempre devuelven POSITIVE_LIFT_DETECTED porque las puntuaciones de los ganadores no se evalúan por categoría de conversión.

Cuando un segmento devuelva NOT_ENOUGH_DATA o NO_SIGNIFICANT_LIFT, no detengas los grupos experimentales ni excluyas públicos en función de la insuficiencia de la muestra de un solo segmento. Verifica las métricas generales del estudio y las conversiones de ALL (segments.conversion_lift_included_conversion_action_types = 'ALL').

Consulta los resultados de los brazos combinados y de varios estudios

Cuando omites el segmento segments.experiment_arm de una consulta en el recurso lift_measurement_config, la API devuelve la incrementalidad a nivel del estudio agregada en ambos grupos combinados. En las consultas de brazos combinados, omite las cuatro métricas metrics.*_winner_score, que se aplican solo a los brazos que compiten y se omiten (se dejan sin establecer) en las filas de brazos combinados sin segments.experiment_arm. Usa las consultas a nivel del estudio en Consulta la efectividad de conversiones y el iCPA y Consulta la efectividad del valor de conversión y el iROAS.

Cuando segmentas los resultados de las pruebas A/B y de efectividad de conversiones por el segmento segments.experiment_arm, la API solo admite el segmento segments.conversion_lift_conversion_category como una dimensión de desglose adicional. Debido a que la inversión del grupo de tratamiento no se atribuye a categorías de conversiones individuales, evalúa las métricas de efectividad de las conversiones y del valor de conversión (omitiendo las métricas de iCPA y de iROAS, que no pasan la validación de la consulta con un error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE en la API de Google Ads v27 y versiones posteriores) cuando incluyas el segmento segments.conversion_lift_conversion_category. Los segmentos segments.conversion_action, segments.conversion_action_name, segments.age_range, segments.gender, segments.device, segments.country, segments.country_localized_name y segments.date no son compatibles con el segmento segments.experiment_arm ni con las métricas metrics.*_winner_score. Si seleccionas cualquiera de estos segmentos incompatibles junto con segments.experiment_arm, se muestra un error QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE (y un error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE si la consulta también selecciona cualquier métrica metrics.*_winner_score).

Para recuperar los resultados de varias configuraciones de estudio en una sola solicitud, filtra con el operador IN:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  segments.conversion_lift_conversion_category,
  metrics.incremental_conversions,
  metrics.incremental_conversions_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id IN (
    CONFIG_ID_1, CONFIG_ID_2)
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Reemplaza lo siguiente:

  • CONFIG_ID_1: Es el ID de número entero de la primera configuración de medición de efectividad.
  • CONFIG_ID_2: Es el ID de número entero de la segunda configuración de la medición de efectividad.
  • START_DATE: Es la fecha de inicio de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260501).
  • END_DATE: Es la fecha de finalización de la instantánea como un número entero YYYYMMDD de 8 dígitos sin comillas (por ejemplo, 20260515).

La igualdad de fecha exacta (= START_DATE y = END_DATE) devuelve filas solo para los estudios que comparten esa ventana de instantánea exacta. Cuando consultes estudios con diferentes fechas de inicio de los vuelos o fechas de la instantánea evaluada más reciente, filtra con operadores de rango (>= y <=) o quita los filtros de fecha de la cláusula WHERE mientras mantienes los segmentos segments.conversion_lift_start_date y segments.conversion_lift_end_date en la cláusula SELECT.

Informes de efectividad de búsqueda

Para medir el aumento en el volumen de búsquedas orgánicas que generan tus campañas publicitarias en la API de Google Ads v26 y versiones posteriores, consulta los recursos de informes de efectividad de búsqueda. La Efectividad de búsqueda cuantifica la diferencia en el comportamiento de búsqueda de tu marca o tus productos entre los usuarios expuestos a tus anuncios y un grupo de control no expuesto.

Recursos y segmentación de la Efectividad de búsqueda

Consulta el recurso SearchLiftKeywordBundle para recuperar detalles sobre los paquetes de palabras clave configurados para los estudios de efectividad de búsqueda. El recurso SearchLiftKeywordBundle es de solo lectura en la API de Google Ads (todos los campos son OUTPUT_ONLY), y los paquetes de palabras clave se configuran en la IU de Google Ads o por tu representante de Google o contacto de GPS. Sus campos consultables en GAQL son resource_name, search_lift_keyword_bundle_id, source (SearchLiftMatchingInfoSource) y status (SearchLiftKeywordBundleStatus) (el campo repetido keywords no se puede seleccionar en las consultas de GAQL).

Consulta el recurso LiftMeasurementConfig para recuperar las métricas de Efectividad de búsqueda y las configuraciones de estudio generales.

En la versión 27 y posteriores de la API de Google Ads, también puedes seleccionar el campo de solo lectura (OUTPUT_ONLY) lift_measurement_config.lift_guidance (lift_guidance.outcome y lift_guidance.guidance_message, de tipo LiftGuidance) en la cláusula SELECT de GAQL en lift_measurement_config cuando consultes las métricas o los segmentos de efectividad de búsqueda (segments.search_lift_keyword_bundle o segments.search_property). En lift_measurement_config, se omite lift_guidance en las consultas de configuración que solo contienen metadatos, y lift_guidance.guidance_message puede contener vínculos de Markdown intercalados (como [Learn more](https://support.google.com/...)). Para la efectividad de búsqueda, lift_guidance.outcome devuelve STUDY_IN_PROGRESS_WITH_LIFT, STUDY_IN_PROGRESS_NO_LIFT_YET, STUDY_IN_PROGRESS_COLLECTING_DATA, POSITIVE_LIFT_DETECTED (al menos un 70% de certeza, p_value <= 0.30), NO_SIGNIFICANT_LIFT o NOT_ENOUGH_DATA (evaluado en función de umbrales de, al menos, 1,000,000 de impresiones generales o 100,000 impresiones de porciones, al menos 75 búsquedas observadas y, al menos, 17 de 20 grupos de cookies, en los que un solo paquete de palabras clave con poca potencia hace que los resultados generales del estudio informen NOT_ENOUGH_DATA).

Segmenta el rendimiento de la Efectividad de búsqueda en las siguientes dimensiones:

  • segments.search_lift_keyword_bundle: Segmenta por el nombre del recurso del paquete de palabras clave. Es compatible con los segmentos segments.search_property, segments.date y demográficos (segments.device, segments.age_range y segments.gender). Cada paquete de palabras clave informa el costo y las impresiones totales de la campaña, y las palabras clave pueden pertenecer a más de un paquete. No sumes las métricas de metrics.search_lift_cost_micros, metrics.search_lift_impressions ni de Efectividad de búsqueda de los paquetes de palabras clave.
  • segments.search_property: Segmenta por la propiedad de búsqueda en la que se produjo la búsqueda, definida por la enumeración SearchLiftSearchProperty (como GOOGLE_SEARCH o YOUTUBE). El segmento segments.search_property solo es compatible con los segmentos segments.search_lift_keyword_bundle y segments.date. La combinación de segments.search_property con segmentos demográficos (segments.device, segments.age_range o segments.gender) genera un error en la validación de la consulta. Debido a que segments.search_property particiona los datos según el lugar donde se produjeron las búsquedas orgánicas posteriores, en lugar de donde se publicaron los anuncios, las filas segmentadas por segments.search_property repiten las impresiones y el costo no particionado a nivel de la campaña en la versión 26 de la API de Google Ads. A partir de la versión 27 de la API de Google Ads, las ocho métricas de inversión y de impresiones (metrics.search_lift_cost_micros, metrics.search_lift_impressions, metrics.normalized_incremental_searches_per_cost* y metrics.normalized_incremental_searches_per_impression*) no son compatibles con segments.search_property y fallan en la validación de la consulta con un error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.
  • Segmentos demográficos y de fecha: segments.device, segments.age_range, segments.gender y segments.date.

Métricas de efectividad de búsqueda

El recurso LiftMeasurementConfig proporciona métricas de efectividad de búsqueda para evaluar los cambios en el comportamiento de búsqueda:

  • metrics.relative_search_lift: Es la diferencia en el volumen de búsquedas entre los grupos expuesto y de control, expresada como una fracción de las búsquedas en el grupo de control.
  • metrics.relative_search_lift_p90_lower_bound y metrics.relative_search_lift_p90_upper_bound: Son los límites de confianza unilaterales del 90% (que, en conjunto, forman un intervalo de confianza bilateral del 80%) para la efectividad de búsqueda relativa.
  • metrics.incremental_searches_p_value: Es el valor p de las búsquedas incrementales, que representa la probabilidad estadística de que el aumento observado en las búsquedas haya ocurrido por casualidad.
  • metrics.search_lift_cost_micros: Es el costo total (en microcentavos) de las impresiones de anuncios publicadas para este segmento de medición de la efectividad de búsqueda. Incompatible con segments.search_property en la versión 27 y posteriores de la API de Google Ads.
  • metrics.search_lift_impressions: Es la cantidad total de impresiones de anuncios publicadas para esta porción de medición de la efectividad de búsqueda. No es compatible con segments.search_property en la versión 27 y posteriores de la API de Google Ads.

Las siguientes métricas incrementales normalizadas, junto con sus límites de confianza unilaterales del 90% correspondientes (*_p90_lower_bound y *_p90_upper_bound), se informan cuando la efectividad es estadísticamente positiva:

Ejemplos de búsquedas de efectividad de búsqueda

Las siguientes consultas de GAQL muestran cómo recuperar paquetes de palabras clave y métricas de rendimiento de la efectividad de búsqueda.

Consulta de paquete de palabras clave

Para recuperar los paquetes de palabras clave configurados para las mediciones de la Efectividad de búsqueda, consulta el recurso search_lift_keyword_bundle:

SELECT
  search_lift_keyword_bundle.resource_name,
  search_lift_keyword_bundle.search_lift_keyword_bundle_id,
  search_lift_keyword_bundle.source,
  search_lift_keyword_bundle.status
FROM search_lift_keyword_bundle

Consulta de métricas

Los valores de search_lift_keyword_bundle.resource_name recuperados en la consulta del paquete de palabras clave corresponden a los valores que se devuelven en el segmento segments.search_lift_keyword_bundle de la siguiente consulta. Para descubrir el CONFIG_ID, las campañas vinculadas y el programa de vuelos de tu estudio, sigue Descubre las configuraciones de estudio y los vuelos en los recursos lift_measurement_config y lift_measurement_flight (filtrando los vuelos por lift_measurement_flight.lift_type = 'SEARCH').

La siguiente consulta recupera las métricas de efectividad de búsqueda segmentadas por paquete de palabras clave y propiedad de búsqueda (omite segments.search_property cuando selecciones metrics.search_lift_cost_micros o metrics.search_lift_impressions):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.search_lift_keyword_bundle,
  segments.search_property,
  metrics.relative_search_lift,
  metrics.relative_search_lift_p90_lower_bound,
  metrics.relative_search_lift_p90_upper_bound,
  metrics.incremental_searches_p_value,
  metrics.normalized_incremental_searches,
  metrics.normalized_incremental_searches_p90_lower_bound,
  metrics.normalized_incremental_searches_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Reemplaza lo siguiente:

  • CONFIG_ID: Es el ID de número entero de la configuración de la medición de efectividad.
Anterior
Informes
Siguiente
Extrae datos de ubicación geográfica