分析 UCP 代理程式成效 (Alpha 版)

Merchant Reports API 可讓您以程式輔助方式，在 Google 服務 (包括 Google 搜尋的 AI 模式和 Gemini) 中，擷取通用商務通訊協定 (UCP) 的結帳和轉換成效指標。這些報表提供的成效洞察資料與Merchant Center UCP 數據分析資訊主頁相同，可協助你監控轉換漏斗、完成的訂單、購物車轉移和產品層級參與度。

Reporting 子 API 提供兩種檢視畫面，可分析 UCP 成效：

UcpAgenticPerformanceView (ucp_agentic_performance_view)：提供帳戶層級的轉換漏斗、訂單、取消和購物車轉移指標，並依日期和顧客國家/地區區隔。
UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view)：提供依日期和顧客國家/地區區隔的產品層級(offer_id)購買按鈕點擊指標。

事前準備

查詢 UCP 績效檢視畫面之前，請先確認您符合下列規定：

使用 v1alpha 端點：將 MCQL 查詢傳送至 v1alpha accounts.reports.search 方法。如要瞭解如何執行報表要求，請參閱「Merchant Reports API Get started」。
僅限子帳戶：ucp_agentic_performance_view 和 ucp_agentic_product_performance_view 僅適用於子帳戶類型 (獨立帳戶和個別子帳戶)。報表服務不支援進階帳戶 (多重客戶帳戶)。如要擷取進階帳戶的 UCP 成效，請個別查詢每個子帳戶。
必要日期篩選器：您必須在兩個資料檢視的每個查詢中，為 date 的 WHERE 子句指定條件。

分析帳戶層級的 UCP 成效

使用 ucp_agentic_performance_view 追蹤整體 UCP 轉換漏斗，從點選購買按鈕和帳戶連結，到完成購買和購物車轉移。

貨幣和價格指標

ucp_agentic_performance_view 處理幣別和Price指標的方式與成效報表相同：

Price 指標：下列指標會傳回 Price 物件，其中包含 amount_micros 值和 currency_code：
- 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"
      }
    }
  ]
}

Analyze YouTube Affiliate Performance (Alpha)

Use Merchant Center Query Language