Phân tích hiệu suất của tác nhân UCP (Alpha)

Merchant Reports API cho phép bạn truy xuất theo phương pháp có lập trình các chỉ số hiệu suất thanh toán và hiệu suất lượt chuyển đổi theo Giao thức thương mại toàn cầu (UCP) trên các nền tảng của Google, bao gồm cả Chế độ AI trong Tìm kiếm và Gemini. Những báo cáo này cung cấp thông tin chi tiết về hiệu suất tương tự như trong trang tổng quan phân tích UCP của Merchant Center, giúp bạn theo dõi phễu chuyển đổi, đơn đặt hàng đã hoàn tất, lượt chuyển giỏ hàng và mức độ tương tác ở cấp sản phẩm.

API phụ Báo cáo cung cấp 2 chế độ xem để phân tích hiệu suất của UCP:

  • UcpAgenticPerformanceView (ucp_agentic_performance_view): Cung cấp phễu chuyển đổi, đơn đặt hàng, lượt huỷ và chỉ số chuyển giỏ hàng ở cấp tài khoản, được phân đoạn theo ngày và quốc gia của khách hàng.
  • UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): Cung cấp chỉ số lượt nhấp vào nút mua ở cấp sản phẩm (offer_id) được phân đoạn theo ngày và quốc gia của khách hàng.

Trước khi bắt đầu

Trước khi truy vấn các khung hiển thị hiệu suất UCP, hãy đảm bảo bạn đáp ứng các yêu cầu sau:

  • Sử dụng điểm cuối v1alpha: Gửi các truy vấn MCQL đến phương thức accounts.reports.search của v1alpha. Để biết thông tin chi tiết về cách thực hiện các yêu cầu báo cáo, hãy xem phần Bắt đầu sử dụng Merchant Reports API.
  • Chỉ dành cho tài khoản cấp dưới: Cả ucp_agentic_performance_view và ucp_agentic_product_performance_view đều chỉ dành cho các loại tài khoản cấp dưới (tài khoản độc lập và tài khoản phụ riêng lẻ). Dịch vụ báo cáo không hỗ trợ tài khoản nâng cao (tài khoản nhiều khách hàng). Để truy xuất hiệu suất UCP trên một tài khoản nâng cao, hãy truy vấn từng tài khoản phụ riêng lẻ.
  • Bộ lọc ngày bắt buộc: Bạn phải chỉ định một điều kiện trên date trong mệnh đề WHERE của mọi truy vấn cho cả hai chế độ xem.

Phân tích hiệu suất của UCP ở cấp tài khoản

Sử dụng ucp_agentic_performance_view để theo dõi phễu chuyển đổi UCP tổng thể của bạn, từ lượt nhấp vào nút mua và lượt liên kết tài khoản cho đến giao dịch mua đã hoàn tất và lượt chuyển giỏ hàng.

Chỉ số về đơn vị tiền tệ và giá

ucp_agentic_performance_view xử lý đơn vị tiền tệ và các chỉ số Price theo cách tương tự như báo cáo hiệu suất:

  • Chỉ số Price: Các chỉ số sau đây trả về một đối tượng Price chứa cả giá trị amount_micros và currency_code:
    • purchase_value
    • average_order_value
    • average_purchase_product_value
    • average_cart_value
    • average_cart_product_value
  • Chỉ số không liên quan đến giá: Các chỉ số sau đây không có đơn vị tiền tệ liên kết:
    • buy_button_clicks
    • accounts_linked
    • account_linking_rate
    • purchase_count
    • cancellations
    • average_purchase_product_count
    • cart_transfers
    • average_cart_product_count
  1. Phễu tổng thể và chỉ số số lượng (không phụ thuộc vào đơn vị tiền tệ): Chỉ chọn các chỉ số không liên quan đến giá để nhận được số lượng tổng hợp không phụ thuộc vào đơn vị tiền tệ.
  2. Chỉ số giá trị giỏ hàng và giao dịch mua (theo đơn vị tiền tệ): Chọn Price chỉ số cùng với số lượng đơn đặt hàng và giỏ hàng tương ứng để phân tích doanh thu và giá trị theo từng đơn vị tiền tệ.

Truy vấn 1: Truy xuất các chỉ số tổng thể về phễu (không phụ thuộc vào đơn vị tiền tệ)

Sử dụng truy vấn sau để truy xuất phễu chuyển đổi tổng thể, số lượng đơn đặt hàng và các chỉ số chuyển giỏ hàng độc lập với đơn vị tiền tệ (không bao gồm các chỉ số giá trị 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'

Phản hồi này trả về các chỉ số tổng hợp về phễu cho từng quốc gia của khách hàng:

{
  "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
      }
    }
  ]
}

Truy vấn 2: Truy xuất các chỉ số về giá trị giao dịch mua và giỏ hàng (theo đơn vị tiền tệ)

Sử dụng truy vấn sau để truy xuất giá trị giao dịch mua, giá trị trung bình của đơn đặt hàng và giá trị chuyển giỏ hàng được phân đoạn theo đơn vị tiền tệ:

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

Phản hồi sẽ trả về một hàng riêng cho từng đơn vị tiền tệ có trong chỉ số giá trị giao dịch mua hoặc giá trị giỏ hàng:

{
  "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"
        }
      }
    }
  ]
}

Phân tích hiệu suất của UCP ở cấp sản phẩm

Sử dụng ucp_agentic_product_performance_view để xem những sản phẩm riêng lẻ nhận được lượt nhấp vào nút mua trực tiếp từ các nền tảng của Google.

Truy xuất số lượt nhấp vào nút mua theo sản phẩm

Sử dụng truy vấn sau để truy xuất số lượt nhấp vào nút mua ở cấp sản phẩm cho một ngày cụ thể:

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

Bạn cũng có thể bỏ qua date trong mệnh đề SELECT để tổng hợp số lượt nhấp trong một phạm vi ngày bằng cách sử dụng 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

Phản hồi này trả về số lượt nhấp vào nút mua được tổng hợp cho từng sản phẩm phù hợp:

{
  "results": [
    {
      "ucpAgenticProductPerformanceView": {
        "accountId": "123456789",
        "customerCountryCode": "US",
        "offerId": "sku-10042",
        "title": "Lightweight Running Shoes - Blue / Size 10",
        "buyButtonClicks": "38"
      }
    }
  ]
}
Trước
Analyze YouTube Affiliate Performance (Alpha)
Tiếp
Use Merchant Center Query Language