Relatórios de Lift

Para medir o impacto causal das suas campanhas publicitárias na percepção da marca, nas conversões, no valor da conversão e no comportamento de pesquisa orgânica, consulte os recursos de relatórios de medição de Lift na API Google Ads:

  • Relatórios de Brand Lift: avaliam como a exposição ao anúncio influencia a percepção da marca nos tipos de medição pesquisados na API Google Ads v25 e em versões mais recentes.
  • Relatórios de Conversion Lift: medem as conversões incrementais, o valor da conversão, o custo por conversão incremental (iCPA) e o retorno incremental do investimento em publicidade (iROAS) em comparação com um grupo de controle não exposto na API Google Ads v25 e versões mais recentes, incluindo:
  • Relatórios de Search Lift: quantificam o aumento incremental no volume de consultas de pesquisa orgânica na Pesquisa Google e no YouTube impulsionado pela exposição ao anúncio na API Google Ads v26 e versões mais recentes.

Para relatórios de testes A/B padrão nos recursos experiment e campaign, consulte Gerar relatórios sobre testes.

Relatórios de Brand Lift

Para avaliar como suas campanhas publicitárias influenciam a percepção da marca na API Google Ads v25 e em versões mais recentes, consulte os recursos dedicados de medição de Brand Lift.

Recursos de Brand Lift e visualizações de detalhamento

As configurações, os períodos de veiculação e as visualizações de detalhamento do Brand Lift são somente leitura na API Google Ads (todos os campos são OUTPUT_ONLY) e são configurados na interface do Google Ads ou com seu representante do Google ou contato do GPS. Consulte esses recursos usando o parâmetro customer_id da conta (de administrador ou secundária) que é proprietária do estudo.

Consulte o recurso LiftMeasurementFlight para recuperar os metadados de programação do Brand Lift e de coleta de pesquisas no nível do período de veiculação, incluindo o status do período de veiculação (lift_measurement_flight.status, definido pelo tipo enumerado LiftMeasurementFlightStatus com os valores ENABLED para períodos de veiculação ativos e STOPPED para períodos de veiculação interrompidos manualmente), os períodos de veiculação (lift_measurement_flight.start_date e lift_measurement_flight.end_date) no fuso horário do cliente e o progresso da coleta de respostas da pesquisa de segmentação (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, em que 0 é igual a 0% e 1000000 é igual a 100%). Para determinar se um período de veiculação de ENABLED está em andamento ou foi concluído, compare a data atual no fuso horário do cliente com lift_measurement_flight.start_date e lift_measurement_flight.end_date e verifique se response_collection_ratio_micros atingiu 1000000.

Consulte o recurso LiftMeasurementConfig para recuperar as métricas gerais de Brand Lift no nível do estudo ou consulte os seguintes recursos de detalhamento para analisar as métricas de Brand Lift em dimensões específicas:

Inclua o segmento segments.brand_lift_measurement_type para detalhar as métricas de Brand Lift por tipo de pergunta, definido pelo tipo enumerado BrandLiftMeasurementType (como RECALL ou AWARENESS). Quando você omite o segmento segments.brand_lift_measurement_type, a API retorna métricas para um único tipo de medição selecionado automaticamente por fração. Inclua o segmento segments.date para detalhar as métricas de Brand Lift por data (YYYY-MM-DD). A métrica metrics.cost_per_lifted_cookie é retornada em micros da moeda da conta proprietária do estudo.

Na API Google Ads v27 e versões mais recentes, também é possível selecionar o campo lift_guidance somente leitura (OUTPUT_ONLY) (lift_guidance.outcome e lift_guidance.guidance_message, do tipo LiftGuidance) na cláusula SELECT da Linguagem de consulta do Google Ads (GAQL) em lift_measurement_config e nos cinco recursos de detalhamento do Brand Lift (lift_measurement_age_range, lift_measurement_campaign, lift_measurement_device, lift_measurement_gender e lift_measurement_video) para receber interpretação estatística no nível da linha. Em lift_measurement_config, lift_guidance é preenchido apenas quando a consulta também seleciona ou filtra métricas ou segmentos de Lift (é omitido em consultas de configuração somente de metadados), e lift_guidance.guidance_message pode conter links Markdown inline (como [Learn more](https://support.google.com/...)). Não é possível filtrar ou classificar subcampos lift_guidance em cláusulas WHERE ou ORDER BY. Para descrições dos valores de LiftOutcomeEnum.LiftOutcome retornados em lift_guidance.outcome, consulte Interpretar resultados de Brand Lift.

Limites de relatórios e respostas vazias

Os relatórios de Brand Lift são limitados por latência (exigem um atraso de pipeline de 24 a 48 horas após o início de um estudo) e limitados por resposta por tipo de medição pesquisado (segments.brand_lift_measurement_type) para atender aos limites de relatórios estatísticos e privacidade:

  • Taxas de resposta positiva (metrics.brand_lift_baseline_positive_response_rate* e metrics.brand_lift_exposed_positive_response_rate*): pelo menos 50 respostas à pesquisa no grupo correspondente (exposto ou suprimido).
  • Limite de aumento positivo estrito (estudo geral em LiftMeasurementConfig ou fração independente): aumento estatisticamente positivo (p_value <= 0.50) com pelo menos 2.000 respostas no total e 860 respostas por grupo.
  • Limite de Lift positivo de fração flexível (em um recurso de detalhamento quando o estudo geral atende ao limite estrito com Lift positivo): Lift estatisticamente positivo (p_value <= 0.50) com pelo menos 500 respostas no total e 200 respostas por grupo.
  • Limite de Lift não positivo completo (NO_SIGNIFICANT_LIFT versus NOT_ENOUGH_DATA): pelo menos 4.100 respostas no total por métrica quando nenhum Lift estatisticamente positivo é detectado.

As consultas a LiftMeasurementConfig e aos cinco recursos de detalhamento do Brand Lift (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign e LiftMeasurementVideo) retornam uma resposta vazia (results: []) em vez de um erro nos seguintes casos:

  • O parâmetro customer_id consultado não está na lista de permissões ou não é o proprietário do estudo.
  • Os filtros de data de WHERE estão fora dos períodos de veiculação avaliados (lift_measurement_flight.start_date e lift_measurement_flight.end_date).
  • O estudo ou o segmento demográfico, de dispositivo, de campanha ou de vídeo específico não atendeu ao atraso de 24 a 48 horas no relatório e aos limites de volume de respostas da pesquisa, mesmo quando LiftMeasurementConfig retorna os resultados gerais do estudo.

Para resolver problemas de respostas vazias, siga estas etapas:

  1. Consulte lift_measurement_flight para verificar se lift_measurement_flight.status = 'ENABLED', confira se os filtros de data WHERE estão entre lift_measurement_flight.start_date e lift_measurement_flight.end_date e inspecione o progresso da pesquisa em lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros (em que 1000000 é igual a 100%).
  2. Consulte LiftMeasurementConfig para confirmar se o estudo geral gerou métricas de Brand Lift que podem ser incluídas em relatórios antes de consultar recursos de detalhamento dimensional.

Interpretar os resultados de Brand Lift

Na API Google Ads v27 e versões mais recentes, o campo lift_guidance.outcome retorna um valor LiftOutcomeEnum.LiftOutcome que classifica o estado estatístico de cada linha retornada, além de conselhos de correção legíveis por humanos em lift_guidance.guidance_message:

  • Resultados do estudo em andamento (quando lift_measurement_flight.status é ENABLED e a data atual no fuso horário do cliente é igual ou anterior a lift_measurement_flight.end_date com lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros menor que 1000000):
    • STUDY_IN_PROGRESS_WITH_LIFT: o estudo está em andamento, e um aumento positivo preliminar está surgindo.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: o estudo está em andamento com volume inicial suficiente, e nenhum aumento estatisticamente significativo foi detectado ainda.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: o estudo está em andamento e coletando ativamente as respostas iniciais da pesquisa para atingir os limites de relatórios estatísticos.
  • Resultados do estudo concluído (quando lift_measurement_flight.end_date tiver passado ou lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros tiver atingido 1000000):
    • POSITIVE_LIFT_DETECTED: um aumento positivo estatisticamente significativo foi detectado para o estudo ou segmento concluído.
    • NO_SIGNIFICANT_LIFT: o estudo ou segmento concluído atingiu os limites de precisão estatística (pelo menos 4.100 respostas no total por métrica), e nenhum aumento positivo estatisticamente significativo foi detectado.
    • NOT_ENOUGH_DATA: o estudo ou segmento concluído não atingiu os limites de resposta da pesquisa necessários para a confiabilidade estatística (pelo menos 2.000 respostas no total e 860 por grupo para Lift positivo no estudo geral, 500 respostas no total e 200 por grupo para Lift positivo em um segmento quando o estudo geral tem Lift positivo ou 4.100 respostas no total por métrica quando nenhum Lift positivo é detectado).

Siga as diretrizes abaixo ao interpretar os resultados de Brand Lift:

  • Períodos de veiculação em andamento x concluídos (STUDY_IN_PROGRESS_*): enquanto um período de veiculação do estudo de ENABLED ainda está em andamento (antes de lift_measurement_flight.end_date passar e antes de response_collection_ratio_micros atingir 1000000), as respostas da pesquisa e a modelagem com correção de viés ainda estão se estabilizando. Trate as métricas em andamento como preliminares e evite pausar campanhas ou reduzir orçamentos até que o período de veiculação seja concluído.
  • Aumento positivo (POSITIVE_LIFT_DETECTED): quando um Brand Lift positivo é detectado, consulte os recursos de detalhamento dimensional (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign e LiftMeasurementVideo) para identificar grupos de público-alvo de alta performance ("pontos positivos") e avaliar a ressonância do criativo no funil da marca.
  • Dados insuficientes ou nenhum aumento significativo (NOT_ENOUGH_DATA ou NO_SIGNIFICANT_LIFT): quando o volume de respostas à pesquisa é insuficiente (menos de 4.100 respostas no total por métrica sem aumento positivo ou menos do que os limites de fração de 2.000/860 estritos ou 500/200 flexíveis para aumento positivo) ou nenhum aumento estatisticamente significativo é detectado em uma fração, não trate isso como falha da campanha nem exclua públicos-alvo com base na insuficiência de amostra de uma única fração. Verifique as métricas gerais do estudo em LiftMeasurementConfig, consulte outros valores de segments.brand_lift_measurement_type pesquisados (como RECALL ou AWARENESS do funil superior) e verifique as dimensões de detalhamento restantes.

Exemplos de consultas de Brand Lift

Como os metadados do período de veiculação e as estatísticas de Lift residem em recursos separados, é necessário usar consultas GAQL separadas para consultar os detalhes do período de veiculação e as estatísticas de performance.

Consulta de detalhes do voo

Para recuperar metadados de um período de Brand Lift, como status, tipo de medição, datas programadas e progresso da coleta de pesquisas, consulte o 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'

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift (lift_measurement_config.lift_measurement_config_id).

Consulta de estatísticas

Para recuperar as métricas de Brand Lift, consulte o recurso LiftMeasurementConfig ou o recurso de detalhamento adequado. Por exemplo, a consulta a seguir recupera métricas de Brand Lift segmentadas por campanha e tipo de medição de Brand Lift do 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

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.

Relatórios de Conversion Lift

Na API Google Ads v25 e versões mais recentes, os relatórios de Conversion Lift medem o impacto incremental dos seus anúncios nas conversões e no valor da conversão. Os estudos de Conversion Lift comparam o comportamento de conversão entre um grupo exposto (usuários que estavam qualificados para ver seus anúncios) e um grupo de controle não exposto (usuários que não puderam ver seus anúncios).

As configurações, os períodos de veiculação e os links de experimentos do Conversion Lift são somente leitura na API Google Ads (todos os campos são OUTPUT_ONLY) e são configurados na interface do Google Ads ou com seu representante do Google ou contato do GPS. Consulte o recurso lift_measurement_config usando o parâmetro customer_id da conta proprietária do estudo. Uma conta de administrador pode consultar diretamente os estudos de Conversion Lift entre contas que ela possui. Consulte os estudos de uma conta infantil usando o parâmetro customer_id dela (opcionalmente autenticado com o cabeçalho login-customer-id).

Os relatórios de Conversion Lift são compatíveis com dois fluxos de trabalho de estudo, que compartilham a mesma descoberta de estudo e período de veiculação, períodos de snapshot cumulativos e escopos de ação de conversão:

  • Relatórios independentes de Conversion Lift: medem a incrementalidade geral, o custo por conversão incremental (iCPA) e o retorno incremental do investimento em publicidade (iROAS) em todas as ações de conversão selecionadas ou em todas as ações de conversão das campanhas medidas no estudo.
  • Relatórios de teste A/B + Conversion Lift: medem a incrementalidade por grupo e as pontuações bayesianas de vencedor entre dois grupos de experimento concorrentes (controle versus tratamento), além da incrementalidade geral do estudo.

Para criar consultas válidas para o recurso lift_measurement_config, use a ferramenta Criador de consultas do Google Ads.

Na API Google Ads v27 e versões mais recentes, é possível selecionar o campo lift_measurement_config.lift_guidance (lift_guidance.outcome e lift_guidance.guidance_message, do tipo LiftGuidance) somente leitura (OUTPUT_ONLY) na cláusula SELECT da GAQL em lift_measurement_config para receber interpretação estatística no nível da linha para consultas independentes de Conversion Lift e de teste A/B + Conversion Lift. Em lift_measurement_config, lift_guidance é preenchido apenas quando a consulta também seleciona ou filtra métricas ou segmentos de Lift (é omitido em consultas de configuração somente de metadados), e lift_guidance.guidance_message pode conter links inline do Markdown (como [Learn more](https://support.google.com/...)). Não é possível filtrar ou classificar em subcampos lift_guidance em cláusulas WHERE ou ORDER BY. O campo lift_guidance.outcome retorna um dos seguintes valores de LiftOutcomeEnum.LiftOutcome:

  • Resultados do estudo em andamento (quando lift_measurement_flight.status é ENABLED e a data atual no fuso horário do cliente é igual ou anterior a lift_measurement_flight.end_date):
    • STUDY_IN_PROGRESS_WITH_LIFT: o estudo está em andamento, e um aumento positivo preliminar está surgindo.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: o estudo está em andamento com volume inicial suficiente, e nenhum aumento estatisticamente significativo foi detectado ainda.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: o estudo está em andamento e coletando ativamente dados de conversão iniciais para os limites de relatórios estatísticos.
  • Resultados do estudo concluído (quando lift_measurement_flight.end_date tiver passado):
    • POSITIVE_LIFT_DETECTED: um Lift positivo estatisticamente significativo foi detectado para o estudo, grupo experimental ou fração concluída.
    • AB_WINNER_WITH_LIFT: um estudo de teste A/B + Conversion Lift concluído com um grupo experimental vencedor em uma comparação direta e um aumento positivo estatisticamente significativo em relação ao grupo de controle não exposto.
    • AB_WINNER_PARITY_VS_CONTROL: um estudo de Conversion Lift + A/B concluído com um grupo experimental vencedor, mas em paridade com o grupo de controle não exposto.
    • NO_SIGNIFICANT_LIFT: o estudo, o grupo experimental ou o segmento concluído atingiu os limites de precisão estatística, e nenhum aumento positivo estatisticamente significativo foi detectado.
    • NOT_ENOUGH_DATA: o estudo, o grupo experimental ou o segmento concluído não acumulou conversões suficientes para atingir os limites de precisão estatística.

Descobrir configurações do estudo e voos

Para gerar um relatório sobre um estudo de Conversion Lift, primeiro descubra a configuração do estudo e o cronograma de veiculação:

  1. Recuperar a configuração do estudo: consulte o recurso LiftMeasurementConfig para recuperar o nome do estudo, a proporção de retenção (lift_measurement_config.conversion_lift_holdback_ratio_micros), as ações de conversão rastreadas (lift_measurement_config.conversion_actions) e, na API Google Ads v26 e versões mais recentes, as campanhas vinculadas ativamente (lift_measurement_config.campaigns). O campo conversion_lift_holdback_ratio_micros é expresso em micros, em que 1,000,000 é igual a 100% (por exemplo, 300000 representa um grupo de retenção não exposto de 30%). Se você não souber o CONFIG_ID do estudo, omita a cláusula WHERE para listar todas as configurações de estudo na conta.
  2. Recuperar janelas de observação de voo: consulte o recurso LiftMeasurementFlight para encontrar as datas de voo programadas (lift_measurement_flight.start_date e lift_measurement_flight.end_date) no fuso horário do cliente. Como um único recurso LiftMeasurementConfig pode agrupar períodos de veiculação de Brand Lift (SURVEY), Conversion Lift (CONVERSION) e Search Lift (SEARCH), inclua o campo lift_measurement_flight.lift_type na cláusula SELECT e filtre por lift_measurement_flight.lift_type = 'CONVERSION' na cláusula WHERE. Os campos lift_measurement_flight.start_date e lift_measurement_flight.end_date podem ser classificados em cláusulas ORDER BY, mas não é possível filtrá-los em uma cláusula WHERE.

A consulta a seguir recupera a configuração do estudo (omita o campo lift_measurement_config.campaigns na v25 da API Google Ads, já que esse campo requer a v26 ou uma versão mais recente):

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

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift (lift_measurement_config.lift_measurement_config_id).

A consulta a seguir recupera a programação de veiculação do Conversion Lift para o estudo:

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'

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift (lift_measurement_config.lift_measurement_config_id).

Na v26 e em versões mais recentes da API Google Ads, também é possível descobrir a configuração de medição de Lift vinculada a uma campanha diretamente do recurso campaign consultando o campo campaign.lift_measurement_config. Consultar esse campo evita a necessidade de comparar o recurso LiftMeasurementConfig separadamente:

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

Substitua:

  • CAMPAIGN_ID: o ID inteiro da campanha (campaign.id).

O campo campaign.lift_measurement_config retorna um nome de recurso no formato customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID. Se uma campanha participou de vários estudos de Lift, esse campo identifica a configuração vinculada mais recentemente (ativa ou inativa). Por outro lado, o campo lift_measurement_config.campaigns lista apenas as campanhas vinculadas ativamente.

Consultar períodos de snapshots cumulativos

Os resultados do Conversion Lift são estruturados como snapshots de avaliação cumulativa diária a partir da data de início do período de veiculação:

segments.conversion_lift_start_date e segments.conversion_lift_end_date são campos INT64 formatados como números inteiros de 8 dígitos sem aspas e sem hifens no formato YYYYMMDD (por exemplo, 20260501). Por outro lado, os campos lift_measurement_flight.start_date e lift_measurement_flight.end_date retornam strings de data no formato ISO 8601 YYYY-MM-DD (por exemplo, 2026-05-01). Ao contrário das consultas de Brand Lift e Search Lift, o segmento segments.date é incompatível com todas as métricas e segmentos de Conversion Lift. Selecionar o segmento segments.date com segmentos de Conversion Lift (como segments.conversion_lift_start_date) na cláusula SELECT retorna um erro QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE, enquanto combinar segments.date com métricas de Conversion Lift retorna um erro QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.

O snapshot calculado mais recente pode ficar atrás da data de término de um voo ativo durante o processamento de dados. Sempre consulte o recurso lift_measurement_config para encontrar pares (segments.conversion_lift_start_date, segments.conversion_lift_end_date) disponíveis ordenados por segments.conversion_lift_end_date DESC primeiro para identificar o snapshot avaliado mais recente.

A consulta a seguir recupera os períodos de resumo disponíveis para um estudo:

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

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.

Filtrar por escopo da ação de conversão

O Conversion Lift avalia a incrementalidade em dois escopos definidos pelo segmento segments.conversion_lift_included_conversion_action_types:

  • SELECTED: ações de conversão selecionadas durante a configuração do estudo ou todas as ações de conversão que podem receber lances (principais) se as ações de conversão personalizadas não foram especificadas.
  • ALL: todas as ações de conversão das campanhas medidas no estudo.

Quando você consulta o recurso lift_measurement_config para métricas de Conversion Lift sem filtrar o segmento segments.conversion_lift_included_conversion_action_types, a API retorna duas linhas por fração: uma para ALL e outra para SELECTED. Na GAQL, qualquer campo de segmento que não seja de data (e qualquer segmento de data de snapshot do Conversion Lift) filtrado na cláusula WHERE também precisa aparecer na cláusula SELECT. Caso contrário, a API retornará um erro QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE. Ao filtrar por segments.conversion_lift_included_conversion_action_types = 'SELECTED' na cláusula WHERE, inclua esse segmento na cláusula SELECT.

Relatórios independentes do Conversion Lift

Os estudos independentes de Conversion Lift medem o impacto incremental dos seus anúncios em comparação com um grupo de retenção não exposto, sem dividir as campanhas em grupos de tratamento concorrentes.

Consultar o Conversion Lift e o iCPA

O Conversion Lift informa estimativas pontuais com limites de confiança unilaterais de 90% (*_p90_lower_bound e *_p90_upper_bound, que juntos formam um intervalo de confiança bilateral de 80%) e valores p (p_value <= 0.10 corresponde a 90% de significância estatística unilateral):

A API omite as métricas de Conversion Lift nas linhas retornadas nos seguintes casos:

  • A janela de snapshot inclusiva é de menos de 4 dias.
  • O volume de conversões registradas sem escalonamento é menor que os limites mínimos de precisão (menos de 65 conversões de referência registradas no grupo de retenção ou menos de 150 conversões registradas do grupo exposto, avaliadas antes do escalonamento de metrics.conversion_lift_baseline_conversions).
  • O aumento medido não é positivo (metrics.incremental_conversions_p_value > 0.5 para métricas de conversão ou metrics.incremental_conversion_value_p_value > 0.5 para métricas de valor de conversão).
  • Na API Google Ads v27 e em versões mais recentes, as métricas de iROAS (metrics.incremental_conversion_value_per_cost*) e as métricas de pontuação vencedora do valor da conversão (metrics.incremental_conversion_value_winner_score e metrics.incremental_conversion_value_per_cost_winner_score) são consultadas em um estudo que foi configurado durante a configuração com a contagem de conversões em vez do valor da conversão como métrica principal. As métricas de valor de conversão sem custo financeiro (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* e metrics.relative_conversion_value_lift*) continuam preenchidas nos estudos de contagem de conversões principal sempre que o aumento do valor de conversão pode ser informado.
  • Várias linhas ou estudos são agregados porque você omitiu os campos lift_measurement_config.lift_measurement_config_id, segments.conversion_lift_start_date, segments.conversion_lift_end_date ou segments.conversion_lift_included_conversion_action_types da cláusula SELECT.

Siga as diretrizes abaixo ao interpretar os resultados do Conversion Lift independente:

  • Períodos de veiculação em andamento x concluídos (STUDY_IN_PROGRESS_*): enquanto um período de veiculação do estudo de ENABLED ainda está em andamento (quando a data atual no fuso horário do cliente é igual ou anterior a lift_measurement_flight.end_date), a modelagem de conversão de referência e de tratamento e a atribuição de conversão atrasada ainda estão se estabilizando. Trate as métricas em andamento como preliminares e evite pausar campanhas ou reduzir orçamentos até que o período de veiculação seja concluído.
  • Aumento positivo (POSITIVE_LIFT_DETECTED): capacidade de geração de relatórios da métrica de Conversion Lift e acionador lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED' sempre que o aumento medido for positivo (p_value <= 0.50, correspondente a pelo menos 50% de certeza com uma estimativa de ponto positiva, enquanto p_value <= 0.10 indica 90% de significância estatística unilateral em que *_p90_lower_bound >= 0) e os limites mínimos de precisão (pelo menos 4 dias de snapshot, pelo menos 65 conversões de referência não dimensionadas e pelo menos 150 conversões expostas não dimensionadas) forem atendidos. Quando um lift positivo é detectado, consulte os detalhamentos dimensionais (informações demográficas, dispositivo, país ou categoria de conversão e ação de conversão) para identificar coortes de alto desempenho ("pontos positivos").
  • Dados insuficientes ou nenhum Lift significativo (NOT_ENOUGH_DATA ou NO_SIGNIFICANT_LIFT): quando o volume de dados é insuficiente (menos de 65 conversões de referência não dimensionadas ou menos de 150 conversões expostas não dimensionadas) ou nenhum Lift estatisticamente significativo é detectado em um segmento, não trate isso como falha da campanha nem exclua públicos-alvo com base na insuficiência de amostra de um único segmento. Verifique as métricas gerais do estudo e consulte segments.conversion_lift_included_conversion_action_types = 'ALL' (se SELECTED não mostrar Lift) ou as outras detalhamentos dimensionais para verificar se o Lift positivo foi isolado em outro lugar.

A consulta a seguir recupera a incrementalidade geral de conversão, os limites de confiança e o 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'

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.
  • START_DATE: a data de início do snapshot como um número inteiro YYYYMMDD de 8 dígitos sem aspas (por exemplo, 20260501).
  • END_DATE: a data de término do snapshot como um número inteiro YYYYMMDD de oito dígitos sem aspas (por exemplo, 20260515).

Consultar o aumento no valor da conversão e o iROAS

Para avaliar a receita incremental gerada pelos seus gastos com publicidade, consulte as métricas de valor de conversão e a métrica metrics.incremental_conversion_value_per_cost. As métricas de valor da conversão sem custo financeiro (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* e metrics.relative_conversion_value_lift*) são preenchidas sempre que o estudo tem um aumento no valor da conversão que pode ser informado, independentemente de a métrica principal do estudo ser a contagem ou o valor da conversão. Na API Google Ads v27 e versões mais recentes, as métricas de iROAS (metrics.incremental_conversion_value_per_cost*), junto com metrics.incremental_conversion_value_winner_score e metrics.incremental_conversion_value_per_cost_winner_score, são retornadas apenas quando o estudo foi configurado durante a configuração com o valor da conversão como métrica principal (e são omitidas em estudos com contagem de conversões como métrica principal):

A consulta a seguir recupera a incrementalidade do valor da conversão, os limites de confiança e o 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'

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.
  • START_DATE: a data de início do snapshot como um número inteiro YYYYMMDD de 8 dígitos sem aspas (por exemplo, 20260501).
  • END_DATE: a data de término do snapshot como um número inteiro YYYYMMDD de oito dígitos sem aspas (por exemplo, 20260515).

Segmentar resultados por dimensão

Segmentar as métricas de conversão incremental por categoria de conversão, ação de conversão, informações demográficas, dispositivo ou geografia. Ao consultar o recurso lift_measurement_config, selecione apenas combinações de segmentos compatíveis:

A seleção de segmentos mutuamente incompatíveis na cláusula SELECT falha na validação da consulta e retorna um erro QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Use o Criador de consultas do Google Ads para validar as combinações de segmentos de forma interativa.

Avalie as métricas de custo-benefício (metrics.cost_per_incremental_conversion* e metrics.incremental_conversion_value_per_cost*) apenas nas linhas gerais do estudo ou nas linhas de segments.experiment_arm. Nas versões 25 e 26 da API Google Ads, o esquema permite selecionar as seis métricas de proporção de custo (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 e metrics.incremental_conversion_value_per_cost_p90_upper_bound) com os oito segmentos de fração não relacionados ao grupo (segments.conversion_action, segments.conversion_action_name, segments.conversion_lift_conversion_category, segments.age_range, segments.gender, segments.device, segments.country e segments.country_localized_name). A partir da versão 27 da API Google Ads, a seleção de qualquer uma dessas seis métricas de proporção de custo com qualquer um desses oito segmentos de fração não relacionados ao grupo falha na validação da consulta e retorna um erro QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE. As métricas de valor da conversão sem custo financeiro (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* e metrics.relative_conversion_value_lift*) continuam disponíveis nos segmentos de categoria de conversão, ação de conversão, informações demográficas, dispositivo e país sempre que o Lift no valor da conversão puder ser informado (independentemente de a métrica principal do estudo ser a contagem ou o valor da conversão).

Para avaliar o Lift em todas as categorias de conversão definidas no tipo enumerado ConversionActionCategory (como PURCHASE, SIGNUP ou SUBMIT_LEAD_FORM), segmente os resultados pelo 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'

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.
  • START_DATE: a data de início do snapshot como um número inteiro YYYYMMDD de 8 dígitos sem aspas (por exemplo, 20260501).
  • END_DATE: a data de término do snapshot como um número inteiro YYYYMMDD de oito dígitos sem aspas (por exemplo, 20260515).

O segmento segments.conversion_action retorna o nome do recurso da ação de conversão no formato customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID. Selecione o segmento segments.conversion_action_name no recurso lift_measurement_config para recuperar nomes de ações de conversão legíveis por humanos sem consultar o recurso conversion_action separadamente. A consulta a seguir segmenta as métricas de Conversion Lift por ação de conversão, nome da ação de conversão e categoria de conversão:

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'

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.
  • START_DATE: a data de início do snapshot como um número inteiro YYYYMMDD de 8 dígitos sem aspas (por exemplo, 20260501).
  • END_DATE: a data de término do snapshot como um número inteiro YYYYMMDD de oito dígitos sem aspas (por exemplo, 20260515).

A consulta a seguir segmenta as métricas de Conversion Lift pelo segmento segments.device. Substitua o segmento segments.age_range ou segments.gender em solicitações separadas para recuperar detalhamentos demográficos (opcionalmente combinados com segmentos de categoria de conversão ou ação de conversão):

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'

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.
  • START_DATE: a data de início do snapshot como um número inteiro YYYYMMDD de 8 dígitos sem aspas (por exemplo, 20260501).
  • END_DATE: a data de término do snapshot como um número inteiro YYYYMMDD de oito dígitos sem aspas (por exemplo, 20260515).

Para detalhar os resultados por região, inclua os segmentos segments.country e segments.country_localized_name (opcionalmente combinados com segmentos de categoria de conversão ou ação de conversão). O segmento segments.country retorna um nome de recurso constante de segmentação por área geográfica global no formato geoTargetConstants/CRITERION_ID (por exemplo, geoTargetConstants/2840 para os Estados Unidos).

A consulta a seguir segmenta as métricas de Conversion Lift por nome de recurso do critério de país e nome de 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'

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.
  • START_DATE: a data de início do snapshot como um número inteiro YYYYMMDD de 8 dígitos sem aspas (por exemplo, 20260501).
  • END_DATE: a data de término do snapshot como um número inteiro YYYYMMDD de oito dígitos sem aspas (por exemplo, 20260515).

Relatórios de teste A/B + Conversion Lift

Na API Google Ads v25 e versões mais recentes, os estudos de Conversion Lift + teste A/B combinam um experimento de dois grupos (comparando estratégias de controle e tratamento) com a medição de retenção na API Google Ads para avaliar a incrementalidade de cada grupo e calcular as pontuações bayesianas do vencedor. Ao contrário dos relatórios de experimentos diretos no recurso experiment, que comparam métricas de tráfego não ajustadas entre grupos, consultar o recurso lift_measurement_config com o segmento segments.experiment_arm mede o aumento incremental de cada grupo em relação a um valor de referência de retenção não exposto.

Experimentos e grupos do Discovery

Um estudo de Conversion Lift + teste A/B vincula um recurso LiftMeasurementConfig a um recurso experiment de dois grupos usando o campo somente leitura (OUTPUT_ONLY) experiment.lift_measurement_config.

Para descobrir o experimento vinculado e os grupos dele em uma única solicitação, consulte o recurso ExperimentArm com campos experiment atribuídos e filtre no campo experiment.lift_measurement_config. A resposta inclui o status de controle de cada grupo (experiment_arm.control), a divisão de tráfego (experiment_arm.traffic_split), as campanhas vinculadas (experiment_arm.campaigns) e o nome do recurso. Use o valor experiment_arm.resource_name retornado (formatado como customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID) para filtrar o 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'

Substitua:

  • CUSTOMER_ID: o ID de cliente de 10 dígitos da conta proprietária do estudo (sem hifens).
  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.

Se você começar com um EXPERIMENT_ID conhecido (ou quiser listar todos os experimentos com Lift ativado na conta), execute a mesma consulta experiment_arm filtrada por WHERE experiment.experiment_id = EXPERIMENT_ID (ou WHERE experiment.lift_measurement_config IS NOT NULL).

Consultar a incrementalidade por grupo e as pontuações do vencedor

Para medir a incrementalidade de cada grupo e avaliar a probabilidade estatística de um grupo ser o vencedor, inclua o segmento segments.experiment_arm na sua consulta ao recurso lift_measurement_config.

As seguintes métricas de pontuação bayesiana do vencedor avaliam a probabilidade (de 0.0 a 1.0, somando 1.0 nos dois grupos quando ambos têm aumento positivo reportável) de um determinado grupo ser superior:

  • metrics.incremental_conversions_winner_score: a probabilidade de que esse grupo seja o vencedor para conversões incrementais, normalizada pela divisão de tráfego do grupo (experiment_arm.traffic_split).
  • metrics.incremental_conversion_value_winner_score: a probabilidade de esse grupo ser o vencedor em termos de valor de conversão incremental, normalizado pela divisão de tráfego do grupo (experiment_arm.traffic_split). Na API Google Ads v27 e em versões mais recentes, esse campo é preenchido apenas quando a métrica principal do estudo é o valor de conversão e é omitido (não definido) em estudos com a contagem de conversões como métrica principal.
  • metrics.cost_per_incremental_conversion_winner_score: a probabilidade de que esse grupo seja o vencedor em termos de custo por conversão incremental (menor iCPA), normalizado pelo gasto.
  • metrics.incremental_conversion_value_per_cost_winner_score: a probabilidade de esse grupo ser o vencedor em termos de valor de conversão incremental por custo (maior iROAS), normalizado pelo gasto. Na API Google Ads v27 e versões mais recentes, preenchido apenas quando a métrica principal do estudo é o valor da conversão e omitido (não definido) em estudos de contagem de conversões principais.

A consulta a seguir recupera a incrementabilidade por grupo e as pontuações bayesianas de vencedor para os dois grupos:

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'

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.
  • START_DATE: a data de início do snapshot como um número inteiro YYYYMMDD de 8 dígitos sem aspas (por exemplo, 20260501).
  • END_DATE: a data de término do snapshot como um número inteiro YYYYMMDD de oito dígitos sem aspas (por exemplo, 20260515).

Para filtrar um único grupo, adicione AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' à cláusula WHERE, em que EXPERIMENT_ID é o ID do experimento e ARM_ID é o ID do grupo retornado no campo experiment_arm.resource_name. O segmento segments.experiment_arm aceita filtragem em cláusulas WHERE (=, !=, IN, NOT IN), mas não é possível classificá-lo em uma cláusula ORDER BY.

Interpretar os resultados do teste A/B + Conversion Lift

Um estudo de Conversion Lift + teste A/B avalia duas hipóteses simultaneamente: a superioridade do grupo de teste (metrics.*_winner_score) e o Lift causal em relação ao grupo de controle não exposto (metrics.incremental_* e *_p_value). Enquanto um período de veiculação do estudo ENABLED ainda está em andamento (STUDY_IN_PROGRESS_*, quando a data atual no fuso horário do cliente é igual ou anterior a lift_measurement_flight.end_date), a comparação direta do grupo de teste e a modelagem de conversão do grupo de controle ainda estão se estabilizando. Trate as métricas em andamento como preliminares e evite promover um grupo experimental ou realocar orçamentos até que o período de veiculação seja concluído.

Nos estudos concluídos, um grupo experimental é classificado como vencedor direto quando atende aos limites mínimos de precisão (pelo menos 4 dias de snapshot, 65 conversões de referência não escalonadas e 150 conversões expostas não escalonadas), tem 0 <= p_value <= 0.50 e alcança uma pontuação de vencedor bayesiano maior que 0.55 (> 0.55) na métrica principal do estudo. Essa avaliação de hipótese dupla produz dois estados vencedores distintos (também refletidos em lift_guidance.outcome na API Google Ads v27 e mais recentes):

  • Vencedor claro com aumento causal (AB_WINNER_WITH_LIFT): o grupo vencedor supera o concorrente em uma comparação direta (winner_score > 0.55) e gera conversões incrementais ou valor de conversão estatisticamente significativos em relação ao grupo de controle não exposto. Promova ou dimensione a estratégia do braço vencedor e consulte detalhamentos dimensionais para analisar as coortes de alto desempenho.
  • Vencedor direto em paridade com o grupo de controle (AB_WINNER_PARITY_VS_CONTROL): o grupo vencedor supera o grupo concorrente em uma comparação direta (winner_score > 0.55), mas nenhum dos grupos produz um aumento incremental estatisticamente significativo em relação ao grupo de controle não exposto no nível consultado. Antes de aumentar os gastos no grupo vencedor, consulte as conversões de ALL (segments.conversion_lift_included_conversion_action_types = 'ALL') e as análises detalhadas de segments.conversion_lift_conversion_category para verificar se o aumento causal positivo foi isolado em outro lugar.

O resultado POSITIVE_LIFT_DETECTED se aplica às granularidades de consulta de teste A/B + Conversion Lift da seguinte maneira:

  • Linhas de estudo de grupo combinado (OVERALL) (consultas sem segments.experiment_arm): o estudo gerou um aumento positivo em relação ao grupo de controle não exposto (p_value <= 0.50), e nenhum grupo alcançou uma pontuação de vencedor de comparação direta maior que 0.55.
  • Linhas por grupo (segments.experiment_arm): quando um grupo vence (winner_score > 0.55) e ambos alcançam um Lift positivo em relação ao grupo de controle, a linha do grupo vencedor retorna AB_WINNER_WITH_LIFT, enquanto a linha do grupo não vencedor retorna POSITIVE_LIFT_DETECTED.
  • Linhas de fração da categoria de conversão (segments.conversion_lift_conversion_category): as linhas de aumento positivo sempre retornam POSITIVE_LIFT_DETECTED porque as pontuações vencedoras não são avaliadas por categoria de conversão.

Quando uma fração retornar NOT_ENOUGH_DATA ou NO_SIGNIFICANT_LIFT, não pause os grupos nem exclua públicos-alvo com base na insuficiência de amostras de uma única fração. Verifique as métricas gerais do estudo e as conversões de ALL (segments.conversion_lift_included_conversion_action_types = 'ALL').

Consultar resultados de grupos combinados e de vários estudos

Quando você omite o segmento segments.experiment_arm de uma consulta no recurso lift_measurement_config, a API retorna a incrementalidade no nível do estudo agregada nos dois grupos combinados. Em consultas de grupos combinados, omita as quatro métricas metrics.*_winner_score, que se aplicam apenas a grupos concorrentes e são omitidas (não definidas) em linhas de grupos combinados sem segments.experiment_arm. Use as consultas no nível do estudo em Consultar o Conversion Lift e o iCPA e Consultar o aumento no valor da conversão e o iROAS.

Quando você segmenta os resultados de testes A/B + Conversion Lift pelo segmento segments.experiment_arm, a API aceita apenas o segmento segments.conversion_lift_conversion_category como uma dimensão de detalhamento adicional. Como os gastos do grupo não são atribuídos a categorias de conversão individuais, avalie as métricas de conversão e de aumento do valor da conversão (omitindo as métricas de iCPA e iROAS, que falham na validação de consulta com um erro QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE na API Google Ads v27 e versões mais recentes) ao incluir o segmento segments.conversion_lift_conversion_category. Os segmentos segments.conversion_action, segments.conversion_action_name, segments.age_range, segments.gender, segments.device, segments.country, segments.country_localized_name e segments.date são incompatíveis com o segmento segments.experiment_arm e com as métricas metrics.*_winner_score. Selecionar qualquer um desses segmentos incompatíveis com segments.experiment_arm retorna um erro QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE (e um erro QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE se a consulta também selecionar qualquer métrica metrics.*_winner_score).

Para recuperar resultados de várias configurações de estudo em uma única solicitação, filtre com o 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'

Substitua:

  • CONFIG_ID_1: o ID inteiro da primeira configuração de medição de Lift.
  • CONFIG_ID_2: o ID inteiro da segunda configuração de medição de Lift.
  • START_DATE: a data de início do snapshot como um número inteiro YYYYMMDD de 8 dígitos sem aspas (por exemplo, 20260501).
  • END_DATE: a data de término do snapshot como um número inteiro YYYYMMDD de oito dígitos sem aspas (por exemplo, 20260515).

A igualdade de data exata (= START_DATE e = END_DATE) retorna linhas apenas para estudos que compartilham essa janela de snapshot exata. Ao consultar estudos com diferentes datas de início de veiculação ou datas de snapshot avaliadas mais recentes, filtre com operadores de intervalo (>= e <=) ou omita os filtros de data da cláusula WHERE, mantendo os segmentos segments.conversion_lift_start_date e segments.conversion_lift_end_date na cláusula SELECT.

Relatórios de Search Lift

Para medir o aumento no volume de consultas de pesquisa orgânica gerado pelas suas campanhas publicitárias na API Google Ads v26 e versões mais recentes, consulte os recursos de relatórios de Search Lift. O Search Lift quantifica a diferença no comportamento de pesquisa da sua marca ou dos seus produtos entre os usuários expostos aos seus anúncios e um grupo de controle não exposto.

Recursos e segmentação do Search Lift

Consulte o recurso SearchLiftKeywordBundle para recuperar detalhes sobre os pacotes de palavras-chave configurados para estudos de Search Lift. O recurso SearchLiftKeywordBundle é somente leitura na API Google Ads (todos os campos são OUTPUT_ONLY), e os pacotes de palavras-chave são configurados na interface do Google Ads ou pelo seu representante do Google ou contato do GPS. Os campos que podem ser consultados na GAQL são resource_name, search_lift_keyword_bundle_id, source (SearchLiftMatchingInfoSource) e status (SearchLiftKeywordBundleStatus). O campo repetido keywords não pode ser selecionado em consultas GAQL.

Consulte o recurso LiftMeasurementConfig para recuperar as métricas de Search Lift e as configurações gerais do estudo.

Na API Google Ads v27 e versões mais recentes, também é possível selecionar o campo lift_measurement_config.lift_guidance somente leitura (OUTPUT_ONLY) (lift_guidance.outcome e lift_guidance.guidance_message, do tipo LiftGuidance) na cláusula SELECT da GAQL em lift_measurement_config ao consultar métricas ou segmentos de Search Lift (segments.search_lift_keyword_bundle ou segments.search_property). Em lift_measurement_config, lift_guidance é omitido em consultas de configuração somente de metadados, e lift_guidance.guidance_message pode conter links inline do Markdown (como [Learn more](https://support.google.com/...)). Para o Search Lift, lift_guidance.outcome retorna STUDY_IN_PROGRESS_WITH_LIFT, STUDY_IN_PROGRESS_NO_LIFT_YET, STUDY_IN_PROGRESS_COLLECTING_DATA, POSITIVE_LIFT_DETECTED (pelo menos 70% de certeza, p_value <= 0.30), NO_SIGNIFICANT_LIFT ou NOT_ENOUGH_DATA (avaliado em relação a limites de pelo menos 1.000.000 de impressões gerais ou 100.000 impressões de fração, pelo menos 75 pesquisas observadas e pelo menos 17 de 20 buckets de cookies, em que um único pacote de palavras-chave com pouca potência faz com que os resultados gerais do estudo informem NOT_ENOUGH_DATA).

Segmentar a performance do Search Lift nas seguintes dimensões:

  • segments.search_lift_keyword_bundle: segmentar pelo nome do recurso do pacote de palavras-chave. Compatível com os segmentos segments.search_property, segments.date e demográficos (segments.device, segments.age_range e segments.gender). Cada pacote de palavras-chave informa o custo e as impressões totais da campanha, e as palavras-chave podem pertencer a mais de um pacote. Não some as métricas de metrics.search_lift_cost_micros, metrics.search_lift_impressions ou Search Lift em grupos de palavras-chave.
  • segments.search_property: segmenta pela propriedade de pesquisa em que a pesquisa ocorreu, definida pelo tipo enumerado SearchLiftSearchProperty (como GOOGLE_SEARCH ou YOUTUBE). O segmento segments.search_property é compatível apenas com os segmentos segments.search_lift_keyword_bundle e segments.date. A combinação de segments.search_property com segmentos demográficos (segments.device, segments.age_range ou segments.gender) falha na validação da consulta. Como segments.search_property particiona onde as pesquisas orgânicas subsequentes ocorreram, em vez de onde os anúncios foram veiculados, as linhas segmentadas por segments.search_property repetem o custo e as impressões não particionados no nível da campanha na API Google Ads v26. A partir da v27 da API Google Ads, todas as oito métricas de gastos e impressões (metrics.search_lift_cost_micros, metrics.search_lift_impressions, metrics.normalized_incremental_searches_per_cost* e metrics.normalized_incremental_searches_per_impression*) são incompatíveis com segments.search_property e falham na validação da consulta com um erro QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.
  • Segmentos demográficos e de data: segments.device, segments.age_range, segments.gender e segments.date.

Métricas de Search Lift

O recurso LiftMeasurementConfig fornece métricas de Search Lift para avaliar mudanças no comportamento de pesquisa:

  • metrics.relative_search_lift: a diferença no volume de consultas de pesquisa entre os grupos exposto e de controle, expressa como uma fração das consultas de pesquisa no grupo de controle.
  • metrics.relative_search_lift_p90_lower_bound e metrics.relative_search_lift_p90_upper_bound: os limites de confiança unilateral de 90% (que juntos formam um intervalo de confiança bilateral de 80%) para o Search Lift relativo.
  • metrics.incremental_searches_p_value: o valor-p para pesquisas incrementais, que representa a probabilidade estatística de que o aumento observado nas consultas de pesquisa tenha ocorrido por acaso.
  • metrics.search_lift_cost_micros: o custo total (em micros) das impressões de anúncios veiculadas para esse segmento de medição de Search Lift. Incompatível com segments.search_property na API Google Ads v27 e versões mais recentes.
  • metrics.search_lift_impressions: o número total de impressões de anúncios veiculadas para esse segmento de medição de Search Lift. Incompatível com segments.search_property na API Google Ads v27 e versões mais recentes.

As seguintes métricas incrementais normalizadas, com os limites de confiança unilaterais de 90% correspondentes (*_p90_lower_bound e *_p90_upper_bound), são informadas quando o Lift é estatisticamente positivo:

Exemplos de consultas de Search Lift

As consultas da GAQL a seguir mostram como recuperar conjuntos de palavras-chave e métricas de performance do Search Lift.

Consulta de grupo de palavras-chave

Para recuperar conjuntos de palavras-chave configurados para medições de Search Lift, consulte o 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

Os valores de search_lift_keyword_bundle.resource_name recuperados na consulta do pacote de palavras-chave correspondem aos valores retornados no segmento segments.search_lift_keyword_bundle na consulta a seguir. Para descobrir a CONFIG_ID, as campanhas vinculadas e a programação de veiculação do seu estudo, siga as instruções em Descobrir configurações do estudo e veiculações nos recursos lift_measurement_config e lift_measurement_flight (filtrando as veiculações por lift_measurement_flight.lift_type = 'SEARCH').

A consulta a seguir recupera as métricas de Search Lift segmentadas por conjunto de palavras-chave e propriedade de pesquisa (omita segments.search_property ao selecionar metrics.search_lift_cost_micros ou 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

Substitua:

  • CONFIG_ID: o ID inteiro da configuração de medição de Lift.