分析 UCP 智能体的表现（Alpha 版）

借助 Merchant Reports API，您可以程序化地检索 Google 各平台（包括 Google 搜索中的 AI 模式和 Gemini）的 Universal Commerce Protocol (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 使用入门。
仅限叶账号：ucp_agentic_performance_view 和 ucp_agentic_product_performance_view 仅适用于叶账号类型（独立账号和个人子账号）。报告服务不支持高级账号（多客户账号）。如需检索高级账号的 UCP 效果，请单独查询每个子账号。
必需的日期过滤条件：您必须在两个视图的每个查询的 WHERE 子句中指定 date 的条件。

分析账号级 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