提升報表

如要評估廣告活動對品牌觀感、轉換、轉換價值和自然搜尋行為的因果影響，請在 Google Ads API 中查詢提升評估報表資源：

  • 品牌提升報表：評估廣告曝光時間對品牌觀感的影響，適用於 Google Ads API v25 以上版本中，受調查的評估類型。
  • 轉換提升報表：在 Google Ads API 25 以上版本中，針對未曝光的控制組，評估轉換增量、轉換價值、單次轉換增量費用 (iCPA) 和廣告投資報酬率增幅 (iROAS)，包括：
  • 搜尋提升報表：在 Google Ads API 26 以上版本中，量化 Google 搜尋和 YouTube 上因廣告曝光而增加的自然搜尋查詢量。

如要查看 experiment 和 campaign 資源的標準 A/B 實驗報表，請參閱「實驗報表」。

品牌提升報表

如要評估廣告活動對品牌觀感的影響，請在 Google Ads API v25 以上版本中，查詢專屬的品牌提升評估資源。

品牌提升資源和細目檢視

Google Ads API 中的品牌提升設定、檔期和細目檢視畫面為唯讀 (所有欄位均為 OUTPUT_ONLY)，且須在 Google Ads UI 中設定，或由 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：提升評估設定的整數 ID (lift_measurement_config.lift_measurement_config_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 25 以上版本中，轉換提升報表會評估廣告對轉換和轉換價值的增量影響。轉換提升研究會比較實驗組 (符合廣告顯示資格的使用者) 和未曝光控制組 (未看到廣告的使用者) 的轉換行為。

轉換提升設定、檔期和實驗連結在 Google Ads API 中為唯讀 (所有欄位均為 OUTPUT_ONLY)，並在 Google Ads UI 中或由 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)，以及有效連結的廣告活動 (lift_measurement_config.campaigns，適用於 Google Ads API 26 以上版本)。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：提升評估設定的整數 ID (lift_measurement_config.lift_measurement_config_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：提升評估設定的整數 ID (lift_measurement_config.lift_measurement_config_id)。

在 Google Ads API 26 以上版本中，您也可以直接從 campaign 資源查詢 campaign.lift_measurement_config 欄位，找出與廣告活動連結的升幅評估設定。查詢這個欄位，就不必另外交叉比對 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 27 以上版本中，如果研究在設定期間是以「轉換次數」而非「轉換價值」做為主要指標，則會查詢 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 25 以上版本中，A/B + 轉換提升研究會結合雙組實驗 (比較控制組與實驗組策略) 和 Google Ads API 中的控制組評估，評估個別組別的增幅，並計算貝氏勝出分數。experiment 資源的直接實驗報表會比較未經調整的各組流量指標，而使用 segments.experiment_arm 區隔查詢 lift_measurement_config 資源，則會根據未曝光的控制組基準，評估各組的成效增幅。

探索實驗和實驗組

A/B + 轉換提升研究會透過唯讀 (OUTPUT_ONLY) experiment.lift_measurement_config 欄位，將 LiftMeasurementConfig 資源連結至雙組 experiment 資源。

如要在單一要求中找出連結的實驗及其實驗組，請查詢 ExperimentArm 資源，並使用歸因 experiment 欄位，然後篩選 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 27 以上版本中，只有在研究的主要指標是轉換價值時，才會填入這個欄位，如果是以轉換次數為主要指標的研究，則會省略 (不設定)。

下列查詢會擷取兩個實驗組的個別成效增幅和貝氏勝出分數：

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)。

如要篩選單一實驗組，請在 WHERE 子句中加入 AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID'，其中 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)，且相較於未曝光的控制組，產生具統計顯著性的增量轉換或轉換價值。推廣或擴大勝出組的策略，並查詢維度細目，查看成效良好的同類群組。
  • Head-to-head winner at parity with holdback (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 26 以上版本中，廣告活動帶來的自然搜尋查詢量增幅，請查詢搜尋提升報表資源。搜尋提升會比較看過廣告的使用者和未看過廣告的控制組，量化兩者對品牌或產品的搜尋行為差異。

搜尋提升資源和區隔

查詢 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 以上版本中，您也可以在 lift_measurement_config 的 GAQL SELECT 子句中，選取唯讀 (OUTPUT_ONLY) lift_measurement_config.lift_guidance 欄位 (lift_guidance.outcome 和 lift_guidance.guidance_message，類型為 LiftGuidance)，查詢搜尋提升指標或區隔 (segments.search_lift_keyword_bundle 或 segments.search_property)。在 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。