重要: Content API for Shopping は 2026 年 8 月 18 日 に提供を終了します。

Merchant API への移行にさらに時間が必要な場合は、 Content API for Shopping へのアクセス期間の延長を申請してください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

UCP エージェントのパフォーマンスを分析する（アルファ版）

Merchant Reports API を使用すると、Google 検索の AI モードや Gemini などの Google サーフェス全体で、Universal Commerce Protocol（UCP）の購入手続きとコンバージョンのパフォーマンス指標をプログラムで取得できます。これらのレポートでは、Merchant Center UCP 分析ダッシュボードと同じパフォーマンス分析情報を確認できます。これにより、コンバージョンプロセス、完了した注文、カートの転送、商品レベルのエンゲージメントをモニタリングできます。

Reporting サブ API には、UCP のパフォーマンスを分析するための 2 つのビューが用意されています。

UcpAgenticPerformanceView（ucp_agentic_performance_view）: 日付と顧客の国別にセグメント化された、アカウント単位のコンバージョンプロセス、注文、キャンセル、カート転送の指標を提供します。
UcpAgenticProductPerformanceView（ucp_agentic_product_performance_view）: 日付と顧客の国別にセグメント化された、商品レベル（offer_id）の購入ボタンのクリック指標を提供します。

始める前に

UCP パフォーマンスビューをクエリする前に、次の要件を満たしていることを確認してください。

v1alpha エンドポイントを使用する: MCQL クエリを v1alpha accounts.reports.search メソッドに送信します。レポートリクエストの実行について詳しくは、Merchant Reports API のスタートガイドをご覧ください。
サポートされているアカウントの種類: ucp_agentic_performance_view と ucp_agentic_product_performance_view の両方で、リーフアカウント（独立アカウントと個別のサブアカウント）とアドバンスアカウント（マルチクライアントアカウントまたはアグリゲータアカウント）がサポートされています。詳細と例については、アドバンスアカウントレベルでクエリを実行するをご覧ください。
必須の日付フィルタ: 両方のビューのすべてのクエリの WHERE 句で date の条件を指定する必要があります。

アカウント単位の UCP のパフォーマンスを分析する

ucp_agentic_performance_view を使用すると、購入ボタンのクリックやアカウントのリンクから、購入の完了やカートの転送まで、UCP コンバージョンプロセス全体をトラッキングできます。

通貨と価格の指標

ucp_agentic_performance_view は、パフォーマンスレポートと同じ方法で通貨と Price 指標を処理します。

Price 指標: 次の指標は、amount_micros 値と currency_code の両方を含む Price オブジェクトを返します。
- purchase_value
- average_order_value
- average_purchase_product_value
- average_cart_value
- average_cart_product_value
価格以外の指標: 次の指標には、関連付けられた通貨がありません。
- buy_button_clicks
- accounts_linked
- account_linking_rate
- purchase_count
- cancellations
- average_purchase_product_count
- cart_transfers
- average_cart_product_count

全体的なファネルとカウントの指標（通貨に依存しない）: 価格以外の指標のみを選択して、通貨に依存しない集計カウントを取得します。
購入額とカート額の指標（通貨別）: Price 指標を、対応する注文数とカート数とともに選択して、通貨ごとの収益と価値を分析します。

クエリ 1: ファネル全体の指標を取得する（通貨に依存しない）

次のクエリを使用して、通貨に依存しないコンバージョンプロセス全体、注文数、カート転送の指標を取得します（Price 値の指標は含まれません）。

SELECT
  date,
  account_id,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_rate,
  purchase_count,
  cancellations,
  average_purchase_product_count,
  cart_transfers,
  average_cart_product_count
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

レスポンスでは、顧客の国ごとに集計されたファネル指標が返されます。

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingRate": 0.68,
        "purchaseCount": "64",
        "cancellations": "3",
        "averagePurchaseProductCount": 1.75,
        "cartTransfers": "52",
        "averageCartProductCount": 2.1
      }
    }
  ]
}

クエリ 2: 購入とカートの価値の指標を取得する（通貨別）

次のクエリを使用して、通貨別にセグメント化された購入額、平均注文額、カート転送額を取得します。

SELECT
  date,
  account_id,
  customer_country_code,
  purchase_count,
  purchase_value,
  average_order_value,
  average_purchase_product_count,
  average_purchase_product_value,
  average_cart_value,
  average_cart_product_value
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20' AND purchase_count > 0

レスポンスでは、購入額またはカート額の指標に存在する通貨ごとに個別の行が返されます。

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "purchaseCount": "64",
        "purchaseValue": {
          "amountMicros": "5120000000",
          "currencyCode": "USD"
        },
        "averageOrderValue": {
          "amountMicros": "80000000",
          "currencyCode": "USD"
        },
        "averagePurchaseProductCount": 1.75,
        "averagePurchaseProductValue": {
          "amountMicros": "45714285",
          "currencyCode": "USD"
        },
        "cartTransfers": "52",
        "averageCartValue": {
          "amountMicros": "94500000",
          "currencyCode": "USD"
        },
        "averageCartProductCount": 2.1,
        "averageCartProductValue": {
          "amountMicros": "45000000",
          "currencyCode": "USD"
        }
      }
    }
  ]
}

商品レベルの UCP パフォーマンスを分析する

ucp_agentic_product_performance_view を使用すると、Google サーフェスから直接購入ボタンのクリックを受け取った個々の商品を確認できます。

商品別の購入ボタンのクリック数を取得する

次のクエリを使用して、特定の日付の商品レベルの購入ボタンのクリック数を取得します。

SELECT
  date,
  account_id,
  customer_country_code,
  offer_id,
  title,
  buy_button_clicks
FROM ucp_agentic_product_performance_view
WHERE date = '2026-09-20'

SELECT 句から date を省略して、BETWEEN を使用して期間全体のクリック数を集計することもできます。

SELECT
  account_id,
  customer_country_code,
  offer_id,
  title,
  buy_button_clicks
FROM ucp_agentic_product_performance_view
WHERE date BETWEEN '2026-09-01' AND '2026-09-20'
ORDER BY buy_button_clicks DESC

レスポンスでは、一致する各オファーの購入ボタンのクリック数の集計が返されます。

{
  "results": [
    {
      "ucpAgenticProductPerformanceView": {
        "accountId": "123456789",
        "customerCountryCode": "US",
        "offerId": "sku-10042",
        "title": "Lightweight Running Shoes - Blue / Size 10",
        "buyButtonClicks": "38"
      }
    }
  ]
}

アドバンスアカウント単位でクエリを実行する

ucp_agentic_performance_view と ucp_agentic_product_performance_view の両方をクエリするには、accounts.reports.search リクエストの parent パラメータでアドバンスアカウント（マルチクライアントアカウントまたはアグリゲータアカウント）を指定します（例: accounts/{advanced_account_id}）。

どちらのビューでも、account_id 列には常にリーフ Merchant Center アカウント ID（アドバンスアカウントでクエリする場合は個々のサブアカウント ID、独立アカウントでクエリする場合は独立アカウント ID）が格納されます。アドバンスアカウント単位でクエリを実行する場合、SELECT 句に account_id を含めるかどうかによって、指標のグループ化方法が決まります。

account_id を省略する（アドバンスアカウント単位で集計）: account_id が選択されていない場合、レスポンスには、アドバンスアカウントに属するすべてのサブアカウントの指標が集計されます。
account_id を選択する（サブアカウントごとに分類）: account_id を選択すると、レスポンスではリーフ account_id ごとに統計情報が分割され、アドバンスアカウントのサブアカウントごとに個別の行が返されます。

アドバンスアカウント全体の集計指標を取得する

アドバンスアカウント単位で集計された UCP ファネルの合計指標を取得するには、アドバンスアカウント ID を parent リソースとして使用してリクエストを送信し、SELECT 句から account_id を省略します。

SELECT
  date,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_rate,
  purchase_count,
  cancellations
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

レスポンスは、アドバンスアカウントのすべてのサブアカウントで、日付と顧客の国ごとに 1 つの集計行を返します。

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "customerCountryCode": "US",
        "buyButtonClicks": "730",
        "accountsLinked": "140",
        "accountLinkingRate": 0.65,
        "purchaseCount": "110",
        "cancellations": "5"
      }
    }
  ]
}

サブアカウント別に分類された指標を取得する

アドバンスアカウントをクエリするときに、サブアカウント別に結果を分類するには、SELECT 句に account_id を含めます。

SELECT
  date,
  account_id,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_rate,
  purchase_count,
  cancellations
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

account_id には常にリーフアカウント ID が保持されるため、レスポンスでは、アドバンスアカウントのサブアカウントごとに個別の行が返されます。

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingRate": 0.68,
        "purchaseCount": "64",
        "cancellations": "3"
      }
    },
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "987654321",
        "customerCountryCode": "US",
        "buyButtonClicks": "310",
        "accountsLinked": "55",
        "accountLinkingRate": 0.61,
        "purchaseCount": "46",
        "cancellations": "2"
      }
    }
  ]
}

Analyze YouTube Affiliate Performance (Alpha)

Use Merchant Center Query Language