提升效果报告

如需衡量广告系列对品牌认知度、转化次数、转化价值和自然搜索行为的因果影响，请在 Google Ads API 中查询提升效果评测报告资源：

  • 品牌提升效果报告：在 Google Ads API v25 及更高版本中，评估广告曝光时间对所调查衡量类型中品牌认知的影响。
  • 转化量提升情况报告：在 Google Ads API v25 及更高版本中，针对未接触广告的对照组，衡量增量转化次数、转化价值、每次增量转化费用 (iCPA) 和增量广告支出回报率 (iROAS)，包括：
  • 搜索次数提升情况报告：在 Google Ads API v26 及更高版本中，量化广告曝光在 Google 搜索和 YouTube 上带来的自然搜索查询量增幅。

如需了解 experiment 和 campaign 资源的标准 A/B 实验报告，请参阅实验报告。

品牌提升效果报告

如需评估广告系列对品牌认知度的影响，请在 Google Ads API v25 及更高版本中查询专用的品牌提升效果评测资源。

品牌提升效果资源和细分视图

品牌提升效果配置、排期和细分视图在 Google Ads API 中为只读（所有字段均为 OUTPUT_ONLY），并且是在 Google Ads 界面中或通过 Google 代表或 GPS 联系人进行配置。使用拥有该研究的账号（经理账号或子账号）的 customer_id 参数查询这些资源。

查询 LiftMeasurementFlight 资源，以检索排期级品牌提升效果排期和调查问卷收集元数据，包括排期状态（lift_measurement_flight.status，由 LiftMeasurementFlightStatus 枚举定义，其值为 ENABLED 表示有效排期，STOPPED 表示手动停止的排期）、客户时区中的排期日期范围（lift_measurement_flight.start_date 和 lift_measurement_flight.end_date），以及目标调查问卷回复收集进度（lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros，其中 0 等于 0%，1000000 等于 100%）。如需确定 ENABLED 投放期是正在进行中还是已完成，请将客户时区的当前日期与 lift_measurement_flight.start_date 和 lift_measurement_flight.end_date 进行比较，并检查 response_collection_ratio_micros 是否已达到 1000000。

查询 LiftMeasurementConfig 资源以检索总体研究级品牌提升效果指标，或查询以下细分资源以分析特定维度的品牌提升效果指标：

添加 segments.brand_lift_measurement_type 细分，以按调查问题类型（由 BrandLiftMeasurementType 枚举定义，例如 RECALL 或 AWARENESS）细分品牌提升效果指标。如果您省略 segments.brand_lift_measurement_type 细分，API 会为每个切片返回单个自动选择的评测类型的指标。添加 segments.date 细分，以按日期 (YYYY-MM-DD) 细分品牌提升效果指标。metrics.cost_per_lifted_cookie 指标以拥有该调查的账号所用币种的微单位返回。

在 Google Ads API v27 及更高版本中，您还可以在 lift_measurement_config 和五个品牌提升效果细分资源（lift_measurement_age_range、lift_measurement_campaign、lift_measurement_device、lift_measurement_gender 和 lift_measurement_video）的 Google Ads 查询语言 (GAQL) SELECT 子句中选择只读 (OUTPUT_ONLY) lift_guidance 字段（lift_guidance.outcome 和 lift_guidance.guidance_message，类型为 LiftGuidance），以接收行级统计解读。在 lift_measurement_config 中，仅当查询还选择或过滤提升效果指标或细分时，才会填充 lift_guidance（在仅元数据配置查询中会省略），并且 lift_guidance.guidance_message 可以包含内嵌 Markdown 链接（例如 [Learn more](https://support.google.com/...)）。您无法在 WHERE 或 ORDER BY 子句中对 lift_guidance 子字段进行过滤或排序。如需了解 lift_guidance.outcome 中返回的 LiftOutcomeEnum.LiftOutcome 值的说明，请参阅解读品牌提升效果。

报告阈值和空响应

品牌提升效果报告既有延迟限制（研究开始后需要 24-48 小时的流水线延迟），也有回复限制（每个受访评测类型 [segments.brand_lift_measurement_type] 都有回复限制），以满足统计可报告性和隐私权阈值：

  • 正面回复率（metrics.brand_lift_baseline_positive_response_rate*和metrics.brand_lift_exposed_positive_response_rate*）：相应组（实验组或对照组）中至少有 50 份调查问卷回复。
  • 严格的正向升幅阈值（LiftMeasurementConfig的整体研究或独立切片）：统计学上的正向升幅 (p_value <= 0.50)，总回复数至少为 2,000，每个组的回复数至少为 860。
  • 宽松的细分正向提升阈值（当整体研究满足严格阈值且具有正向提升时，在细分资源上）：统计学上的正向提升 (p_value <= 0.50)，总回复数至少为 500，每个组的回复数至少为 200。
  • 达到非正向提升幅度阈值（NO_SIGNIFICANT_LIFT 与 NOT_ENOUGH_DATA）：如果未检测到具有统计显著性的正向提升幅度，则每个指标至少需要 4,100 个总回复。

在以下情况下，对 LiftMeasurementConfig 和五个品牌提升效果细分资源（LiftMeasurementAgeRange、LiftMeasurementGender、LiftMeasurementDevice、LiftMeasurementCampaign 和 LiftMeasurementVideo）的查询会返回空响应 (results: [])，而不是错误：

  • 查询的 customer_id 参数不在许可清单中，或者不拥有该研究。
  • WHERE 日期过滤条件不在评估的排期（lift_measurement_flight.start_date和lift_measurement_flight.end_date）内。
  • 即使 LiftMeasurementConfig 返回了总体研究结果，该研究或特定受众特征、设备、广告系列或视频切片也未达到 24-48 小时的报告延迟和调查问卷回复量阈值。

如需排查空响应问题，请完成以下步骤：

  1. 查询 lift_measurement_flight 以验证 lift_measurement_flight.status = 'ENABLED'，检查 WHERE 日期过滤条件是否在 lift_measurement_flight.start_date 和 lift_measurement_flight.end_date 之间，并在 lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros 中检查调查问卷进度（其中 1000000 等于 100%）。
  2. 在查询维度细分资源之前，请先查询 LiftMeasurementConfig，以确认整体研究是否已生成可报告的品牌提升效果指标。

解读品牌提升效果

在 Google Ads API v27 及更高版本中，lift_guidance.outcome 字段会返回一个 LiftOutcomeEnum.LiftOutcome 值，用于对每个返回行的统计状态进行分类，并在 lift_guidance.guidance_message 中提供人类可读的修复建议：

  • 正在进行的研究结果（当 lift_measurement_flight.status 为 ENABLED 且客户时区的当前日期不晚于 lift_measurement_flight.end_date，且 lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros 小于 1000000 时）：
    • STUDY_IN_PROGRESS_WITH_LIFT：研究正在进行中，初步结果显示提升效果良好。
    • STUDY_IN_PROGRESS_NO_LIFT_YET：研究正在进行中，初始数据量充足，但尚未检测到具有统计显著性的提升效果。
    • STUDY_IN_PROGRESS_COLLECTING_DATA：研究正在进行中，并且正在积极收集初始调查问卷回复，以达到统计报告阈值。
  • 已完成的研究结果（当 lift_measurement_flight.end_date 已过或 lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros 已达到 1000000 时）：
    • POSITIVE_LIFT_DETECTED：检测到已完成的研究或切片具有统计显著性的正向提升。
    • NO_SIGNIFICANT_LIFT：已完成的研究或切片达到了统计精确度阈值（每个指标至少有 4,100 个总回复），但未检测到具有统计显著性的正向提升。
    • NOT_ENOUGH_DATA：已完成的研究或细分未达到统计报告所需的调查问卷回复数量阈值（对于整体研究的正面提升，总回复数至少为 2,000 个，每个组的回复数至少为 860 个；对于整体研究有正面提升时细分的正面提升，总回复数至少为 500 个，每个组的回复数至少为 200 个；如果未检测到正面提升，则每个指标的总回复数至少为 4,100 个）。

在解读品牌提升效果时，请遵循以下准则：

  • 正在进行的排期与已完成的排期 (STUDY_IN_PROGRESS_*)：当ENABLED研究排期仍在进行中（lift_measurement_flight.end_date尚未过去，且response_collection_ratio_micros尚未达到 1000000）时，调查问卷回复和偏差校正模型仍在稳定中。请将进行中的指标视为初步指标，并避免在投放期结束前暂停广告系列或减少预算。
  • 正向提升 (POSITIVE_LIFT_DETECTED)：检测到正向品牌提升效果时，查询维度细分资源（LiftMeasurementAgeRange、LiftMeasurementGender、LiftMeasurementDevice、LiftMeasurementCampaign 和 LiftMeasurementVideo），以找出效果出色的受众群体同类群组（“亮点”），并评估广告内容在整个品牌漏斗中的共鸣度。
  • 数据不足或没有显著提升（NOT_ENOUGH_DATA或NO_SIGNIFICANT_LIFT）：如果调查问卷回复量不足（每个指标的总回复数少于 4,100 个且没有正向提升，或者少于 2,000/860 个严格切片阈值或 500/200 个宽松切片阈值且有正向提升），或者在某个切片上未检测到具有统计显著性的提升，请勿将其视为广告系列失败，也不要因为单个切片样本不足而排除受众群体。查看 LiftMeasurementConfig 的总体研究指标，查询其他受访 segments.brand_lift_measurement_type 值（例如漏斗上端的 RECALL 或 AWARENESS），并查看其余细分维度。

品牌提升效果查询示例

由于排期元数据和升幅统计信息位于不同的资源中，因此查询排期详情和效果统计信息需要使用不同的 GAQL 查询。

航班详情查询

如需检索品牌提升排期的元数据（例如其状态、评测类型、预定日期和问卷调查收集进度），请查询 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'

替换以下内容：

  • CONFIG_ID：提升效果评测配置 (lift_measurement_config.lift_measurement_config_id) 的整数 ID。

统计信息查询

如需检索品牌提升效果指标，请查询 LiftMeasurementConfig 资源或适当的细分资源。例如，以下查询会从 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

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。

转化量提升情况报告

在 Google Ads API v25 及更高版本中，转化量提升情况报告可衡量广告对转化次数和转化价值的增量影响。转化量提升情况研究会比较实验组（符合广告展示条件的用户）和未实验对照组（未看到广告的用户）之间的转化行为。

转化量提升情况配置、排期和实验链接在 Google Ads API 中为只读（所有字段均为 OUTPUT_ONLY），可在 Google Ads 界面中配置，也可通过 Google 代表或 GPS 联系人进行配置。使用拥有研究的账号的 customer_id 参数查询 lift_measurement_config 资源。经理账号可以直接查询其拥有的跨账号转化量提升情况研究。使用子账号的 customer_id 参数（可选择使用 login-customer-id 标头进行身份验证）查询子账号拥有的研究。

转化量提升情况报告支持两种研究工作流，这两种工作流具有相同的研究和排期发现、累积快照日期范围以及转化操作范围：

  • 独立转化量提升情况报告：针对研究中被评测广告系列的所有转化操作或所选转化操作，评测总体增量、每次增量转化费用 (iCPA) 和增量广告支出回报率 (iROAS)。
  • A/B 测试 + 转化量提升情况报告：衡量两个竞争实验组（对照组与实验组）之间的每个实验组增量和贝叶斯胜出者得分，以及总体研究增量。

如需在构建针对 lift_measurement_config 资源的有效查询方面获得帮助，请使用 Google Ads 查询构建器工具。

在 Google Ads API v27 及更高版本中，您可以在 lift_measurement_config 的 GAQL SELECT 子句中选择只读 (OUTPUT_ONLY) lift_measurement_config.lift_guidance 字段（lift_guidance.outcome 和 lift_guidance.guidance_message，类型为 LiftGuidance），以接收独立转化量提升情况和 A/B + 转化量提升情况查询的行级统计解释。 在 lift_measurement_config 中，仅当查询还选择或过滤提升效果指标或细分时，系统才会填充 lift_guidance（在仅元数据配置查询中会省略），并且 lift_guidance.guidance_message 可以包含内嵌 Markdown 链接（例如 [Learn more](https://support.google.com/...)）。您无法在 WHERE 或 ORDER BY 子句中对 lift_guidance 子字段进行过滤或排序。lift_guidance.outcome 字段会返回以下 LiftOutcomeEnum.LiftOutcome 值之一：

  • 正在进行的研究结果（当 lift_measurement_flight.status 为 ENABLED 且客户时区的当前日期不晚于 lift_measurement_flight.end_date 时）：
    • STUDY_IN_PROGRESS_WITH_LIFT：研究正在进行中，初步结果显示提升效果良好。
    • STUDY_IN_PROGRESS_NO_LIFT_YET：研究正在进行中，初始数据量充足，但尚未检测到具有统计显著性的提升效果。
    • STUDY_IN_PROGRESS_COLLECTING_DATA：研究正在进行中，并且正在积极收集初始转化数据，以达到统计报告阈值。
  • 已完成的研究结果（lift_measurement_flight.end_date过后）：
    • POSITIVE_LIFT_DETECTED：对于已完成的研究、实验组或切片，检测到具有统计显著性的正向提升。
    • AB_WINNER_WITH_LIFT：一项 A/B + 转化量提升情况研究已完成，其中一个实验组在正面交锋中胜出，并且与未接触广告的对照组相比，转化量提升幅度具有统计显著性。
    • AB_WINNER_PARITY_VS_CONTROL：A/B + 转化量提升情况研究已完成，其中一个实验组在正面交锋中胜出，但与未接触广告的对照组相比，效果相当。
    • NO_SIGNIFICANT_LIFT：已完成的研究、实验组或切片达到了统计精确度阈值，但未检测到具有统计显著性的正向提升。
    • NOT_ENOUGH_DATA：已完成的研究、实验组或切片未累积足够的转化次数，无法达到统计精确度阈值。

探索研究配置和实验

如需生成转化量提升情况研究报告，请先了解研究配置及其投放时间安排：

  1. 检索研究配置：查询 LiftMeasurementConfig 资源，以检索研究的名称、对照组比例 (lift_measurement_config.conversion_lift_holdback_ratio_micros)、跟踪的转化操作 (lift_measurement_config.conversion_actions)，以及（在 Google Ads API v26 及更高版本中）主动关联的广告系列 (lift_measurement_config.campaigns)。conversion_lift_holdback_ratio_micros 字段以微为单位表示，其中 1,000,000 等于 100%（例如，300000 表示 30% 的未曝光对照组）。如果您不知道研究的 CONFIG_ID，请省略 WHERE 子句，以列出账号中的所有研究配置。
  2. 检索航班观察窗口：查询 LiftMeasurementFlight 资源，以查找客户所在时区的预定航班日期（lift_measurement_flight.start_date 和 lift_measurement_flight.end_date）。由于单个 LiftMeasurementConfig 资源可以对品牌提升效果 (SURVEY)、转化量提升情况 (CONVERSION) 和搜索次数提升情况 (SEARCH) 排期进行分组，因此请在 SELECT 子句中添加 lift_measurement_flight.lift_type 字段，并在 WHERE 子句中按 lift_measurement_flight.lift_type = 'CONVERSION' 进行过滤。 lift_measurement_flight.start_date 和 lift_measurement_flight.end_date 字段可在 ORDER BY 子句中排序，但您无法在 WHERE 子句中对它们进行过滤。

以下查询会检索研究配置（在 Google Ads API v25 中省略 lift_measurement_config.campaigns 字段，因为该字段需要 Google Ads API v26 及更高版本）：

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

替换以下内容：

  • CONFIG_ID：提升效果评测配置 (lift_measurement_config.lift_measurement_config_id) 的整数 ID。

以下查询会检索研究的转化量提升情况排期：

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'

替换以下内容：

  • CONFIG_ID：提升效果评测配置 (lift_measurement_config.lift_measurement_config_id) 的整数 ID。

在 Google Ads API v26 及更高版本中，您还可以通过查询 campaign.lift_measurement_config 字段，直接从 campaign 资源中发现与广告系列关联的提升效果评测配置。查询此字段可避免单独交叉对比 LiftMeasurementConfig 资源：

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

替换以下内容：

  • CAMPAIGN_ID：广告系列的整数 ID (campaign.id)。

campaign.lift_measurement_config 字段会返回格式为 customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID 的资源名称。如果广告系列参与了多项提升效果研究，此字段会标识最近关联的配置（有效或无效）。相比之下，lift_measurement_config.campaigns 字段仅列出已建立有效关联的广告系列。

查询累积快照日期范围

转化量提升情况结果采用每日累计评估快照的形式，从广告投放期的开始日期算起：

segments.conversion_lift_start_date 和 segments.conversion_lift_end_date 都是 INT64 字段，格式为不带引号的 8 位整数，不带连字符，采用 YYYYMMDD 格式（例如 20260501）。相比之下，lift_measurement_flight.start_date 和 lift_measurement_flight.end_date 字段返回采用 ISO 8601 YYYY-MM-DD 格式的日期字符串（例如 2026-05-01）。与品牌提升效果和搜索次数提升情况查询不同，segments.date 细分维度与所有转化量提升情况指标和细分维度都不兼容。在 SELECT 子句中同时选择 segments.date 细分和转化量提升情况细分（例如 segments.conversion_lift_start_date）会返回 QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE 错误，而将 segments.date 与转化量提升情况指标结合使用会返回 QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE 错误。

在处理数据时，最新计算的快照可能会滞后于有效排期的结束日期。始终查询 lift_measurement_config 资源，以获取按 segments.conversion_lift_end_date DESC 排序的可用 (segments.conversion_lift_start_date, segments.conversion_lift_end_date) 对，从而首先确定最近评估的快照。

以下查询会检索研究的可用快照日期范围：

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

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。

按转化操作范围过滤

转化量提升情况评测会评估由 segments.conversion_lift_included_conversion_action_types 细分定义的两个范围内的增量效果：

  • SELECTED：在研究设置期间选择的转化操作，或者所有可出价（主要）转化操作（如果未指定自定义转化操作）。
  • ALL：研究中衡量的广告系列的所有转化操作。

如果您在查询 lift_measurement_config 资源以获取转化量提升情况指标时，未按 segments.conversion_lift_included_conversion_action_types 细分进行过滤，则 API 会为每个切片返回两行，一行对应 ALL，另一行对应 SELECTED。在 GAQL 中，在 WHERE 子句中过滤的任何非日期细分字段（以及任何转化量提升情况快照日期细分）也必须出现在 SELECT 子句中。否则，API 会返回 QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE 错误。在 WHERE 子句中按 segments.conversion_lift_included_conversion_action_types = 'SELECTED' 过滤时，请在 SELECT 子句中包含该细分。

独立的转化量提升情况报告

独立转化量提升情况研究会衡量广告相对于未接触广告的对照组的增量影响，而无需将广告系列拆分为相互竞争的实验组。

查询转化量提升情况和 iCPA

转化量提升情况报告会提供点估计值以及 90% 单侧置信界限（*_p90_lower_bound 和 *_p90_upper_bound，两者共同构成 80% 双侧置信区间）和 p 值（p_value <= 0.10 对应于 90% 单侧统计显著性）：

在以下情况下，API 会省略返回行中的转化量提升情况指标：

  • 包含性快照窗口期少于 4 天。
  • 未按比例放大的观测到的转化量低于最低精确度阈值（在按比例放大 metrics.conversion_lift_baseline_conversions 之前进行评估，对照组中观测到的基准转化次数少于 65 次，或观测到的实验组转化次数少于 150 次）。
  • 测得的升幅不为正（转化指标为 metrics.incremental_conversions_p_value > 0.5，转化价值指标为 metrics.incremental_conversion_value_p_value > 0.5）。
  • 在 Google Ads API v27 及更高版本中，如果研究在设置期间配置为以转化次数而非转化价值作为主要指标，则可以查询该研究的 iROAS 指标 (metrics.incremental_conversion_value_per_cost*) 和转化价值胜出者得分指标（metrics.incremental_conversion_value_winner_score 和 metrics.incremental_conversion_value_per_cost_winner_score）。只要转化价值提升情况可报告，非费用转化价值指标（metrics.conversion_lift_baseline_conversion_value、metrics.conversion_lift_exposed_conversion_value、metrics.incremental_conversion_value* 和 metrics.relative_conversion_value_lift*）就会继续在以转化次数为主要指标的研究中填充。
  • 由于您从 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 字段，因此系统会汇总多行或多项研究。

在解读独立转化量提升情况研究结果时，请遵循以下准则：

  • 正在进行的排期与已完成的排期 (STUDY_IN_PROGRESS_*)：当 ENABLED 调研排期仍在进行中（客户时区的当前日期在 lift_measurement_flight.end_date当天或之前）时，基准组和实验组的根据模型估算转化和延迟转化归因仍在稳定中。将进行中的指标视为初步指标，在排期结束前避免暂停广告系列或减少预算。
  • 正向转化量提升幅度 (POSITIVE_LIFT_DETECTED)：只要测得的转化量提升幅度为正（p_value <= 0.50，对应于至少 50% 的确定性，且点估计值为正，而 p_value <= 0.10 表示 90% 的单侧统计显著性，其中 *_p90_lower_bound >= 0），并且满足最低精确度阈值（至少 4 个快照日、至少 65 次未扩缩的基准转化和至少 150 次未扩缩的实验组转化），就会触发转化量提升指标的可报告性和 lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED'。检测到正向提升效果后，查询维度细分（受众特征、设备、国家/地区或转化类别和转化操作），以找出效果出色的同类群组（“亮点”）。
  • 数据不足或提升效果不显著（NOT_ENOUGH_DATA 或 NO_SIGNIFICANT_LIFT）：如果数据量不足（未缩放的基准组转化次数少于 65 次，或未缩放的实验组转化次数少于 150 次），或者在某个切片上未检测到具有统计显著性的提升效果，请勿将其视为广告系列失败，也不要因为单个切片的样本不足而排除受众群体。检查总体研究指标并查询 segments.conversion_lift_included_conversion_action_types = 'ALL'（如果 SELECTED 显示没有提升）或其余维度细分，以验证是否在其他地方单独存在正向提升。

以下查询会检索总体转化增量、置信度边界和 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'

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。
  • START_DATE：快照开始日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260501）。
  • END_DATE：快照结束日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260515）。

查询转化价值提升幅度和 iROAS

如需评估广告支出带来的增量收入，请查询转化价值指标和 metrics.incremental_conversion_value_per_cost 指标。只要研究具有可报告的转化价值提升幅度，无论研究的主要指标是转化次数还是转化价值，系统都会填充非费用转化价值指标（metrics.conversion_lift_baseline_conversion_value、metrics.conversion_lift_exposed_conversion_value、metrics.incremental_conversion_value* 和 metrics.relative_conversion_value_lift*）。在 Google Ads API v27 及更高版本中，只有在设置期间将研究配置为以转化价值作为主要指标时，系统才会返回 iROAS 指标 (metrics.incremental_conversion_value_per_cost*) 以及 metrics.incremental_conversion_value_winner_score 和 metrics.incremental_conversion_value_per_cost_winner_score（在以转化次数为主要指标的研究中，这些指标会被忽略）：

以下查询会检索转化价值增量、置信度边界和 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'

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。
  • START_DATE：快照开始日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260501）。
  • END_DATE：快照结束日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260515）。

按维度细分结果

按转化类别、转化操作、受众特征、设备或地理位置细分增量转化指标。查询 lift_measurement_config 资源时，请仅选择兼容的细分组合：

在 SELECT 子句中选择不兼容的细分会导致查询验证失败，并返回 QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE 错误。使用 Google Ads 查询构建器以交互方式验证细分组合。

仅针对总体研究行或 segments.experiment_arm 行评估成本效益指标（metrics.cost_per_incremental_conversion* 和 metrics.incremental_conversion_value_per_cost*）。在 Google Ads API v25 和 v26 中，架构允许选择六个费用比率指标（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 和 metrics.incremental_conversion_value_per_cost_p90_upper_bound）以及八个非实验组细分（segments.conversion_action、segments.conversion_action_name、segments.conversion_lift_conversion_category、segments.age_range、segments.gender、segments.device、segments.country 和 segments.country_localized_name）。从 Google Ads API v27 开始，选择这六个费用比率指标中的任何一个以及这八个非实验组细分中的任何一个都会导致查询验证失败，并返回 QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE 错误。 只要可以报告转化价值提升情况（无论研究的主要指标是转化次数还是转化价值），转化类别、转化操作、受众特征、设备和国家/地区细分维度就仍支持非费用转化价值指标（metrics.conversion_lift_baseline_conversion_value、metrics.conversion_lift_exposed_conversion_value、metrics.incremental_conversion_value* 和 metrics.relative_conversion_value_lift*）。

如需评估 ConversionActionCategory 枚举中定义的转化类别（例如 PURCHASE、SIGNUP 或 SUBMIT_LEAD_FORM）的提升效果，请按 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'

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。
  • START_DATE：快照开始日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260501）。
  • END_DATE：快照结束日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260515）。

segments.conversion_action 细分会返回格式为 customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID 的转化操作资源名称。选择 lift_measurement_config 资源上的 segments.conversion_action_name 段，以检索人类可读的转化操作名称，而无需单独查询 conversion_action 资源。以下查询按转化操作、转化操作名称和转化类别细分转化量提升情况指标：

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'

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。
  • START_DATE：快照开始日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260501）。
  • END_DATE：快照结束日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260515）。

以下查询按 segments.device 细分来细分转化量提升情况指标。在单独的请求中替换 segments.age_range 或 segments.gender 细分，以检索受众特征细分（可选择与转化类别或转化操作细分结合使用）：

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'

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。
  • START_DATE：快照开始日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260501）。
  • END_DATE：快照结束日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260515）。

如需按地理位置细分结果，请添加 segments.country 和 segments.country_localized_name 细分（可选择与转化类别或转化操作细分结合使用）。segments.country 细分受众群会返回一个全球地理位置定位目标常量资源名称，格式为 geoTargetConstants/CRITERION_ID（例如，美国的资源名称为 geoTargetConstants/2840）。

以下查询会按国家/地区条件资源名称和本地化国家/地区名称细分转化量提升情况指标：

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'

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。
  • START_DATE：快照开始日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260501）。
  • END_DATE：快照结束日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260515）。

A/B + 转化量提升情况报告

在 Google Ads API v25 及更高版本中，A/B 测试 + 转化量提升情况研究将双组实验（比较对照策略与实验策略）与 Google Ads API 中的留空组评测相结合，以评估各个组的增量并计算贝叶斯胜出者得分。experiment 资源上的直接实验报告会比较未经调整的组间流量指标，而使用 segments.experiment_arm 细分查询 lift_measurement_config 资源则会衡量每个组相对于未公开的对照组基准的增量提升效果。

探索实验和实验组

A/B + 转化量提升情况研究通过只读 (OUTPUT_ONLY) experiment.lift_measurement_config 字段将 LiftMeasurementConfig 资源关联到双组 experiment 资源。

如需在单个请求中发现关联的实验及其变体组，请查询具有归因 experiment 字段的 ExperimentArm 资源，并对 experiment.lift_measurement_config 字段进行过滤。响应中包含每个实验组的对照状态 (experiment_arm.control)、流量分配 (experiment_arm.traffic_split)、关联的广告系列 (experiment_arm.campaigns) 和资源名称。 使用返回的 experiment_arm.resource_name 值（格式为 customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID）过滤 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'

替换以下内容：

  • CUSTOMER_ID：拥有该研究的账号的 10 位数客户 ID（不含连字符）。
  • CONFIG_ID：提升效果评测配置的整数 ID。

如果您从已知的 EXPERIMENT_ID 开始（或想要列出账号中所有启用了提升效果评测的实验），请运行相同的 experiment_arm 查询，并按 WHERE experiment.experiment_id = EXPERIMENT_ID（或 WHERE experiment.lift_measurement_config IS NOT NULL）进行过滤。

查询每个实验组的增量和胜出者得分

如需衡量每个组的增量并评估某个组胜出的统计概率，请在对 lift_measurement_config 资源的查询中添加 segments.experiment_arm 细分。

以下贝叶斯胜出者得分指标用于评估给定实验组更优的概率（从 0.0 到 1.0，当两个实验组都有可报告的正向升幅时，两个实验组的概率之和为 1.0）：

  • metrics.incremental_conversions_winner_score：此实验组在增量转化方面胜出的概率，按实验组流量分配 (experiment_arm.traffic_split) 进行归一化。
  • metrics.incremental_conversion_value_winner_score：此实验组在增量转化价值方面胜出的概率，按实验组流量分配 (experiment_arm.traffic_split) 进行归一化。在 Google Ads API v27 及更高版本中，仅当研究的主要指标是转化价值时，系统才会填充此字段，而在以转化次数为主要指标的研究中，系统会省略此字段（不设置）。
  • metrics.cost_per_incremental_conversion_winner_score：此实验组在每次增量转化费用（最低 iCPA）方面胜出的概率，按支出进行了归一化。
  • metrics.incremental_conversion_value_per_cost_winner_score：此实验组在单位费用增量转化价值（最高 iROAS）方面胜出的概率，按支出进行了标准化。在 Google Ads API v27 及更高版本中，仅当研究的主要指标是转化价值时才会填充，在以转化次数为主要指标的研究中则会省略（不设置）。

以下查询会检索两个实验组的每个实验组增量和贝叶斯胜出者得分：

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'

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。
  • START_DATE：快照开始日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260501）。
  • END_DATE：快照结束日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260515）。

如需过滤出单个实验组，请将 AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' 添加到 WHERE 子句中，其中 EXPERIMENT_ID 是实验 ID，ARM_ID 是 experiment_arm.resource_name 字段中返回的实验组 ID。segments.experiment_arm 细分支持在 WHERE 子句（=、!=、IN、NOT IN）中进行过滤，但您无法在 ORDER BY 子句中对其进行排序。

解读 A/B + 转化量提升情况结果

A/B + 转化量提升情况研究会同时评估两个假设：组间直接对比优势 (metrics.*_winner_score) 以及相对于未接触广告的对照组的因果提升情况（metrics.incremental_* 和 *_p_value）。当 ENABLED 研究排期仍在进行中（STUDY_IN_PROGRESS_*，即客户时区的当前日期在 lift_measurement_flight.end_date 当天或之前）时，组间直接对比和对照组根据模型估算转化仍在稳定中。请将进行中的指标视为初步指标，并避免在投放期结束之前推广实验组或重新分配预算。

在已完成的研究中，如果实验组满足最低精确度阈值（至少 4 个快照日、65 次未缩放的基准转化和 150 次未缩放的实验组转化），具有 0 <= p_value <= 0.50，并且在研究的主要指标上取得的贝叶斯胜出者得分高于 0.55 (> 0.55)，则该实验组会被归类为正面交锋胜出者。这种双重假设评估会产生两种不同的胜出状态（在 Google Ads API v27 及更高版本中，lift_guidance.outcome 也会反映这两种状态）：

  • 具有因果提升效果的明显胜出组 (AB_WINNER_WITH_LIFT)：胜出组在直接对比中表现优于竞争组 (winner_score > 0.55)，并且与未接触广告的对照组相比，产生了具有统计显著性的增量转化次数或转化价值。推广或扩大胜出组的策略，并查询维度细分数据，以查看效果出色的同类群组。
  • 胜出实验组与对照组效果相当 (AB_WINNER_PARITY_VS_CONTROL)：胜出实验组在直接对比中表现优于竞争实验组 (winner_score > 0.55)，但在所查询的置信度下，两个实验组相对于未接触广告的对照组均未产生具有统计显著性的增量提升。在增加胜出组别的支出之前，请查询 ALL 转化 (segments.conversion_lift_included_conversion_action_types = 'ALL') 和 segments.conversion_lift_conversion_category 细分，以验证是否在其他地方也观察到了积极的因果提升。

POSITIVE_LIFT_DETECTED 结果适用于 A/B + 转化量提升情况查询粒度，如下所示：

  • 组合组 (OVERALL) 研究行（不含 segments.experiment_arm 的查询）：与未接触广告的对照组 (p_value <= 0.50) 相比，该研究产生了正向提升，且两个组的正面交锋胜出者得分均未超过 0.55。
  • 每个实验组 (segments.experiment_arm) 的行：当一个实验组胜出 (winner_score > 0.55) 且两个实验组相对于对照组都实现了正向升幅时，胜出的实验组行会返回 AB_WINNER_WITH_LIFT，而未胜出的实验组行会返回 POSITIVE_LIFT_DETECTED。
  • 转化类别 (segments.conversion_lift_conversion_category) 切片行：由于系统不会按转化类别评估胜出者得分，因此升幅为正的行始终会返回 POSITIVE_LIFT_DETECTED。

当切片返回 NOT_ENOUGH_DATA 或 NO_SIGNIFICANT_LIFT 时，请勿因单个切片样本不足而暂停实验组或排除受众群体。查看总体研究指标和ALL转化次数 (segments.conversion_lift_included_conversion_action_types = 'ALL')。

查询组合组和多研究结果

如果您在对 lift_measurement_config 资源执行查询时省略 segments.experiment_arm 细分，API 会返回在两个组合组中汇总的研究级增量。对于组合组查询，请省略四个 metrics.*_winner_score 指标，这些指标仅适用于竞争组，在没有 segments.experiment_arm 的组合组行中会被省略（不设置）。使用查询转化量提升情况和 iCPA 以及查询转化价值提升情况和 iROAS 中的研究级查询。

当您按 segments.experiment_arm 细分 A/B + 转化量提升情况结果时，该 API 仅支持 segments.conversion_lift_conversion_category 细分作为额外的细分维度。由于组支出不归因于各个转化类别，因此在添加 segments.conversion_lift_conversion_category 细分时，请评估转化量和转化价值提升指标（忽略 iCPA 和 iROAS 指标，这些指标在 Google Ads API v27 及更高版本中无法通过查询验证，并会显示 QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE 错误）。segments.conversion_action、segments.conversion_action_name、segments.age_range、segments.gender、segments.device、segments.country、segments.country_localized_name 和 segments.date 细分与 segments.experiment_arm 细分和 metrics.*_winner_score 指标不兼容。 选择 segments.experiment_arm 的同时选择这些不兼容的细分受众群中的任何一个，都会返回 QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE 错误（如果查询还选择了任何 metrics.*_winner_score 指标，则会返回 QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE 错误）。

如需在单个请求中检索多个研究配置的结果，请使用 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'

替换以下内容：

  • CONFIG_ID_1：第一个提升效果评测配置的整数 ID。
  • CONFIG_ID_2：第二个提升效果评测配置的整数 ID。
  • START_DATE：快照开始日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260501）。
  • END_DATE：快照结束日期，采用不带引号的 8 位 YYYYMMDD 整数（例如 20260515）。

日期完全相等（= START_DATE 和 = END_DATE）仅返回具有完全相同的快照窗口的研究的行。查询具有不同排期开始日期或最新评估快照日期的研究时，请使用范围运算符（>= 和 <=）进行过滤，或从 WHERE 子句中省略日期过滤条件，同时在 SELECT 子句中保留 segments.conversion_lift_start_date 和 segments.conversion_lift_end_date 细分。

搜索次数提升情况报告

如需衡量 Google Ads API v26 及更高版本中的广告系列带来的自然搜索查询量增幅，请查询搜索次数提升情况报告资源。搜索次数提升情况研究可量化看过您广告的用户与未看过您广告的对照组用户在搜索您的品牌或产品时的行为差异。

搜索次数提升情况资源和细分

查询 SearchLiftKeywordBundle 资源，检索为搜索量提升研究配置的关键字集合的详细信息。SearchLiftKeywordBundle 资源在 Google Ads API 中是只读的（所有字段均为 OUTPUT_ONLY），关键字包在 Google Ads 界面中配置，或由您的 Google 代表或 GPS 联系人配置。其在 GAQL 中的可查询字段为 resource_name、search_lift_keyword_bundle_id、source (SearchLiftMatchingInfoSource) 和 status (SearchLiftKeywordBundleStatus)（在 GAQL 查询中无法选择重复的 keywords 字段）。

查询 LiftMeasurementConfig 资源，以检索搜索次数提升情况指标和总体研究配置。

在 Google Ads API v27 及更高版本中，您还可以在查询搜索次数提升情况指标或细分（segments.search_lift_keyword_bundle 或 segments.search_property）时，在 lift_measurement_config 上的 GAQL SELECT 子句中选择只读 (OUTPUT_ONLY) lift_measurement_config.lift_guidance 字段（lift_guidance.outcome 和 lift_guidance.guidance_message，类型为 LiftGuidance）。在 lift_measurement_config 上，lift_guidance 在仅元数据配置查询中会被省略，而 lift_guidance.guidance_message 可以包含内嵌 Markdown 链接（例如 [Learn more](https://support.google.com/...)）。对于搜索次数提升情况，lift_guidance.outcome 会返回 STUDY_IN_PROGRESS_WITH_LIFT、STUDY_IN_PROGRESS_NO_LIFT_YET、STUDY_IN_PROGRESS_COLLECTING_DATA、POSITIVE_LIFT_DETECTED（至少 70% 的确定性，p_value <= 0.30）、NO_SIGNIFICANT_LIFT 或 NOT_ENOUGH_DATA（根据以下阈值进行评估：总展示次数至少为 1,000,000 次或切片展示次数至少为 100,000 次、观察到的搜索次数至少为 75 次，以及 20 个 Cookie 存储桶中至少有 17 个，其中单个效力不足的关键字包会导致总体研究结果报告 NOT_ENOUGH_DATA）。

按以下维度细分搜索次数提升情况效果：

  • segments.search_lift_keyword_bundle：按关键字包资源名称细分。与segments.search_property、segments.date和受众特征细分群（segments.device、segments.age_range和segments.gender）兼容。每个关键字包都会报告完整的广告系列费用和展示次数，并且关键字可以属于多个包。请勿对不同关键字组的metrics.search_lift_cost_micros、metrics.search_lift_impressions或搜索次数提升情况指标进行求和。
  • segments.search_property：按发生搜索的搜索媒体资源进行细分，由 SearchLiftSearchProperty 枚举（例如 GOOGLE_SEARCH 或 YOUTUBE）定义。segments.search_property 细分仅与 segments.search_lift_keyword_bundle 和 segments.date 细分兼容。将 segments.search_property 与受众特征细分群（segments.device、segments.age_range 或 segments.gender）结合使用会导致查询验证失败。由于 segments.search_property 会对后续自然搜索发生的位置（而非广告投放的位置）进行划分，因此在 Google Ads API v26 中，按 segments.search_property 细分的行会重复未划分的广告系列级费用和展示次数。从 Google Ads API v27 开始，所有八个支出和展示指标（metrics.search_lift_cost_micros、metrics.search_lift_impressions、metrics.normalized_incremental_searches_per_cost* 和 metrics.normalized_incremental_searches_per_impression*）都与 segments.search_property 不兼容，并且会因 QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE 错误而无法通过查询验证。
  • 受众特征和日期细分：segments.device、segments.age_range、segments.gender 和 segments.date。

搜索次数提升情况指标

LiftMeasurementConfig 资源提供搜索次数提升情况指标，用于评估搜索行为的变化：

当升幅在统计上为正时，系统会报告以下归一化增量指标以及相应的 90% 单侧置信度边界（*_p90_lower_bound 和 *_p90_upper_bound）：

搜索次数提升情况评测的搜索查询示例

以下 GAQL 查询演示了如何检索搜索次数提升情况关键字包和效果指标。

关键字集合查询

如需检索为搜索次数提升情况评测配置的关键字组，请查询 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

指标查询

在关键字包查询中检索到的 search_lift_keyword_bundle.resource_name 值对应于以下查询中 segments.search_lift_keyword_bundle 段返回的值。如需了解研究的CONFIG_ID、关联的广告系列和排期，请按照lift_measurement_config和lift_measurement_flight资源上的发现研究配置和排期（按lift_measurement_flight.lift_type = 'SEARCH'过滤排期）进行操作。

以下查询会检索按关键字包和搜索媒体资源细分的搜索次数提升情况指标（选择 metrics.search_lift_cost_micros 或 metrics.search_lift_impressions 时，请省略 segments.search_property）：

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

替换以下内容：

  • CONFIG_ID：提升效果评测配置的整数 ID。