วิเคราะห์ประสิทธิภาพของตัวแทน UCP (อัลฟ่า)

เวอร์ชันทดลอง: ฟีเจอร์นี้อยู่ในเวอร์ชันอัลฟ่า (ทดลอง) และอาจมีการเปลี่ยนแปลง

Merchant Reports API ช่วยให้คุณเรียกเมตริกประสิทธิภาพการชำระเงินและประสิทธิภาพของ Conversion ของ Universal Commerce Protocol (UCP) ในแพลตฟอร์มต่างๆ ของ Google แบบเป็นโปรแกรมได้ ซึ่งรวมถึงโหมด AI ใน Search และ Gemini รายงานเหล่านี้จะให้ข้อมูลเชิงลึกด้านประสิทธิภาพเดียวกันกับที่มีในแดชบอร์ดข้อมูลวิเคราะห์ UCP ของ Merchant Center ซึ่งจะช่วยให้คุณตรวจสอบ Funnel Conversion, คำสั่งซื้อที่เสร็จสมบูรณ์, การโอนรถเข็นช็อปปิ้ง และ การมีส่วนร่วมระดับผลิตภัณฑ์ได้

Sub-API การรายงานมีมุมมอง 2 แบบสําหรับการวิเคราะห์ประสิทธิภาพ UCP ดังนี้

• UcpAgenticPerformanceView (ucp_agentic_performance_view): แสดงเมตริก Funnel Conversion ระดับบัญชี คำสั่งซื้อ การยกเลิก และการโอนรถเข็นที่แบ่งกลุ่มตามวันที่และประเทศของลูกค้า
• UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): แสดงเมตริกการคลิกปุ่มซื้อระดับสินค้า (offer_id) ที่แบ่งกลุ่มตามวันที่และประเทศของลูกค้า

ก่อนเริ่มต้น

ก่อนที่จะค้นหามุมมองประสิทธิภาพ UCP โปรดตรวจสอบว่าคุณมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้

• ใช้v1alphaปลายทาง: ส่งการค้นหา MCQL ไปยังเมธอด v1alpha accounts.reports.search ดูรายละเอียดเกี่ยวกับการดำเนินการคำขอรายงานได้ที่เริ่มต้นใช้งาน Merchant Reports API
• บัญชีลูกเท่านั้น: ทั้ง ucp_agentic_performance_view และ ucp_agentic_product_performance_view จะใช้ได้กับบัญชีลูก ประเภทต่างๆ (บัญชีแบบสแตนด์อโลนและบัญชีย่อยของบุคคลธรรมดา) เท่านั้น บริการรายงานไม่รองรับบัญชีขั้นสูง (บัญชีหลายลูกค้า) หากต้องการ ดึงข้อมูลประสิทธิภาพ UCP ในบัญชีขั้นสูง ให้ค้นหาบัญชีย่อยแต่ละบัญชี แยกกัน
• ตัวกรองวันที่ที่ต้องระบุ: คุณต้องระบุเงื่อนไขในdate WHERE ของทุกคําค้นหาสําหรับทั้ง 2 มุมมอง

วิเคราะห์ประสิทธิภาพ UCP ระดับบัญชี

ใช้ ucp_agentic_performance_view เพื่อติดตาม Conversion Funnel ของ UCP โดยรวม ตั้งแต่การคลิกปุ่มซื้อและการลิงก์บัญชีไปจนถึงการซื้อที่เสร็จสมบูรณ์และการโอนรถเข็น ช็อปปิ้ง

เมตริกสกุลเงินและราคา

ucp_agentic_performance_viewจัดการสกุลเงินและเมตริก Price ในลักษณะเดียวกับรายงานประสิทธิภาพ

• Price เมตริก: เมตริกต่อไปนี้จะแสดงผลPriceออบเจ็กต์ ซึ่งมีทั้งค่าamount_microsและcurrency_code
  • purchase_value
  • average_order_value
  • average_purchase_product_value
  • average_cart_value
  • average_cart_product_value
• เมตริกที่ไม่ใช่ราคา: เมตริกต่อไปนี้ไม่มีสกุลเงินที่เกี่ยวข้อง
  • buy_button_clicks
  • accounts_linked
  • account_linking_rate
  • purchase_count
  • cancellations
  • average_purchase_product_count
  • cart_transfers
  • average_cart_product_count

สำคัญ: การรวมเมตริก Funnel หรือเมตริกการนับ (เช่น buy_button_clicks) ไว้ใน การค้นหาเดียวกันกับเมตริกค่า Price จะแยกแถวที่แสดงผลตามสกุลเงิน เนื่องจากเมตริก เช่น buy_button_clicks ไม่มีสกุลเงินที่เชื่อมโยงด้วย การรวมเมตริกเหล่านี้กับเมตริก Price จึงอาจแยกหรือละเว้นแถวที่ไม่มี มูลค่าการซื้อ หากต้องการหลีกเลี่ยงปัญหานี้และรับยอดรวมที่ถูกต้อง ให้เรียกใช้การค้นหา 2 รายการแยกกัน ดังนี้

1. เมตริก Funnel โดยรวมและเมตริกการนับ (ไม่ขึ้นอยู่กับสกุลเงิน): เลือกเฉพาะเมตริกที่ไม่ใช่ราคาเพื่อรับการนับรวมที่ไม่ขึ้นอยู่กับสกุลเงิน
2. เมตริกมูลค่าการซื้อและรถเข็น (ตามสกุลเงิน): เลือกPriceเมตริก พร้อมกับจำนวนคำสั่งซื้อและรถเข็นที่เกี่ยวข้องเพื่อวิเคราะห์รายได้ และมูลค่าต่อสกุลเงิน

คําค้นหา 1: เรียกเมตริก Funnel โดยรวม (ไม่ขึ้นอยู่กับสกุลเงิน)

ใช้การค้นหาต่อไปนี้เพื่อดึงข้อมูล Funnel Conversion โดยรวม จำนวนคำสั่งซื้อ และเมตริกการโอนรถเข็นช็อปปิ้งโดยไม่ขึ้นอยู่กับสกุลเงิน (โดยไม่มี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'

หมายเหตุ: เนื่องจาก average_cart_value เป็นเมตริก Price ที่มีcurrency_code ที่เชื่อมโยงอยู่ ให้ละเว้นเมตริกนี้จากคําค้นหา Funnel โดยรวม และรวมไว้ในคําค้นหามูลค่าการซื้อและรถเข็นแทน

การตอบกลับจะแสดงเมตริก Funnel แบบรวมสำหรับประเทศของลูกค้าแต่ละราย

{
  "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: ดึงข้อมูลเมตริกมูลค่าการซื้อและรถเข็น (ตามสกุลเงิน)

ใช้การค้นหาต่อไปนี้เพื่อดึงมูลค่าการซื้อ มูลค่าการสั่งซื้อเฉลี่ย และ มูลค่าการโอนรถเข็นที่แบ่งตามสกุลเงิน

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

การตอบกลับจะแสดงแถวแยกต่างหากสำหรับแต่ละสกุลเงินที่มีอยู่ในเมตริกมูลค่าการซื้อ หรือรถเข็น

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

วิเคราะห์ประสิทธิภาพ UCP ระดับผลิตภัณฑ์

ใช้ ucp_agentic_product_performance_view เพื่อดูว่าผลิตภัณฑ์แต่ละรายการใด ได้รับการคลิกปุ่มซื้อจากแพลตฟอร์มต่างๆ ของ Google โดยตรง

ดึงข้อมูลการคลิกปุ่มซื้อตามผลิตภัณฑ์

ใช้การค้นหาต่อไปนี้เพื่อดึงข้อมูลการคลิกปุ่มซื้อระดับสินค้าสำหรับวันที่ที่เฉพาะเจาะจง

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

คุณยังละเว้น date จากเงื่อนไข SELECT เพื่อรวบรวมการคลิกในช่วงวันที่โดยใช้ 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

การตอบกลับจะแสดงการคลิกปุ่มซื้อที่รวบรวมไว้สำหรับข้อเสนอที่ตรงกันแต่ละรายการ

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