Rapports sur l'impact

Pour mesurer l'impact causal de vos campagnes publicitaires sur la perception de la marque, les conversions, la valeur de conversion et le comportement de recherche naturelle, interrogez les ressources de reporting sur les mesures du lift dans l'API Google Ads :

  • Rapports sur le brand lift : évaluent l'influence de l'exposition publicitaire sur la perception de la marque pour les types de mesures étudiés dans l'API Google Ads v25 et les versions ultérieures.
  • Rapports sur le conversion lift : mesurent les conversions incrémentales, la valeur de conversion, le coût par conversion incrémentale (CPA incrémental) et le retour incrémental sur les dépenses publicitaires (ROAS incrémental) par rapport à un groupe d'exclusion non exposé dans l'API Google Ads v25 et versions ultérieures, y compris :
  • Rapports sur le search lift : quantifient l'augmentation incrémentale du volume de requêtes de recherche naturelle dans la recherche Google et sur YouTube, générée par l'exposition aux annonces dans l'API Google Ads v26 et versions ultérieures.

Pour en savoir plus sur les rapports de tests A/B standards sur les ressources experiment et campaign, consultez Créer des rapports sur les tests.

Rapports sur le brand lift

Pour évaluer l'influence de vos campagnes publicitaires sur la perception de votre marque dans l'API Google Ads v25 et les versions ultérieures, interrogez les ressources dédiées à la mesure du brand lift.

Ressources et vues détaillées du brand lift

Les configurations, les périodes de diffusion et les vues détaillées du brand lift sont en lecture seule dans l'API Google Ads (tous les champs sont OUTPUT_ONLY). Elles sont configurées dans l'UI Google Ads, ou par votre représentant Google ou votre contact GPS. Interrogez ces ressources à l'aide du paramètre customer_id du compte (administrateur ou compte enfant) propriétaire de l'étude.

Interrogez la ressource LiftMeasurementFlight pour récupérer les métadonnées de planification et de collecte des enquêtes de brand lift au niveau de la période de diffusion, y compris l'état de la période de diffusion (lift_measurement_flight.status, défini par l'énumération LiftMeasurementFlightStatus avec les valeurs ENABLED pour les périodes de diffusion actives et STOPPED pour les périodes de diffusion interrompues manuellement), les plages de dates de la période de diffusion (lift_measurement_flight.start_date et lift_measurement_flight.end_date) dans le fuseau horaire du client, et la progression de la collecte des réponses à l'enquête cible (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, où 0 est égal à 0 % et 1000000 à 100 %). Pour déterminer si une diffusion ENABLED est en cours ou terminée, comparez la date actuelle dans le fuseau horaire du client à lift_measurement_flight.start_date et lift_measurement_flight.end_date, puis vérifiez si response_collection_ratio_micros a atteint 1000000.

Interrogez la ressource LiftMeasurementConfig pour récupérer les métriques globales de brand lift au niveau de l'étude, ou interrogez les ressources de répartition suivantes pour analyser les métriques de brand lift selon des dimensions spécifiques :

Incluez le segment segments.brand_lift_measurement_type pour ventiler les métriques de brand lift par type de question posée, défini par l'énumération BrandLiftMeasurementType (par exemple, RECALL ou AWARENESS). Lorsque vous omettez le segment segments.brand_lift_measurement_type, l'API renvoie les métriques pour un seul type de mesure sélectionné automatiquement par tranche. Incluez le segment segments.date pour ventiler les métriques de brand lift par date (YYYY-MM-DD). La métrique metrics.cost_per_lifted_cookie est renvoyée en micros de la devise du compte propriétaire de l'étude.

Dans l'API Google Ads v27 et les versions ultérieures, vous pouvez également sélectionner le champ lift_guidance en lecture seule (OUTPUT_ONLY) (lift_guidance.outcome et lift_guidance.guidance_message, de type LiftGuidance) dans la clause SELECT du langage de requête Google Ads (GAQL) sur lift_measurement_config et sur les cinq ressources de répartition du brand lift (lift_measurement_age_range, lift_measurement_campaign, lift_measurement_device, lift_measurement_gender et lift_measurement_video) pour recevoir une interprétation statistique au niveau des lignes. Sur lift_measurement_config, lift_guidance n'est renseigné que lorsque la requête sélectionne ou filtre également des métriques ou des segments Lift (il est omis dans les requêtes de configuration de métadonnées uniquement), et lift_guidance.guidance_message peut contenir des liens Markdown intégrés (comme [Learn more](https://support.google.com/...)). Vous ne pouvez pas filtrer ni trier les sous-champs lift_guidance dans les clauses WHERE ou ORDER BY. Pour obtenir une description des valeurs LiftOutcomeEnum.LiftOutcome renvoyées dans lift_guidance.outcome, consultez Interpréter les résultats du brand lift.

Seuils de signalement et réponses vides

Les rapports sur le brand lift sont soumis à un délai de latence (nécessitant un délai de 24 à 48 heures après le début d'une étude) et à un nombre de réponses par type de mesure interrogé (segments.brand_lift_measurement_type) pour respecter les seuils de confidentialité et de représentativité statistique :

  • Taux de réponse positive (metrics.brand_lift_baseline_positive_response_rate* et metrics.brand_lift_exposed_positive_response_rate*) : au moins 50 réponses à l'enquête dans le groupe correspondant (exposé ou non exposé).
  • Seuil d'impact positif strict (étude globale sur LiftMeasurementConfig ou segment indépendant) : impact statistiquement positif (p_value <= 0.50) avec au moins 2 000 réponses au total et 860 réponses par groupe.
  • Seuil d'impact positif assoupli pour les segments (sur une ressource de répartition lorsque l'étude globale atteint le seuil strict avec un impact positif) : impact statistiquement positif (p_value <= 0.50) avec au moins 500 réponses au total et 200 réponses par groupe.
  • Seuil d'impact non positif atteint (NO_SIGNIFICANT_LIFT par rapport à NOT_ENOUGH_DATA) : au moins 4 100 réponses au total par métrique lorsqu'aucun impact statistiquement positif n'est détecté.

Les requêtes envoyées à LiftMeasurementConfig et aux cinq ressources de répartition du brand lift (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign et LiftMeasurementVideo) renvoient une réponse vide (results: []) plutôt qu'une erreur dans les cas suivants :

  • Le paramètre customer_id interrogé ne figure pas sur la liste d'autorisation ou n'est pas propriétaire de l'étude.
  • Les filtres de date WHERE ne correspondent pas aux dates de diffusion évaluées (lift_measurement_flight.start_date et lift_measurement_flight.end_date).
  • L'étude ou la tranche démographique, d'appareil, de campagne ou de vidéo spécifique n'a pas atteint les seuils de délai de création de rapports (24 à 48 heures) et de volume de réponses à l'enquête, même si LiftMeasurementConfig renvoie les résultats globaux de l'étude.

Pour résoudre les problèmes de réponses vides, procédez comme suit :

  1. Interrogez lift_measurement_flight pour vérifier que lift_measurement_flight.status = 'ENABLED', vérifiez que vos filtres de date WHERE se situent entre lift_measurement_flight.start_date et lift_measurement_flight.end_date, et inspectez la progression de l'enquête dans lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros (où 1000000 est égal à 100 %).
  2. Interrogez LiftMeasurementConfig pour vérifier si l'étude globale a généré des métriques de brand lift pouvant être incluses dans un rapport avant d'interroger les ressources de répartition dimensionnelle.

Interpréter les résultats du brand lift

Dans l'API Google Ads v27 et les versions ultérieures, le champ lift_guidance.outcome renvoie une valeur LiftOutcomeEnum.LiftOutcome qui classe l'état statistique de chaque ligne renvoyée, ainsi que des conseils de correction lisibles par l'humain dans lift_guidance.guidance_message :

  • Résultats d'une étude en cours (lorsque lift_measurement_flight.status est ENABLED et que la date actuelle dans le fuseau horaire du client est antérieure ou égale à lift_measurement_flight.end_date avec lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros inférieur à 1000000) :
    • STUDY_IN_PROGRESS_WITH_LIFT : l'étude est en cours et un impact positif préliminaire se dégage.
    • STUDY_IN_PROGRESS_NO_LIFT_YET : l'étude est en cours avec un volume initial suffisant, et aucun impact statistiquement significatif n'a encore été détecté.
    • STUDY_IN_PROGRESS_COLLECTING_DATA : l'étude est en cours et collecte activement les premières réponses à l'enquête pour atteindre les seuils de reporting statistique.
  • Résultats d'une étude terminée (lorsque la date lift_measurement_flight.end_date est passée ou que lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros a atteint 1000000) :
    • POSITIVE_LIFT_DETECTED : un impact positif statistiquement significatif a été détecté pour l'étude ou la tranche terminée.
    • NO_SIGNIFICANT_LIFT : l'étude ou la tranche terminée a atteint les seuils de précision statistique (au moins 4 100 réponses au total par métrique), et aucun impact positif statistiquement significatif n'a été détecté.
    • NOT_ENOUGH_DATA : l'étude ou la tranche terminée n'a pas atteint les seuils de réponses à l'enquête requis pour la création de rapports statistiques (au moins 2 000 réponses au total et 860 réponses par bras pour un impact positif sur l'ensemble de l'étude, 500 réponses au total et 200 réponses par bras pour un impact positif sur une tranche lorsque l'ensemble de l'étude a un impact positif, ou 4 100 réponses au total par métrique lorsqu'aucun impact positif n'est détecté).

Appliquez les consignes suivantes lorsque vous interprétez les résultats de brand lift :

  • Sessions en cours et terminées (STUDY_IN_PROGRESS_*) : tant qu'une session d'étude ENABLED est en cours (avant que lift_measurement_flight.end_date ne soit écoulé et que response_collection_ratio_micros n'atteigne 1000000), les réponses à l'enquête et la modélisation corrigée des biais sont toujours en cours de stabilisation. Considérez les métriques en cours comme préliminaires et évitez de mettre en veille les campagnes ou de réduire les budgets avant la fin de la période de diffusion.
  • Impact positif (POSITIVE_LIFT_DETECTED) : lorsqu'un brand lift positif est détecté, interrogez les ressources de répartition dimensionnelle (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign et LiftMeasurementVideo) pour identifier les cohortes d'audience performantes ("points forts") et évaluer la résonance des créations dans l'entonnoir de la marque.
  • Données insuffisantes ou aucun impact significatif (NOT_ENOUGH_DATA ou NO_SIGNIFICANT_LIFT) : lorsque le volume de réponses à l'enquête est insuffisant (moins de 4 100 réponses au total par métrique sans impact positif, ou moins de 2 000/860 réponses pour le seuil strict ou 500/200 réponses pour le seuil assoupli pour un impact positif) ou qu'aucun impact statistiquement significatif n'est détecté sur une tranche, ne considérez pas cela comme un échec de la campagne et n'excluez pas d'audiences en raison d'un échantillon insuffisant pour une seule tranche. Vérifiez les métriques globales de l'étude sur LiftMeasurementConfig, interrogez d'autres valeurs segments.brand_lift_measurement_type interrogées (comme RECALL ou AWARENESS en haut de l'entonnoir) et vérifiez les dimensions de répartition restantes.

Exemples de requêtes de brand lift

Étant donné que les métadonnées de l'étude et les statistiques d'impact résident sur des ressources distinctes, l'interrogation des détails de l'étude et des statistiques de performances nécessite des requêtes GAQL distinctes.

Requête d'informations sur un vol

Pour récupérer les métadonnées d'une session Brand Lift, telles que son état, son type de mesure, ses dates planifiées et la progression de la collecte des enquêtes, interrogez la ressource 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'

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du brand lift (lift_measurement_config.lift_measurement_config_id).

Requête de statistiques

Pour récupérer les métriques de brand lift, interrogez la ressource LiftMeasurementConfig ou la ressource de répartition appropriée. Par exemple, la requête suivante récupère les métriques de brand lift segmentées par campagne et par type de mesure du brand lift à partir de la ressource 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

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.

Rapports sur le conversion lift

Dans l'API Google Ads v25 et les versions ultérieures, les rapports sur le conversion lift mesurent l'impact incrémental de vos annonces sur les conversions et la valeur de conversion. Les études de conversion lift comparent le comportement de conversion entre un groupe exposé (utilisateurs susceptibles de voir vos annonces) et un groupe de contrôle non exposé (utilisateurs pour lesquels la diffusion de vos annonces a été bloquée).

Les configurations, les diffusions et les liens de test du conversion lift sont en lecture seule dans l'API Google Ads (tous les champs sont OUTPUT_ONLY). Ils sont configurés dans l'UI Google Ads ou par votre représentant Google ou votre contact GPS. Interrogez la ressource lift_measurement_config à l'aide du paramètre customer_id du compte propriétaire de l'étude. Un compte administrateur peut interroger directement les études de conversion lift multicomptes dont il est propriétaire. Interrogez les études appartenant à un compte enfant à l'aide du paramètre customer_id du compte enfant (authentifié éventuellement avec l'en-tête login-customer-id).

Les rapports sur le conversion lift sont compatibles avec deux workflows d'étude, qui partagent tous deux les mêmes découvertes d'études et de diffusions, plages de dates des instantanés cumulés et champs d'application des actions de conversion :

  • Rapports sur le conversion lift autonome : mesurent l'incrémentalité globale, le coût par conversion incrémentale (CPA incrémental) et le retour sur les dépenses publicitaires incrémental (ROAS incrémental) pour les actions de conversion sélectionnées ou toutes les actions de conversion des campagnes mesurées dans l'étude.
  • Rapports sur les tests A/B et le conversion lift : mesure l'incrémentalité par groupe et les scores bayésiens des gagnants entre deux groupes de test concurrents (contrôle et traitement), ainsi que l'incrémentalité globale de l'étude.

Pour obtenir de l'aide sur la création de requêtes valides pour la ressource lift_measurement_config, utilisez l'outil de création de requêtes Google Ads.

Dans l'API Google Ads v27 et les versions ultérieures, vous pouvez sélectionner le champ lift_measurement_config.lift_guidance en lecture seule (OUTPUT_ONLY) (lift_guidance.outcome et lift_guidance.guidance_message, de type LiftGuidance) dans la clause GAQL SELECT sur lift_measurement_config pour recevoir une interprétation statistique au niveau des lignes pour les requêtes Conversion Lift et A/B + Conversion Lift autonomes. Sur lift_measurement_config, lift_guidance n'est renseigné que lorsque la requête sélectionne ou filtre également des métriques ou des segments Lift (il est omis dans les requêtes de configuration ne contenant que des métadonnées), et lift_guidance.guidance_message peut contenir des liens Markdown intégrés (tels que [Learn more](https://support.google.com/...)). Vous ne pouvez pas filtrer ni trier les sous-champs lift_guidance dans les clauses WHERE ou ORDER BY. Le champ lift_guidance.outcome renvoie l'une des valeurs LiftOutcomeEnum.LiftOutcome suivantes :

  • Résultats d'une étude en cours (lorsque lift_measurement_flight.status est défini sur ENABLED et que la date actuelle dans le fuseau horaire du client est antérieure ou égale à lift_measurement_flight.end_date) :
    • STUDY_IN_PROGRESS_WITH_LIFT : l'étude est en cours et un impact positif préliminaire se dégage.
    • STUDY_IN_PROGRESS_NO_LIFT_YET : l'étude est en cours avec un volume initial suffisant, et aucun impact statistiquement significatif n'a encore été détecté.
    • STUDY_IN_PROGRESS_COLLECTING_DATA : l'étude est en cours et collecte activement les données de conversion initiales pour atteindre les seuils de reporting statistique.
  • Résultats de l'étude terminée (après le lift_measurement_flight.end_date) :
    • POSITIVE_LIFT_DETECTED : un impact positif statistiquement significatif a été détecté pour l'étude, le groupe de test ou la tranche terminés.
    • AB_WINNER_WITH_LIFT : une étude A/B + Conversion Lift a été réalisée avec un groupe de test gagnant en comparaison directe et un lift positif statistiquement significatif par rapport au groupe de contrôle non exposé.
    • AB_WINNER_PARITY_VS_CONTROL : une étude A/B + Conversion Lift a été réalisée avec un groupe de test gagnant en comparaison directe, mais à parité avec le groupe de contrôle non exposé.
    • NO_SIGNIFICANT_LIFT : l'étude, le groupe de test ou la tranche terminés ont atteint les seuils de précision statistique, et aucun impact positif statistiquement significatif n'a été détecté.
    • NOT_ENOUGH_DATA : l'étude, le groupe de test ou la tranche n'ont pas accumulé suffisamment de conversions pour atteindre les seuils de précision statistique.

Découvrir les configurations d'étude et les vols

Pour générer un rapport sur une étude de conversion lift, commencez par découvrir la configuration de l'étude et son calendrier de diffusion :

  1. Récupérer la configuration d'étude : interrogez la ressource LiftMeasurementConfig pour récupérer le nom de l'étude, le ratio de retenue (lift_measurement_config.conversion_lift_holdback_ratio_micros), les actions de conversion suivies (lift_measurement_config.conversion_actions) et, dans l'API Google Ads v26 et versions ultérieures, les campagnes activement associées (lift_measurement_config.campaigns). Le champ conversion_lift_holdback_ratio_micros est exprimé en micros, où 1,000,000 correspond à 100 % (par exemple, 300000 représente un groupe de retenue non exposé de 30 %). Si vous ne connaissez pas l'CONFIG_ID de l'étude, omettez la clause WHERE pour lister toutes les configurations d'étude du compte.
  2. Récupérer les fenêtres d'observation des vols : interrogez la ressource LiftMeasurementFlight pour trouver les dates de vol prévues (lift_measurement_flight.start_date et lift_measurement_flight.end_date) dans le fuseau horaire du client. Étant donné qu'une seule ressource LiftMeasurementConfig peut regrouper des sessions de brand lift (SURVEY), de conversion lift (CONVERSION) et de search lift (SEARCH), incluez le champ lift_measurement_flight.lift_type dans la clause SELECT et filtrez par lift_measurement_flight.lift_type = 'CONVERSION' dans la clause WHERE. Les champs lift_measurement_flight.start_date et lift_measurement_flight.end_date peuvent être triés dans les clauses ORDER BY, mais vous ne pouvez pas les filtrer dans une clause WHERE.

La requête suivante récupère la configuration d'étude (omettez le champ lift_measurement_config.campaigns dans la version 25 de l'API Google Ads, car ce champ nécessite la version 26 ou ultérieure de l'API Google Ads) :

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

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du brand lift (lift_measurement_config.lift_measurement_config_id).

La requête suivante récupère le calendrier de diffusion du conversion lift pour l'étude :

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'

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du brand lift (lift_measurement_config.lift_measurement_config_id).

Dans l'API Google Ads v26 et les versions ultérieures, vous pouvez également découvrir la configuration de la mesure du lift associée à une campagne directement à partir de la ressource campaign en interrogeant le champ campaign.lift_measurement_config. L'interrogation de ce champ évite d'avoir à croiser les références de la ressource LiftMeasurementConfig séparément :

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

Remplacez les éléments suivants :

  • CAMPAIGN_ID : ID entier de la campagne (campaign.id).

Le champ campaign.lift_measurement_config renvoie un nom de ressource au format customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID. Si une campagne a participé à plusieurs études de l'impact, ce champ identifie la configuration associée la plus récente (active ou inactive). En revanche, le champ lift_measurement_config.campaigns ne liste que les campagnes activement associées.

Interroger des plages de dates d'instantanés cumulés

Les résultats du conversion lift sont structurés sous forme d'instantanés d'évaluation cumulés quotidiens à partir de la date de début de la période de diffusion :

segments.conversion_lift_start_date et segments.conversion_lift_end_date sont des champs INT64 formatés en tant qu'entiers à huit chiffres sans guillemets ni tirets au format YYYYMMDD (par exemple, 20260501). En revanche, les champs lift_measurement_flight.start_date et lift_measurement_flight.end_date renvoient des chaînes de date au format ISO 8601 YYYY-MM-DD (par exemple, 2026-05-01). Contrairement aux requêtes brand lift et search lift, le segment segments.date n'est compatible avec aucune métrique ni aucun segment conversion lift. Si vous sélectionnez le segment segments.date avec des segments de conversion lift (comme segments.conversion_lift_start_date) dans la clause SELECT, une erreur QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE est renvoyée. En revanche, si vous combinez segments.date avec des métriques de conversion lift, une erreur QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE est renvoyée.

Le dernier instantané calculé peut être en retard par rapport à la date de fin d'un vol actif pendant le traitement des données. Interrogez toujours la ressource lift_measurement_config pour obtenir les paires (segments.conversion_lift_start_date, segments.conversion_lift_end_date) disponibles, classées par segments.conversion_lift_end_date DESC en premier, afin d'identifier l'instantané évalué le plus récent.

La requête suivante récupère les plages de dates d'instantanés disponibles pour une étude :

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

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.

Filtrer par champ d'application de l'action de conversion

Le conversion lift évalue l'incrémentalité sur deux champs d'application définis par le segment segments.conversion_lift_included_conversion_action_types :

  • SELECTED : actions de conversion sélectionnées lors de la configuration de l'étude, ou toutes les actions de conversion (principales) pouvant faire l'objet d'enchères si aucune action de conversion personnalisée n'a été spécifiée.
  • ALL : toutes les actions de conversion des campagnes mesurées dans l'étude.

Lorsque vous interrogez la ressource lift_measurement_config pour obtenir des métriques de conversion lift sans filtrer sur le segment segments.conversion_lift_included_conversion_action_types, l'API renvoie deux lignes par tranche : une pour ALL et une pour SELECTED. Dans GAQL, tout champ de segment autre qu'une date (et tout segment de date d'instantané de conversion lift) filtré dans la clause WHERE doit également apparaître dans la clause SELECT. Sinon, l'API renvoie une erreur QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE. Lorsque vous filtrez par segments.conversion_lift_included_conversion_action_types = 'SELECTED' dans la clause WHERE, incluez ce segment dans la clause SELECT.

Rapports Conversion Lift autonomes

Les études de conversion lift autonomes mesurent l'impact incrémental de vos annonces par rapport à un groupe de holdback non exposé, sans diviser les campagnes en groupes de traitement concurrents.

Interroger le conversion lift et le CPA incrémentiel

Le conversion lift indique des estimations ponctuelles ainsi que des limites de confiance unilatérales de 90 % (*_p90_lower_bound et *_p90_upper_bound, qui forment ensemble un intervalle de confiance bilatéral de 80 %) et des valeurs p (p_value <= 0.10 correspond à une pertinence statistique unilatérale de 90 %) :

L'API omet les métriques de conversion lift sur les lignes renvoyées dans les cas suivants :

  • La période d'inclusion de l'instantané est inférieure à quatre jours.
  • Le volume de conversions observées non ajusté est inférieur aux seuils de précision minimaux (moins de 65 conversions de référence observées dans le groupe d'exclusion ou moins de 150 conversions observées dans le groupe exposé, évaluées avant l'ajustement metrics.conversion_lift_baseline_conversions).
  • Le lift mesuré n'est pas positif (metrics.incremental_conversions_p_value > 0.5 pour les métriques de conversion ou metrics.incremental_conversion_value_p_value > 0.5 pour les métriques de valeur de conversion).
  • Dans l'API Google Ads v27 et les versions ultérieures, les métriques iROAS (metrics.incremental_conversion_value_per_cost*) et les métriques de score gagnant de la valeur de conversion (metrics.incremental_conversion_value_winner_score et metrics.incremental_conversion_value_per_cost_winner_score) sont interrogées sur une étude configurée lors de la configuration avec le nombre de conversions plutôt que la valeur de conversion comme métrique principale. Les métriques de valeur de conversion sans coût (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* et metrics.relative_conversion_value_lift*) restent renseignées dans les études basées sur le nombre de conversions chaque fois que le lift de la valeur de conversion peut être inclus dans un rapport.
  • Plusieurs lignes ou études sont agrégées, car vous avez omis les champs 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 de la clause SELECT.

Suivez les consignes ci-dessous pour interpréter les résultats d'une étude de conversion lift autonome :

  • Périodes de diffusion en cours et terminées (STUDY_IN_PROGRESS_*) : lorsqu'une période de diffusion d'étude ENABLED est toujours en cours (lorsque la date actuelle dans le fuseau horaire du client est antérieure ou égale à lift_measurement_flight.end_date), la modélisation des conversions de référence et de traitement, ainsi que l'attribution des conversions différées, sont toujours en cours de stabilisation. Considérez les métriques en cours comme préliminaires et évitez de mettre en veille les campagnes ou de réduire les budgets avant la fin de la période de diffusion.
  • Impact positif (POSITIVE_LIFT_DETECTED) : la métrique de conversion lift peut être incluse dans les rapports et lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED' se déclenche chaque fois que l'impact mesuré est positif (p_value <= 0.50, correspondant à une certitude d'au moins 50 % avec une estimation ponctuelle positive, tandis que p_value <= 0.10 indique une pertinence statistique unilatérale de 90 % où *_p90_lower_bound >= 0) et que les seuils de précision minimale (au moins quatre jours d'instantané, au moins 65 conversions de référence non mises à l'échelle et au moins 150 conversions exposées non mises à l'échelle) sont atteints. Lorsqu'un impact positif est détecté, interrogez les répartitions dimensionnelles (données démographiques, appareil, pays, ou catégorie et action de conversion) pour identifier les cohortes performantes ("points forts").
  • Données insuffisantes ou aucun impact significatif (NOT_ENOUGH_DATA ou NO_SIGNIFICANT_LIFT) : lorsque le volume de données est insuffisant (moins de 65 conversions de référence non mises à l'échelle ou moins de 150 conversions exposées non mises à l'échelle) ou qu'aucun impact statistiquement significatif n'est détecté sur une tranche, ne considérez pas cela comme un échec de la campagne et n'excluez pas d'audiences en raison d'un échantillon insuffisant pour une seule tranche. Vérifiez les métriques globales de l'étude et interrogez segments.conversion_lift_included_conversion_action_types = 'ALL' (si SELECTED n'indique aucun impact) ou les répartitions dimensionnelles restantes pour vérifier si un impact positif a été isolé ailleurs.

La requête suivante récupère l'incrémentalité globale des conversions, les limites de confiance et le CPA incrémentiel :

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'

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.
  • START_DATE : date de début de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260501).
  • END_DATE : date de fin de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260515).

Interroger l'augmentation de la valeur de conversion et l'iROAS

Pour évaluer les revenus incrémentaux générés par vos dépenses publicitaires, interrogez les métriques de valeur de conversion et la métrique metrics.incremental_conversion_value_per_cost. Les métriques de valeur de conversion sans coût (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* et metrics.relative_conversion_value_lift*) sont renseignées chaque fois que l'étude présente un lift de la valeur de conversion pouvant être inclus dans un rapport, que la métrique principale de l'étude soit le nombre de conversions ou la valeur de conversion. Dans l'API Google Ads v27 et les versions ultérieures, les métriques iROAS (metrics.incremental_conversion_value_per_cost*), ainsi que metrics.incremental_conversion_value_winner_score et metrics.incremental_conversion_value_per_cost_winner_score, ne sont renvoyées que si l'étude a été configurée lors de la configuration avec la valeur de conversion comme métrique principale (et sont omises dans les études basées sur le nombre de conversions) :

La requête suivante récupère l'incrémentalité de la valeur de conversion, les limites de confiance et le ROAS incrémental :

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'

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.
  • START_DATE : date de début de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260501).
  • END_DATE : date de fin de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260515).

Segmenter les résultats par dimension

Segmentez les métriques de conversion incrémentale par catégorie de conversion, action de conversion, données démographiques, appareil ou zone géographique. Lorsque vous interrogez la ressource lift_measurement_config, ne sélectionnez que des combinaisons de segments compatibles :

La sélection de segments mutuellement incompatibles dans la clause SELECT entraîne l'échec de la validation de la requête et renvoie une erreur QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Utilisez le générateur de requêtes Google Ads pour valider les combinaisons de segments de manière interactive.

Évaluez les métriques de rentabilité (metrics.cost_per_incremental_conversion* et metrics.incremental_conversion_value_per_cost*) uniquement sur les lignes d'étude globale ou les lignes segments.experiment_arm. Dans les versions 25 et 26 de l'API Google Ads, le schéma permet de sélectionner les six métriques de ratio de coût (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 et metrics.incremental_conversion_value_per_cost_p90_upper_bound) avec les huit segments de tranche non-arm (segments.conversion_action, segments.conversion_action_name, segments.conversion_lift_conversion_category, segments.age_range, segments.gender, segments.device, segments.country et segments.country_localized_name). À partir de la version 27 de l'API Google Ads, la sélection de l'une de ces six métriques de ratio de coût avec l'un de ces huit segments de tranche non-arm échoue à la validation de la requête et renvoie une erreur QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE. Les métriques de valeur de conversion sans coût (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* et metrics.relative_conversion_value_lift*) restent compatibles avec les segments de catégorie de conversion, d'action de conversion, de données démographiques, d'appareil et de pays chaque fois que l'amélioration de la valeur de conversion peut être enregistrée (que la métrique principale de l'étude soit le nombre de conversions ou la valeur de conversion).

Pour évaluer le lift dans les catégories de conversion définies dans l'énumération ConversionActionCategory (comme PURCHASE, SIGNUP ou SUBMIT_LEAD_FORM), segmentez les résultats par segment 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'

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.
  • START_DATE : date de début de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260501).
  • END_DATE : date de fin de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260515).

Le segment segments.conversion_action renvoie le nom de ressource de l'action de conversion au format customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID. Sélectionnez le segment segments.conversion_action_name sur la ressource lift_measurement_config pour récupérer les noms d'actions de conversion lisibles par l'humain sans interroger la ressource conversion_action séparément. La requête suivante segmente les métriques de conversion lift par action de conversion, nom de l'action de conversion et catégorie de conversion :

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'

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.
  • START_DATE : date de début de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260501).
  • END_DATE : date de fin de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260515).

La requête suivante segmente les métriques de conversion lift par le segment segments.device. Remplacez le segment segments.age_range ou segments.gender dans des requêtes distinctes pour récupérer les répartitions démographiques (éventuellement combinées avec des segments de catégorie de conversion ou d'action de conversion) :

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'

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.
  • START_DATE : date de début de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260501).
  • END_DATE : date de fin de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260515).

Pour ventiler les résultats par zone géographique, incluez les segments segments.country et segments.country_localized_name (éventuellement combinés avec des segments de catégorie de conversion ou d'action de conversion). Le segment segments.country renvoie un nom de ressource de constante de ciblage géographique global au format geoTargetConstants/CRITERION_ID (par exemple, geoTargetConstants/2840 pour les États-Unis).

La requête suivante segmente les métriques de conversion lift par nom de ressource de critère de pays et par nom de pays localisé :

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'

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.
  • START_DATE : date de début de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260501).
  • END_DATE : date de fin de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260515).

Rapports sur les tests A/B et le conversion lift

Dans l'API Google Ads v25 et les versions ultérieures, les études A/B + Conversion Lift combinent un test à deux bras (comparant les stratégies de contrôle et de traitement) avec une mesure de retenue dans l'API Google Ads pour évaluer l'incrémentalité de chaque bras et calculer les scores bayésiens des gagnants. Contrairement aux rapports de test direct sur la ressource experiment, qui comparent les métriques de trafic non ajustées entre les bras, l'interrogation de la ressource lift_measurement_config avec le segment segments.experiment_arm mesure le lift incrémental de chaque bras par rapport à une référence de groupe d'exclusion non exposé.

Découvrir les tests et les groupes de test

Une étude A/B + Conversion Lift associe une ressource LiftMeasurementConfig à une ressource experiment à deux bras via le champ experiment.lift_measurement_config en lecture seule (OUTPUT_ONLY).

Pour découvrir le test associé et ses bras dans une seule requête, interrogez la ressource ExperimentArm avec les champs experiment attribués et filtrez sur le champ experiment.lift_measurement_config. La réponse inclut l'état de contrôle de chaque groupe (experiment_arm.control), la répartition du trafic (experiment_arm.traffic_split), les campagnes associées (experiment_arm.campaigns) et le nom de la ressource. Utilisez la valeur experiment_arm.resource_name renvoyée (au format customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID) pour filtrer sur le segment 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'

Remplacez les éléments suivants :

  • CUSTOMER_ID : numéro client à 10 chiffres du compte propriétaire de l'étude (sans tirets).
  • CONFIG_ID : ID entier de la configuration de mesure du lift.

Si vous commencez à partir d'un EXPERIMENT_ID connu (ou si vous souhaitez lister tous les tests avec lift activé dans le compte), exécutez la même requête experiment_arm filtrée par WHERE experiment.experiment_id = EXPERIMENT_ID (ou WHERE experiment.lift_measurement_config IS NOT NULL).

Interroger l'incrémentalité par bras et les scores des gagnants

Pour mesurer l'incrémentalité de chaque bras et évaluer la probabilité statistique qu'un bras soit le gagnant, incluez le segment segments.experiment_arm dans votre requête adressée à la ressource lift_measurement_config.

Les métriques de score bayésien du gagnant suivantes évaluent la probabilité (de 0.0 à 1.0, avec une somme de 1.0 pour les deux groupes lorsque les deux groupes présentent un impact positif à signaler) qu'un groupe donné soit supérieur :

  • metrics.incremental_conversions_winner_score : probabilité que ce bras soit le gagnant pour les conversions incrémentales, normalisée par la répartition du trafic du bras (experiment_arm.traffic_split).
  • metrics.incremental_conversion_value_winner_score : probabilité que ce bras soit le gagnant pour la valeur de conversion incrémentale, normalisée par la répartition du trafic du bras (experiment_arm.traffic_split). Dans l'API Google Ads v27 et les versions ultérieures, ce champ n'est renseigné que lorsque la métrique principale de l'étude est la valeur de conversion. Il est omis (non défini) dans les études dont la métrique principale est le nombre de conversions.
  • metrics.cost_per_incremental_conversion_winner_score : probabilité que ce bras soit le gagnant pour le coût par conversion incrémentale (CPA incrémental le plus bas), normalisé par les dépenses.
  • metrics.incremental_conversion_value_per_cost_winner_score : probabilité que ce groupe soit le gagnant pour la valeur de conversion incrémentale par coût (ROAS incrémental le plus élevé), normalisée par les dépenses. Dans l'API Google Ads v27 et les versions ultérieures, ce champ n'est renseigné que lorsque la métrique principale de l'étude est la valeur de conversion. Il est omis (non défini) dans les études dont la métrique principale est le nombre de conversions.

La requête suivante récupère l'incrémentalité par bras et les scores bayésiens du bras gagnant pour les deux bras :

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'

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.
  • START_DATE : date de début de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260501).
  • END_DATE : date de fin de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260515).

Pour filtrer un seul bras, ajoutez AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' à la clause WHERE, où EXPERIMENT_ID est l'ID du test et ARM_ID est l'ID du bras renvoyé dans le champ experiment_arm.resource_name. Le segment segments.experiment_arm est compatible avec le filtrage dans les clauses WHERE (=, !=, IN, NOT IN), mais vous ne pouvez pas trier les résultats en fonction de ce segment dans une clause ORDER BY.

Interpréter les résultats des tests A/B et de conversion lift

Une étude A/B + conversion lift évalue deux hypothèses simultanément : la supériorité d'un groupe par rapport à un autre (metrics.*_winner_score) et le lift causal par rapport au groupe de contrôle non exposé (metrics.incremental_* et *_p_value). Pendant qu'une étude ENABLED est en cours (STUDY_IN_PROGRESS_*, lorsque la date actuelle dans le fuseau horaire du client est antérieure ou égale à lift_measurement_flight.end_date), la comparaison directe des groupes et la modélisation des conversions du groupe de contrôle sont encore en cours de stabilisation. Considérez les métriques en cours comme préliminaires et évitez de promouvoir un groupe de test ou de réallouer des budgets avant la fin de la diffusion.

Dans les études terminées, un groupe de test est classé comme gagnant d'un test comparatif lorsqu'il atteint les seuils de précision minimaux (au moins quatre jours d'instantané, 65 conversions de référence non mises à l'échelle et 150 conversions exposées non mises à l'échelle), qu'il présente 0 <= p_value <= 0.50 et qu'il obtient un score de gagnant bayésien supérieur à 0.55 (> 0.55) pour la métrique principale de l'étude. Cette évaluation à double hypothèse produit deux états de gagnant distincts (également reflétés dans lift_guidance.outcome dans l'API Google Ads v27 et versions ultérieures) :

  • Gagnant incontestable avec un lift causal (AB_WINNER_WITH_LIFT) : le groupe gagnant surpasse le groupe concurrent (winner_score > 0.55) et génère des conversions incrémentales ou une valeur de conversion statistiquement significatives par rapport au groupe de contrôle non exposé. Promouvez ou faites évoluer la stratégie de la branche gagnante, et interrogez les répartitions dimensionnelles pour examiner les cohortes performantes.
  • Gagnant en comparaison directe à parité avec le groupe d'exclusion (AB_WINNER_PARITY_VS_CONTROL) : le bras gagnant surpasse le bras concurrent en comparaison directe (winner_score > 0.55), mais aucun des deux bras ne produit d'amélioration incrémentale statistiquement significative par rapport au groupe d'exclusion non exposé au niveau interrogé. Avant d'augmenter les dépenses sur le bras gagnant, interrogez les conversions ALL (segments.conversion_lift_included_conversion_action_types = 'ALL') et les répartitions segments.conversion_lift_conversion_category pour vérifier si l'amélioration causale positive a été isolée ailleurs.

Le résultat POSITIVE_LIFT_DETECTED s'applique aux différents niveaux de précision des requêtes de tests A/B et de conversion lift comme suit :

  • Lignes d'étude combinée (OVERALL) (requêtes sans segments.experiment_arm) : l'étude a généré un impact positif par rapport au groupe d'exclusion non exposé (p_value <= 0.50), et aucun bras n'a obtenu un score de vainqueur en confrontation directe supérieur à 0.55.
  • Lignes par bras (segments.experiment_arm) : lorsqu'un bras l'emporte (winner_score > 0.55) et que les deux bras obtiennent une amélioration positive par rapport au groupe de contrôle, la ligne du bras gagnant renvoie AB_WINNER_WITH_LIFT, tandis que la ligne du bras non gagnant renvoie POSITIVE_LIFT_DETECTED.
  • Lignes de segment de catégorie de conversion (segments.conversion_lift_conversion_category) : les lignes de conversion lift positif renvoient toujours POSITIVE_LIFT_DETECTED, car les scores gagnants ne sont pas évalués par catégorie de conversion.

Lorsqu'une tranche renvoie NOT_ENOUGH_DATA ou NO_SIGNIFICANT_LIFT, ne mettez pas en veille les bras et n'excluez pas les audiences en raison d'un échantillon insuffisant pour une seule tranche. Vérifiez les métriques globales de l'étude et les conversions ALL (segments.conversion_lift_included_conversion_action_types = 'ALL').

Interroger les résultats de plusieurs bras et de plusieurs études

Lorsque vous omettez le segment segments.experiment_arm d'une requête sur la ressource lift_measurement_config, l'API renvoie l'incrémentalité au niveau de l'étude, agrégée pour les deux bras combinés. Dans les requêtes de bras combinés, omettez les quatre métriques metrics.*_winner_score, qui ne s'appliquent qu'aux bras concurrents et sont omises (non définies) dans les lignes de bras combinés sans segments.experiment_arm. Utilisez les requêtes au niveau de l'étude dans Conversion lift et iCPA et Lift de la valeur de conversion et iROAS.

Lorsque vous segmentez les résultats des tests A/B et de conversion lift par le segment segments.experiment_arm, l'API n'accepte que le segment segments.conversion_lift_conversion_category comme dimension de répartition supplémentaire. Étant donné que les dépenses du groupe ne sont pas attribuées à des catégories de conversion individuelles, évaluez les métriques de conversion et de lift de la valeur de conversion (en omettant les métriques iCPA et iROAS, qui échouent à la validation de la requête avec une erreur QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE dans l'API Google Ads v27 et versions ultérieures) lorsque vous incluez le segment segments.conversion_lift_conversion_category. Les segments segments.conversion_action, segments.conversion_action_name, segments.age_range, segments.gender, segments.device, segments.country, segments.country_localized_name et segments.date ne sont pas compatibles avec le segment segments.experiment_arm et les métriques metrics.*_winner_score. Si vous sélectionnez l'un de ces segments incompatibles avec segments.experiment_arm, une erreur QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE est renvoyée (ainsi qu'une erreur QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE si la requête sélectionne également une métrique metrics.*_winner_score).

Pour récupérer les résultats de plusieurs configurations d'étude dans une seule requête, filtrez avec l'opérateur 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'

Remplacez les éléments suivants :

  • CONFIG_ID_1 : ID entier de la première configuration de mesure du lift.
  • CONFIG_ID_2 : ID entier de la deuxième configuration de mesure du lift.
  • START_DATE : date de début de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260501).
  • END_DATE : date de fin de l'instantané sous la forme d'un entier YYYYMMDD à huit chiffres sans guillemets (par exemple, 20260515).

L'égalité de date exacte (= START_DATE et = END_DATE) ne renvoie que les lignes des études qui partagent cette fenêtre d'instantané exacte. Lorsque vous interrogez des études avec des dates de début de diffusion ou des dates d'instantané évaluées différentes, filtrez avec des opérateurs de plage (>= et <=) ou omettez les filtres de date de la clause WHERE tout en conservant les segments segments.conversion_lift_start_date et segments.conversion_lift_end_date dans la clause SELECT.

Rapports sur le search lift

Pour mesurer l'augmentation du volume de requêtes de recherche naturelles générée par vos campagnes publicitaires dans l'API Google Ads v26 et versions ultérieures, interrogez les ressources de reporting Search Lift. Le search lift quantifie la différence de comportement de recherche pour votre marque ou vos produits entre les utilisateurs exposés à vos annonces et un groupe de contrôle non exposé.

Ressources et segmentation du search lift

Interrogez la ressource SearchLiftKeywordBundle pour récupérer des informations sur les groupes de mots clés configurés pour les études Search Lift. La ressource SearchLiftKeywordBundle est en lecture seule dans l'API Google Ads (tous les champs sont OUTPUT_ONLY). Les groupes de mots clés sont configurés dans l'interface utilisateur de Google Ads, ou par votre représentant Google ou votre contact GPS. Ses champs interrogeables dans GAQL sont resource_name, search_lift_keyword_bundle_id, source (SearchLiftMatchingInfoSource) et status (SearchLiftKeywordBundleStatus) (le champ répété keywords n'est pas sélectionnable dans les requêtes GAQL).

Interrogez la ressource LiftMeasurementConfig pour récupérer les métriques de search lift et les configurations d'étude globales.

Dans l'API Google Ads v27 et les versions ultérieures, vous pouvez également sélectionner le champ lift_measurement_config.lift_guidance en lecture seule (OUTPUT_ONLY) (lift_guidance.outcome et lift_guidance.guidance_message, de type LiftGuidance) dans la clause SELECT GAQL sur lift_measurement_config lorsque vous interrogez des métriques ou des segments Search Lift (segments.search_lift_keyword_bundle ou segments.search_property). Sur lift_measurement_config, lift_guidance est omis dans les requêtes de configuration de métadonnées uniquement, et lift_guidance.guidance_message peut contenir des liens Markdown intégrés (comme [Learn more](https://support.google.com/...)). Pour Search Lift, lift_guidance.outcome renvoie STUDY_IN_PROGRESS_WITH_LIFT, STUDY_IN_PROGRESS_NO_LIFT_YET, STUDY_IN_PROGRESS_COLLECTING_DATA, POSITIVE_LIFT_DETECTED (certitude d'au moins 70 %, p_value <= 0.30), NO_SIGNIFICANT_LIFT ou NOT_ENOUGH_DATA (évalué par rapport à des seuils d'au moins 1 000 000 d'impressions globales ou 100 000 impressions de tranche, au moins 75 recherches observées et au moins 17 buckets de cookies sur 20, où un seul groupe de mots clés sous-performant entraîne l'affichage de NOT_ENOUGH_DATA dans les résultats globaux de l'étude).

Segmentez les performances du search lift selon les dimensions suivantes :

  • segments.search_lift_keyword_bundle : segmenter par nom de ressource du groupe de mots clés. Compatible avec les segments segments.search_property, segments.date et démographiques (segments.device, segments.age_range et segments.gender). Chaque groupe de mots clés indique le coût total et les impressions de la campagne, et les mots clés peuvent appartenir à plusieurs groupes. Ne faites pas la somme des métriques metrics.search_lift_cost_micros, metrics.search_lift_impressions ou de search lift pour les groupes de mots clés.
  • segments.search_property : segmenter par propriété de recherche où la recherche a eu lieu, définie par l'énumération SearchLiftSearchProperty (par exemple, GOOGLE_SEARCH ou YOUTUBE). Le segment segments.search_property n'est compatible qu'avec les segments segments.search_lift_keyword_bundle et segments.date. La combinaison de segments.search_property avec des segments démographiques (segments.device, segments.age_range ou segments.gender) échoue à la validation de la requête. Étant donné que segments.search_property partitionne les recherches naturelles ultérieures plutôt que les annonces diffusées, les lignes segmentées par segments.search_property répètent les coûts et les impressions non partitionnés au niveau de la campagne dans l'API Google Ads v26. À partir de la version 27 de l'API Google Ads, les huit métriques de dépenses et d'impressions (metrics.search_lift_cost_micros, metrics.search_lift_impressions, metrics.normalized_incremental_searches_per_cost* et metrics.normalized_incremental_searches_per_impression*) sont incompatibles avec segments.search_property et échouent à la validation de la requête avec une erreur QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.
  • Segments démographiques et de date : segments.device, segments.age_range, segments.gender et segments.date.

Métriques search lift

La ressource LiftMeasurementConfig fournit des métriques de search lift pour évaluer les changements de comportement de recherche :

  • metrics.relative_search_lift : différence de volume de requêtes de recherche entre le groupe exposé et le groupe de contrôle, exprimée sous forme de fraction des requêtes de recherche dans le groupe de contrôle.
  • metrics.relative_search_lift_p90_lower_bound et metrics.relative_search_lift_p90_upper_bound : limites de confiance unilatérales de 90 % (qui forment ensemble un intervalle de confiance bilatéral de 80 %) pour le search lift relatif.
  • metrics.incremental_searches_p_value : valeur p pour les recherches incrémentales, représentant la probabilité statistique que l'augmentation observée des requêtes de recherche se soit produite par hasard.
  • metrics.search_lift_cost_micros : coût total (en micros) des impressions d'annonces diffusées pour cette tranche de mesure du search lift. Incompatible avec segments.search_property dans l'API Google Ads v27 et versions ultérieures.
  • metrics.search_lift_impressions : nombre total d'impressions d'annonces diffusées pour cette tranche de mesure du search lift. Incompatible avec segments.search_property dans l'API Google Ads v27 et versions ultérieures.

Les métriques incrémentales normalisées suivantes, ainsi que leurs limites de confiance unilatérales de 90 % correspondantes (*_p90_lower_bound et *_p90_upper_bound), sont signalées lorsque l'impact est statistiquement positif :

Exemples de requêtes search lift

Les requêtes GAQL suivantes montrent comment récupérer les groupes de mots clés et les métriques de performances du search lift.

Requête de groupe de mots clés

Pour récupérer les groupes de mots clés configurés pour les mesures du search lift, interrogez la ressource 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

Requête de métriques

Les valeurs search_lift_keyword_bundle.resource_name récupérées dans la requête de groupe de mots clés correspondent aux valeurs renvoyées dans le segment segments.search_lift_keyword_bundle de la requête suivante. Pour découvrir l'CONFIG_ID, les campagnes associées et le calendrier de diffusion de votre étude, suivez les instructions de la section Découvrir les configurations d'étude et les diffusions sur les ressources lift_measurement_config et lift_measurement_flight (en filtrant les diffusions par lift_measurement_flight.lift_type = 'SEARCH').

La requête suivante récupère les métriques de search lift segmentées par groupe de mots clés et propriété de recherche (omettez segments.search_property lorsque vous sélectionnez 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

Remplacez les éléments suivants :

  • CONFIG_ID : ID entier de la configuration de mesure du lift.