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 về lượt thanh toán và lượt chuyển đổi của Giao thức thương mại chung (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 giống như trong trang tổng quan về số liệu phân tích của UCP trong 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 các chỉ số về phễu chuyển đổi, đơn đặt hàng, lượt huỷ và lượt 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 các chỉ số về 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 chế độ xem hiệu suất của 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 yêu cầu báo cáo, hãy xem phần Bắt đầu sử dụng Merchant Reports API.
  • Các loại tài khoản được hỗ trợ: Cả ucp_agentic_performance_view và ucp_agentic_product_performance_view đều hỗ trợ tài khoản lá (tài khoản độc lập và tài khoản phụ riêng lẻ) cũng như tài khoản nâng cao (tài khoản nhiều khách hàng hoặc tài khoản của đơn vị tập hợp). Để biết thông tin chi tiết và ví dụ, hãy xem phần Truy vấn ở cấp tài khoản nâng cao.
  • Bộ lọc ngày bắt buộc: Bạn phải chỉ định một điều kiện cho 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 tổng thể của UCP, từ số lượt nhấp vào nút mua và số lượt liên kết tài khoản cho đến số lượt mua hàng và số lượt chuyển giỏ hàng đã hoàn tất.

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 giống 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. Chỉ số tổng thể về phễu và 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ố về giá trị mua hàng và giá trị giỏ hàng (theo đơn vị tiền tệ): Chọn Price chỉ số cùng với số lượng đơn đặt hàng và số lượng giỏ hàng tương ứng để phân tích doanh thu và giá trị theo đơn vị tiền tệ.

Cụm từ tìm kiếm 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à chỉ số chuyển giỏ hàng độc lập với đơn vị tiền tệ (không bao gồm 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 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
      }
    }
  ]
}

Cụm từ tìm kiếm 2: Truy xuất các chỉ số về giá trị mua hàng và giá trị 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 mỗi đơ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ẻ nào nhận được lượt nhấp vào nút mua ngay trên 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 khỏi 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 sẽ trả về số lượt nhấp vào nút mua được tổng hợp cho mỗi 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"
      }
    }
  ]
}

Truy vấn ở cấp tài khoản nâng cao

Bạn có thể truy vấn cả ucp_agentic_performance_view và ucp_agentic_product_performance_view bằng cách chỉ định một tài khoản nâng cao (tài khoản nhiều khách hàng hoặc tài khoản của đơn vị tập hợp) trong tham số parent của yêu cầu accounts.reports.search, chẳng hạn như accounts/{advanced_account_id}.

Trong cả hai chế độ xem, cột account_id luôn chứa mã tài khoản Merchant Center lá (mã tài khoản phụ riêng lẻ khi truy vấn trong tài khoản nâng cao hoặc mã tài khoản độc lập khi truy vấn tài khoản độc lập). Khi truy vấn ở cấp tài khoản nâng cao, việc bạn có đưa account_id vào mệnh đề SELECT hay không sẽ xác định cách nhóm các chỉ số:

  • Bỏ qua account_id (tổng hợp ở cấp tài khoản nâng cao): Khi bạn không chọn account_id, phản hồi sẽ tổng hợp các chỉ số trên tất cả tài khoản phụ thuộc tài khoản nâng cao.
  • Chọn account_id (chia nhỏ theo tài khoản phụ): Khi bạn chọn account_id, phản hồi sẽ phân đoạn số liệu thống kê theo account_id lá, trả về các hàng riêng biệt cho từng tài khoản phụ trong tài khoản nâng cao.

Truy xuất chỉ số tổng hợp trên một tài khoản nâng cao

Để truy xuất tổng số chỉ số phễu UCP được tổng hợp ở cấp tài khoản nâng cao, hãy gửi yêu cầu bằng cách sử dụng mã tài khoản nâng cao làm tài nguyên parent và bỏ qua account_id khỏi mệnh đề SELECT:

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'

Phản hồi trả về một hàng tổng hợp duy nhất cho mỗi ngày và quốc gia của khách hàng trên tất cả các tài khoản phụ của tài khoản nâng cao:

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

Truy xuất các chỉ số được phân tích theo tài khoản phụ

Để phân tích kết quả theo tài khoản phụ khi truy vấn một tài khoản nâng cao, hãy thêm account_id vào mệnh đề SELECT:

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'

Vì account_id luôn giữ mã tài khoản lá, nên phản hồi sẽ trả về một hàng riêng biệt cho mỗi tài khoản phụ trong tài khoản nâng cao:

{
  "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"
      }
    }
  ]
}
Trước
Analyze YouTube Affiliate Performance (Alpha)
Tiếp
Use Merchant Center Query Language