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

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

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

Reporting 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 รองรับบัญชีปลายทาง (บัญชีแบบสแตนด์อโลนและบัญชีย่อยแต่ละบัญชี) รวมถึงบัญชีขั้นสูง (บัญชีหลายลูกค้าหรือบัญชีผู้รวบรวมข้อมูล) ดูรายละเอียดและตัวอย่างได้ที่การค้นหาที่ระดับบัญชีขั้นสูง
• ตัวกรองวันที่ที่จำเป็น: คุณต้องระบุเงื่อนไขใน 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 โดยรวม (ไม่ขึ้นอยู่กับสกุลเงิน)

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

ค้นหาที่ระดับบัญชีขั้นสูง

คุณสามารถค้นหาทั้ง ucp_agentic_performance_view และ ucp_agentic_product_performance_view ได้โดยระบุบัญชีขั้นสูง (บัญชีหลายลูกค้าหรือบัญชีผู้รวบรวม) ในพารามิเตอร์ parent ของคำขอ accounts.reports.search เช่น accounts/{advanced_account_id}

ในทั้ง 2 มุมมอง คอลัมน์ account_id จะเก็บรหัสบัญชี Merchant Center Leaf ไว้เสมอ (รหัสบัญชีย่อยแต่ละรายการเมื่อค้นหาภายใต้บัญชีขั้นสูง หรือรหัสบัญชีแบบสแตนด์อโลนเมื่อค้นหาบัญชีแบบสแตนด์อโลน) เมื่อค้นหาที่ระดับบัญชีขั้นสูง การรวม account_id ไว้ในส่วนคำสั่ง SELECT จะเป็นตัวกำหนดวิธีจัดกลุ่มเมตริก ดังนี้

• ละเว้น account_id (รวมที่ระดับบัญชีขั้นสูง): เมื่อไม่ได้เลือก account_id การตอบกลับจะรวมเมตริกในบัญชีย่อยทั้งหมดที่อยู่ในบัญชีขั้นสูง
• เลือก account_id (แยกตามบัญชีย่อย): เมื่อเลือก account_id การตอบกลับจะแบ่งกลุ่มสถิติตาม account_id ระดับล่างสุด โดยแสดงแถวแยกกันสำหรับบัญชีย่อยแต่ละบัญชีในบัญชีขั้นสูง

ดึงข้อมูลเมตริกรวมในบัญชีขั้นสูง

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

การตอบกลับจะแสดงแถวรวม 1 แถวต่อวันที่และประเทศของลูกค้าในบัญชีย่อยทั้งหมดของบัญชีขั้นสูง ดังนี้

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

ดึงข้อมูลเมตริกที่แจกแจงตามบัญชีย่อย

หากต้องการแจกแจงผลลัพธ์ตามบัญชีย่อยเมื่อค้นหาบัญชีขั้นสูง ให้ใส่ account_id ในส่วนคำสั่ง 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'

เนื่องจาก account_id มีรหัสบัญชี Leaf เสมอ การตอบกลับจึงแสดงแถวแยกต่างหากสำหรับบัญชีย่อยแต่ละบัญชีภายใต้บัญชีขั้นสูง ดังนี้

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