UCP temsilci performansını analiz etme (alfa)

Merchant Reports API, Google platformlarındaki (Arama'da AI Modu ve Gemini dahil) Universal Commerce Protocol (UCP) ödeme ve dönüşüm performansı metriklerini programatik olarak almanıza olanak tanır. Bu raporlar, Merchant Center UCP analiz kontrol panelinde bulunan performans analizlerini sunarak dönüşüm hunilerini, tamamlanan siparişleri, alışveriş sepeti transferlerini ve ürün düzeyindeki etkileşimi izlemenize yardımcı olur.

Raporlama alt API'si, UCP performansını analiz etmek için iki görünüm sunar:

  • UcpAgenticPerformanceView (ucp_agentic_performance_view): Hesap düzeyinde dönüşüm hunisi, sipariş, iptal ve alışveriş sepeti aktarımı metriklerini tarihe ve müşterinin bulunduğu ülkeye göre segmentlere ayırarak sağlar.
  • UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): Ürün düzeyinde (offer_id) satın alma düğmesi tıklama metriklerini tarihe ve müşterinin ülkesine göre segmentlere ayırır.

Başlamadan önce

UCP performans görünümlerini sorgulamadan önce aşağıdaki koşulları karşıladığınızdan emin olun:

  • v1alpha uç noktasını kullanın: MCQL sorgularınızı v1alpha accounts.reports.search yöntemine gönderin. Rapor isteklerini yürütme hakkında ayrıntılı bilgi için Merchant Reports API'yi kullanmaya başlama başlıklı makaleyi inceleyin.
  • Yalnızca yaprak hesaplar: Hem ucp_agentic_performance_view hem de ucp_agentic_product_performance_view yalnızca yaprak hesap türleri (bağımsız hesaplar ve bireysel alt hesaplar) için kullanılabilir. Raporlama hizmeti, gelişmiş hesapları (çok müşterili hesaplar) desteklemez. Gelişmiş bir hesapta UCP performansını almak için her alt hesabı ayrı ayrı sorgulayın.
  • Zorunlu tarih filtresi: Her iki görünüm için de her sorgunun WHERE ifadesinde date üzerinde bir koşul belirtmeniz gerekir.

Hesap düzeyinde UCP performansını analiz etme

Satın alma düğmesi tıklamaları ve hesap bağlamadan tamamlanan satın alma işlemleri ve alışveriş sepeti aktarımlarına kadar genel UCP dönüşüm huninizi izlemek için ucp_agentic_performance_view kullanın.

Para birimi ve fiyat metrikleri

ucp_agentic_performance_view, para birimlerini ve Price metriklerini performans raporlarındaki gibi işler:

  • Price metrikleri: Aşağıdaki metrikler hem amount_micros değeri hem de currency_code içeren bir Price nesnesi döndürür:
    • purchase_value
    • average_order_value
    • average_purchase_product_value
    • average_cart_value
    • average_cart_product_value
  • Fiyat dışı metrikler: Aşağıdaki metriklerin ilişkili bir para birimi yoktur:
    • buy_button_clicks
    • accounts_linked
    • account_linking_rate
    • purchase_count
    • cancellations
    • average_purchase_product_count
    • cart_transfers
    • average_cart_product_count
  1. Genel dönüşüm hunisi ve sayı metrikleri (para biriminden bağımsız): Para biriminden bağımsız toplu sayılar elde etmek için yalnızca fiyat dışı metrikleri seçin.
  2. Satın alma ve alışveriş sepeti değeri metrikleri (para birimine göre): Geliri ve para birimi başına değeri analiz etmek için Price metrikleri, ilgili sipariş ve alışveriş sepeti sayılarıyla birlikte seçin.

1. sorgu: Genel dönüşüm hunisi metriklerini (para biriminden bağımsız) alma

Para biriminden bağımsız olarak (Price değer metrikleri dahil olmadan) genel dönüşüm hunisi, sipariş sayısı ve alışveriş sepeti aktarımı metriklerini almak için aşağıdaki sorguyu kullanın:

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'

Yanıt, her müşteri ülkesi için toplu dönüşüm hunisi metriklerini döndürür:

{
  "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. sorgu: Satın alma ve alışveriş sepeti değeri metriklerini (para birimine göre) alma

Para birimine göre segmentlere ayrılmış satın alma değerlerini, ortalama sipariş değerlerini ve alışveriş sepeti transfer değerlerini almak için aşağıdaki sorguyu kullanın:

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

Yanıt, satın alma veya alışveriş sepeti değeri metriklerinde bulunan her para birimi için ayrı bir satır döndürür:

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

Ürün düzeyinde UCP performansını analiz etme

Hangi ürünlerin doğrudan Google yüzeylerinden satın alma düğmesi tıklamaları aldığını görmek için ucp_agentic_product_performance_view simgesini kullanın.

Ürüne göre satın alma düğmesi tıklamalarını alma

Belirli bir tarihteki ürün düzeyinde satın alma düğmesi tıklamalarını almak için aşağıdaki sorguyu kullanın:

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

BETWEEN kullanarak bir tarih aralığındaki tıklamaları toplamak için date öğesini SELECT ifadesinden de çıkarabilirsiniz:

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

Yanıt, eşleşen her teklif için toplu satın alma düğmesi tıklamalarını döndürür:

{
  "results": [
    {
      "ucpAgenticProductPerformanceView": {
        "accountId": "123456789",
        "customerCountryCode": "US",
        "offerId": "sku-10042",
        "title": "Lightweight Running Shoes - Blue / Size 10",
        "buyButtonClicks": "38"
      }
    }
  ]
}
Önceki
Analyze YouTube Affiliate Performance (Alpha)
Sonraki
Use Merchant Center Query Language