Menganalisis performa agentik UCP (Alfa)

Merchant Reports API memungkinkan Anda mengambil metrik performa checkout dan konversi Universal Commerce Protocol (UCP) secara terprogram di berbagai 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 interaksi tingkat produk.

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

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

Sebelum memulai

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

  • Gunakan endpoint v1alpha: Kirim kueri MCQL Anda ke metode accounts.reports.search v1alpha. Untuk mengetahui detail tentang cara menjalankan permintaan laporan, lihat Memulai Merchant Reports API.
  • Jenis akun yang didukung: ucp_agentic_performance_view dan ucp_agentic_product_performance_view mendukung akun turunan (akun mandiri dan sub-akun perorangan) serta akun tingkat lanjut (akun multiklien atau akun agregator). Untuk mengetahui detail dan contohnya, lihat Membuat kueri di tingkat akun tingkat lanjut.
  • Filter tanggal yang diperlukan: Anda harus menentukan kondisi pada date dalam klausa WHERE dari setiap kueri untuk kedua tampilan.

Menganalisis performa UCP tingkat akun

Gunakan ucp_agentic_performance_view untuk melacak keseluruhan funnel konversi UCP, 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
  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 (berdasarkan 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, jumlah pesanan, dan metrik transfer keranjang secara keseluruhan, terlepas dari mata uang (tanpa menyertakan metrik nilai 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'

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 (berdasarkan 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 jumlah 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 akan 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"
      }
    }
  ]
}

Kueri di tingkat akun tingkat lanjut

Anda dapat mengkueri ucp_agentic_performance_view dan ucp_agentic_product_performance_view dengan menentukan akun tingkat lanjut (akun multiklien atau akun agregator) dalam parameter parent dari permintaan accounts.reports.search, seperti accounts/{advanced_account_id}.

Di kedua tampilan, kolom account_id selalu menyimpan ID akun Merchant Center leaf (ID sub-akun perorangan saat membuat kueri di akun tingkat lanjut, atau ID akun mandiri saat membuat kueri akun mandiri). Saat membuat kueri di tingkat akun tingkat lanjut, apakah Anda menyertakan account_id dalam klausa SELECT atau tidak akan menentukan cara metrik dikelompokkan:

  • Menghilangkan account_id (digabungkan di tingkat akun tingkat lanjut): Jika account_id tidak dipilih, respons akan menggabungkan metrik di semua sub-akun yang termasuk dalam akun tingkat lanjut.
  • Pilih account_id (dikelompokkan menurut sub-akun): Jika account_id dipilih, respons akan menyegmentasikan statistik menurut account_id turunan, yang menampilkan baris terpisah untuk setiap sub-akun di akun tingkat lanjut.

Mengambil metrik gabungan di seluruh akun tingkat lanjut

Untuk mengambil total metrik funnel UCP yang digabungkan di tingkat akun tingkat lanjut, kirim permintaan menggunakan ID akun tingkat lanjut Anda sebagai resource parent dan hilangkan account_id dari klausa 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'

Respons menampilkan satu baris gabungan per tanggal dan negara pelanggan di semua sub-akun dari akun tingkat lanjut:

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

Mengambil metrik yang dikelompokkan menurut sub-akun

Untuk mengelompokkan hasil berdasarkan sub-akun saat mengkueri akun tingkat lanjut, sertakan account_id dalam klausa 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'

Karena account_id selalu menyimpan ID akun leaf, respons akan menampilkan baris terpisah untuk setiap sub-akun di akun tingkat lanjut:

{
  "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"
      }
    }
  ]
}
Sebelumnya
Analyze YouTube Affiliate Performance (Alpha)
Berikutnya
Use Merchant Center Query Language