リフトレポート

広告キャンペーンがブランド認知度、コンバージョン、コンバージョン値、オーガニック検索行動に及ぼす因果関係を測定するには、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 広告の管理画面、または 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 はスライスごとに自動選択された 1 つの測定タイプの指標を返します。segments.date セグメントを含めて、ブランド効果測定指標を日付（YYYY-MM-DD）別に分類します。metrics.cost_per_lifted_cookie 指標は、調査を所有するアカウントの通貨のマイクロ単位で返されます。

Google Ads API v27 以降では、lift_measurement_config と 5 つのブランド効果測定の内訳リソース（lift_measurement_age_range、lift_measurement_campaign、lift_measurement_device、lift_measurement_gender、lift_measurement_video）の Google 広告クエリ言語（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 と 5 つのブランド効果測定の内訳リソース（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 広告の管理画面、または Google の担当者や GPS の連絡先で設定します。スタディを所有するアカウントの customer_id パラメータを使用して、lift_measurement_config リソースをクエリします。MCC アカウントは、所有するクロスアカウント コンバージョン リフト測定を直接クエリできます。子アカウントの customer_id パラメータ（必要に応じて login-customer-id ヘッダーで認証）を使用して、子アカウントが所有するスタディをクエリします。

コンバージョン リフト測定レポートは、2 つの調査ワークフローをサポートしています。どちらのワークフローも、同じ調査とフライトの検出、累積スナップショットの日付範囲、コンバージョン アクションのスコープを共有します。

lift_measurement_config リソースに対して有効なクエリを作成するには、Google 広告クエリビルダー ツールを使用します。

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）を確認します。1 つの 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 フィールドで、YYYYMMDD 形式のハイフンなしの引用符なしの 8 桁の整数（例: 20260501）としてフォーマットされます。一方、lift_measurement_flight.start_date フィールドと lift_measurement_flight.end_date フィールドは、ISO 8601 YYYY-MM-DD 形式の日付文字列（例: 2026-05-01）を返します。ブランド効果測定クエリや検索数の増加クエリとは異なり、segments.date セグメントは、すべてのコンバージョン リフト測定の指標およびセグメントと互換性がありません。SELECT 句でコンバージョン リフト測定セグメント（segments.conversion_lift_start_date など）とともに segments.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 セグメントで定義された 2 つのスコープにわたってインクリメンタリティが評価されます。

  • SELECTED: 調査の設定時に選択したコンバージョン アクション。カスタム コンバージョン アクションが指定されていない場合は、入札可能な（メインの）コンバージョン アクションすべて。
  • ALL: 調査で測定されたキャンペーンのすべてのコンバージョン アクション。

segments.conversion_lift_included_conversion_action_types セグメントでフィルタせずにコンバージョン リフト測定の指標を lift_measurement_config リソースでクエリすると、API はスライスごとに 2 つの行（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 日未満である。
  • スケーリングされていない測定コンバージョン数が、最小精度しきい値を下回っています（ホールドバック グループで測定されたベースライン コンバージョン数が 65 件未満、または測定された広告表示コンバージョン数が 150 件未満。metrics.conversion_lift_baseline_conversions のスケーリング前に評価）。
  • 測定されたリフトが正でない（コンバージョン指標の場合は 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）: コンバージョン リフト測定指標のレポート可能性と lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED' は、測定されたリフトがプラス（p_value <= 0.50、プラスの点推定で 50% 以上の確実性に対応。p_value <= 0.10 は *_p90_lower_bound >= 0 で 90% の片側統計的有意性を示す）で、最小精度しきい値（4 日以上のスナップショット、65 件以上のスケーリングされていないベースライン コンバージョン、150 件以上のスケーリングされていない広告表示コンバージョン）を満たしている場合にトリガーされます。プラスのリフトが検出された場合は、ディメンションの内訳（ユーザー属性、デバイス、国、コンバージョン カテゴリ、コンバージョン アクション）をクエリして、パフォーマンスの高いコホート（「明るいスポット」）を特定します。
  • データが不十分、または有意な伸びがない（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 リソースをクエリする場合は、互換性のあるセグメントの組み合わせのみを選択します。

  • コンバージョン カテゴリとコンバージョン アクションのセグメント: segments.conversion_lift_conversion_category、segments.conversion_action、segments.conversion_action_name の各セグメントを個別に選択したり、相互に組み合わせたり、最大 1 つのユーザー属性、デバイス、国のディメンションと組み合わせたりできます。（segments.experiment_arm セグメントをクエリする場合、segments.conversion_lift_conversion_category セグメントのみが互換性があります）。
  • ユーザー属性、デバイス、地域のセグメント: segments.age_range、segments.gender、segments.device、国（segments.country と segments.country_localized_name）のディメンションは、相互に互換性がなく、segments.experiment_arm セグメントとも互換性がありません。クエリごとに、これら 4 つのディメンションのうち最大 1 つを選択します。

SELECT 句で相互に互換性のないセグメントを選択すると、クエリの検証に失敗し、QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE エラーが返されます。Google 広告クエリビルダーを使用して、セグメントの組み合わせをインタラクティブに検証します。

費用対効果の指標（metrics.cost_per_incremental_conversion* と metrics.incremental_conversion_value_per_cost*）は、調査全体の行または segments.experiment_arm 行でのみ評価します。Google Ads API v25 と v26 では、スキーマで 6 つの費用比率指標（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）を 8 つの非アームスライス セグメント（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 以降では、これら 6 つの費用比率指標のいずれかを、これら 8 つの非アームスライス セグメントのいずれかとともに選択すると、クエリ検証ツールに失敗し、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 の形式で返します。conversion_action リソースを個別にクエリすることなく、人が読めるコンバージョン アクション名を取得するには、lift_measurement_config リソースの segments.conversion_action_name セグメントを選択します。次のクエリでは、コンバージョン アクション、コンバージョン アクション名、コンバージョン カテゴリ別にコンバージョン リフト測定の指標を分割します。

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 + コンバージョン リフト測定調査で、2 群テスト（対照群と介入群の戦略を比較）と Google Ads API のホールドバック測定を組み合わせて、各群のインクリメンタリティを評価し、ベイズ勝者スコアを計算します。experiment リソースの直接テスト レポートでは、調整されていないアーム間のトラフィック指標を比較しますが、segments.experiment_arm セグメントを使用して lift_measurement_config リソースをクエリすると、広告が表示されていないホールドバック ベースラインに対する各アームの増分リフトが測定されます。

テストとテスト群を確認する

A/B + コンバージョン リフト測定調査では、読み取り専用（OUTPUT_ONLY）の experiment.lift_measurement_config フィールドを介して、LiftMeasurementConfig リソースを 2 アームの experiment リソースにリンクします。

リンクされたテストとそのアームを 1 つのリクエストで検出するには、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 から開始する場合（または、アカウント内のリフト測定が有効なすべてのテストを一覧表示する場合）は、WHERE experiment.experiment_id = EXPERIMENT_ID（または WHERE experiment.lift_measurement_config IS NOT NULL）でフィルタされた同じ experiment_arm クエリを実行します。

アームごとのインクリメンタリティと勝者スコアをクエリする

各群のインクリメンタリティを測定し、群が勝者となる統計的確率を評価するには、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）。

1 つのテスト群をフィルタするには、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 + コンバージョン リフト測定調査では、2 つの仮説を同時に評価します。1 つは、直接比較による群の優位性（metrics.*_winner_score）、もう 1 つは、広告が表示されなかったホールドバック グループに対する因果リフト（metrics.incremental_* と *_p_value）です。ENABLED 調査の実施期間がまだ進行中の場合（STUDY_IN_PROGRESS_*、お客様のタイムゾーンの現在の日付が lift_measurement_flight.end_date 以前の場合）、直接比較による群の比較とホールドバック コンバージョン モデリングはまだ安定していません。進行中の指標は暫定的なものとして扱い、フライトが完了するまで、実験群のプロモートや予算の再配分は行わないでください。

完了した調査では、実験群が最小精度しきい値（少なくとも 4 日間のスナップショット、150 件の未スケーリングのベースライン コンバージョン、150 件の未スケーリングの広告表示コンバージョン）を満たし、0 <= p_value <= 0.50 を持ち、調査の主要指標でベイズ勝者スコアが 0.55 （> 0.55）より大きい場合に、直接比較の勝者 として分類されます。この二重仮説評価では、2 つの異なる勝者状態が生成されます（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）の行: 1 つのアームが勝ち（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 は、両方の組み合わせ群で集計された調査レベルの伸びを返します。複合アームクエリでは、4 つの metrics.*_winner_score 指標を省略します。これらの指標は競合するアームにのみ適用され、segments.experiment_arm のない複合アーム行では省略されます（未設定のままになります）。コンバージョン リフト測定と iCPA をクエリするとコンバージョン値リフトと iROAS をクエリするの調査レベルのクエリを使用します。

A/B + コンバージョン リフト測定の結果を segments.experiment_arm セグメントで分割する場合、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 エラー）。

1 つのリクエストで複数のスタディ構成の結果を取得するには、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: 2 番目のブランド効果測定の設定の整数 ID。
  • START_DATE: スナップショットの開始日。引用符なしの 8 桁の YYYYMMDD 整数（例: 20260501）。
  • END_DATE: スナップショットの終了日。引用符なしの 8 桁の YYYYMMDD 整数（例: 20260515）。

正確な日付の等価性（= START_DATE と = END_DATE）は、その正確なスナップショット ウィンドウを共有するスタディの行のみを返します。フライト開始日または最新の評価済みスナップショット日が異なるスタディをクエリする場合は、範囲演算子（>= と <=）でフィルタするか、SELECT 句に segments.conversion_lift_start_date セグメントと segments.conversion_lift_end_date セグメントの両方を保持しながら、WHERE 句から日付フィルタを省略します。

検索数の増加レポート

Google Ads API v26 以降で、広告キャンペーンによって促進されたオーガニック検索クエリの増加を測定するには、検索数の増加レポート リソースをクエリします。検索数の増加では、広告が表示されたユーザーと表示されなかった対照群のユーザーの間で、ブランドや商品に関する検索行動の違いを定量化します。

検索数の増加測定のリソースとセグメンテーション

SearchLiftKeywordBundle リソースをクエリして、検索数の増加分析用に構成されたキーワード バンドルの詳細を取得します。SearchLiftKeywordBundle リソースは Google Ads API では読み取り専用（すべてのフィールドが OUTPUT_ONLY）であり、キーワード バンドルは Google 広告の管理画面で、または Google の担当者や GPS の連絡先によって設定されます。GAQL でクエリ可能なフィールドは、resource_name、search_lift_keyword_bundle_id、source（SearchLiftMatchingInfoSource）、status（SearchLiftKeywordBundleStatus）です（繰り返しの keywords フィールドは GAQL クエリで選択できません）。

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 個以上のしきい値に対して評価されます。1 つの不十分なキーワード バンドルにより、全体的な調査結果が 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 は、広告が配信された場所ではなく、その後のオーガニック検索が行われた場所を分割するため、segments.search_property で分割された行は、Google Ads API v26 で分割されていないキャンペーン単位の費用とインプレッションを繰り返します。Google Ads API v27 以降、8 つの費用とインプレッションの指標（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。