Menganalisis performa agentik UCP (Alfa)

Eksperimental: Fitur ini masih dalam versi alfa (eksperimental) dan dapat berubah sewaktu-waktu.

Merchant Reports API memungkinkan Anda mengambil metrik performa checkout dan konversi Universal Commerce Protocol (UCP) secara terprogram di seluruh platform Google, termasuk Mode AI di Penelusuran dan Gemini. Laporan ini memberikan insight performa yang sama dengan yang tersedia di dasbor analisis UCP Merchant Center, sehingga membantu Anda memantau funnel konversi, pesanan yang diselesaikan, transfer keranjang, dan engagement tingkat produk.

Sub-API Pelaporan menyediakan dua tampilan untuk menganalisis performa UCP:

• UcpAgenticPerformanceView (ucp_agentic_performance_view): Menyediakan metrik funnel konversi, pesanan, pembatalan, dan transfer keranjang tingkat akun yang disegmentasikan menurut tanggal dan negara pelanggan.
• UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): Menyediakan metrik klik tombol beli tingkat produk (offer_id) yang dikelompokkan menurut tanggal dan negara pelanggan.

Sebelum memulai

Sebelum membuat kueri tampilan performa UCP, pastikan Anda memenuhi persyaratan berikut:

• Gunakan endpoint v1alpha: Kirim kueri MCQL ke metode v1alpha accounts.reports.search. Untuk mengetahui detail tentang cara menjalankan permintaan laporan, lihat artikel Mulai menggunakan Merchant Reports API.
• Khusus akun leaf: ucp_agentic_performance_view dan ucp_agentic_product_performance_view hanya tersedia untuk jenis akun leaf (akun mandiri dan sub-akun perorangan). Layanan pelaporan tidak mendukung akun tingkat lanjut (akun multiklien). Untuk mengambil performa UCP di seluruh akun tingkat lanjut, kueri setiap sub-akun secara terpisah.
• Filter tanggal wajib: Anda harus menentukan kondisi pada date di klausa WHERE setiap kueri untuk kedua tampilan.

Menganalisis performa UCP tingkat akun

Gunakan ucp_agentic_performance_view untuk melacak funnel konversi UCP secara keseluruhan, mulai dari klik tombol beli dan penautan akun hingga pembelian yang diselesaikan dan transfer keranjang.

Metrik mata uang dan harga

ucp_agentic_performance_view menangani mata uang dan metrik Price dengan cara yang sama seperti laporan performa:

• Metrik Price: Metrik berikut menampilkan objek Price yang berisi nilai amount_micros dan currency_code:
  • purchase_value
  • average_order_value
  • average_purchase_product_value
  • average_cart_value
  • average_cart_product_value
• Metrik non-harga: Metrik berikut tidak memiliki mata uang terkait:
  • buy_button_clicks
  • accounts_linked
  • account_linking_rate
  • purchase_count
  • cancellations
  • average_purchase_product_count
  • cart_transfers
  • average_cart_product_count

Penting: Menyertakan metrik funnel atau jumlah (seperti buy_button_clicks) dalam kueri yang sama dengan metrik nilai Price akan memisahkan baris yang ditampilkan menurut mata uang. Karena metrik seperti buy_button_clicks tidak memiliki mata uang terkait dengan sendirinya, menggabungkannya dengan metrik Price dapat membagi atau menghilangkan baris tanpa nilai pembelian. Untuk menghindari hal ini dan mendapatkan total yang akurat, jalankan dua kueri terpisah:

1. Metrik funnel dan jumlah keseluruhan (tidak bergantung pada mata uang): Pilih hanya metrik non-harga untuk mendapatkan jumlah gabungan yang tidak bergantung pada mata uang.
2. Metrik nilai pembelian dan keranjang (menurut mata uang): Pilih metrik Price bersama dengan jumlah pesanan dan keranjang yang sesuai untuk menganalisis pendapatan dan nilai per mata uang.

Kueri 1: Mengambil metrik funnel keseluruhan (tidak bergantung pada mata uang)

Gunakan kueri berikut untuk mengambil funnel konversi keseluruhan, jumlah pesanan, dan metrik transfer keranjang yang independen dari mata uang (tanpa metrik nilai Price yang disertakan):

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'

Catatan: Karena average_cart_value adalah metrik Price dengan currency_code terkait, hapus metrik ini dari kueri funnel keseluruhan dan sertakan dalam kueri nilai pembelian dan keranjang sebagai gantinya.

Respons menampilkan metrik funnel gabungan untuk setiap negara pelanggan:

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

Kueri 2: Mengambil metrik nilai pembelian dan keranjang (menurut mata uang)

Gunakan kueri berikut untuk mengambil nilai pembelian, nilai pesanan rata-rata, dan nilai transfer keranjang yang disegmentasikan menurut mata uang:

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

Respons menampilkan baris terpisah untuk setiap mata uang yang ada dalam metrik nilai pembelian atau keranjang:

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

Menganalisis performa UCP tingkat produk

Gunakan ucp_agentic_product_performance_view untuk melihat produk individual mana yang menerima klik tombol beli langsung dari platform Google.

Mengambil klik tombol beli menurut produk

Gunakan kueri berikut untuk mengambil klik tombol beli tingkat produk untuk tanggal tertentu:

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

Anda juga dapat menghilangkan date dari klausa SELECT untuk menggabungkan klik di seluruh rentang tanggal menggunakan 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

Respons menampilkan klik tombol beli gabungan untuk setiap penawaran yang cocok:

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