यूसीपी एजेंटिक की परफ़ॉर्मेंस का विश्लेषण करना (ऐल्फ़ा)

एक्सपेरिमेंट के तौर पर उपलब्ध: यह सुविधा ऐल्फ़ा वर्शन (एक्सपेरिमेंट के तौर पर उपलब्ध) में है और इसमें बदलाव किए जा सकते हैं.

Merchant Reports API की मदद से, Google के अलग-अलग प्लैटफ़ॉर्म पर, यूनिवर्सल कॉमर्स प्रोटोकॉल (यूसीपी) के चेकआउट और कन्वर्ज़न की परफ़ॉर्मेंस मेट्रिक को प्रोग्राम के हिसाब से वापस पाया जा सकता है. इनमें Search और Gemini का एआई मोड भी शामिल है. इन रिपोर्ट में, परफ़ॉर्मेंस के बारे में वही अहम जानकारी मिलती है जो Merchant Center UCP के आंकड़ों वाले डैशबोर्ड में मिलती है. इससे आपको कन्वर्ज़न फ़नल, पूरे किए गए ऑर्डर, कार्ट ट्रांसफ़र, और प्रॉडक्ट-लेवल पर खरीदारों की दिलचस्पी को मॉनिटर करने में मदद मिलती है.

Reporting sub-API, UCP की परफ़ॉर्मेंस का विश्लेषण करने के लिए दो व्यू उपलब्ध कराता है:

• UcpAgenticPerformanceView (ucp_agentic_performance_view): इससे खाता-लेवल पर कन्वर्ज़न फ़नल, ऑर्डर, रद्द करने, और कार्ट ट्रांसफ़र की मेट्रिक मिलती हैं. इन्हें तारीख और खरीदार के देश के हिसाब से सेगमेंट किया जाता है.
• UcpAgenticProductPerformanceView (ucp_agentic_product_performance_view): इससे प्रॉडक्ट लेवल पर (offer_id) 'अभी खरीदें' बटन पर क्लिक करने की मेट्रिक मिलती है. इन्हें तारीख और खरीदार के देश के हिसाब से सेगमेंट किया जाता है.

शुरू करने से पहले

यूसीपी परफ़ॉर्मेंस व्यू के बारे में क्वेरी करने से पहले, पक्का करें कि आपने इन ज़रूरी शर्तों को पूरा किया हो:

• v1alpha एंडपॉइंट का इस्तेमाल करें: v1alpha accounts.reports.search तरीके से अपनी MCQL क्वेरी भेजें. रिपोर्ट के अनुरोधों को पूरा करने के बारे में जानकारी के लिए, Merchant Reports API का इस्तेमाल शुरू करना लेख पढ़ें.
• सिर्फ़ लीफ़ खातों के लिए: ucp_agentic_performance_view और ucp_agentic_product_performance_view, दोनों सिर्फ़ लीफ़ खातों के लिए उपलब्ध हैं. जैसे, स्टैंडअलोन खाते और अलग-अलग उप-खाते. रिपोर्टिंग सेवा, ऐडवांस खातों (एक से ज़्यादा क्लाइंट वाले खातों) के साथ काम नहीं करती. ऐडवांस खाते में यूसीपी की परफ़ॉर्मेंस को वापस पाने के लिए, हर उप-खाते के लिए अलग-अलग क्वेरी करें.
• तारीख के हिसाब से फ़िल्टर करने की सुविधा: आपको दोनों व्यू के लिए, हर क्वेरी के WHERE क्लॉज़ में date पर एक शर्त तय करनी होगी.

खाता-लेवल पर यूसीपी की परफ़ॉर्मेंस का विश्लेषण करना

ucp_agentic_performance_view का इस्तेमाल करके, अपने पूरे यूसीपी कन्वर्ज़न फ़नल को ट्रैक करें. इसमें 'अभी खरीदें' बटन पर क्लिक करने और खाते को लिंक करने से लेकर खरीदारी पूरी होने और कार्ट ट्रांसफ़र तक की जानकारी शामिल होती है.

मुद्रा और कीमत की मेट्रिक

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

अहम जानकारी: Price वैल्यू मेट्रिक के साथ एक ही क्वेरी में फ़नल या गिनती वाली मेट्रिक (जैसे कि buy_button_clicks) शामिल करने से, दिखाई गई लाइनों को मुद्रा के हिसाब से अलग किया जाता है. buy_button_clicks जैसी मेट्रिक में मुद्रा की जानकारी नहीं होती. इसलिए, इन्हें Price मेट्रिक के साथ मिलाने पर, बिना खरीदारी की वैल्यू वाली पंक्तियां अलग हो सकती हैं या हट सकती हैं. इससे बचने और सटीक कुल संख्या पाने के लिए, दो अलग-अलग क्वेरी चलाएं:

1. फ़नल और गिनती की मेट्रिक (मुद्रा से जुड़ी नहीं): मुद्रा से अलग कुल संख्या पाने के लिए, सिर्फ़ बिना कीमत वाली मेट्रिक चुनें.
2. मुद्रा के हिसाब से खरीदारी और कार्ट वैल्यू मेट्रिक: रेवेन्यू और हर मुद्रा के हिसाब से वैल्यू का विश्लेषण करने के लिए, Price मेट्रिक के साथ-साथ उनके ऑर्डर और कार्ट की संख्या चुनें.

क्वेरी 1: फ़नल की सभी मेट्रिक (मुद्रा से जुड़ी जानकारी के बिना) वापस पाएं

मुद्रा से जुड़ी जानकारी के बिना, कन्वर्ज़न फ़नल, ऑर्डर की संख्या, और कार्ट ट्रांसफ़र मेट्रिक की पूरी जानकारी पाने के लिए, यहां दी गई क्वेरी का इस्तेमाल करें. इसमें 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 जुड़ी है. इसलिए, इसे अपनी फ़नल क्वेरी से हटा दें. इसके बजाय, इसे खरीदारी और कार्ट वैल्यू क्वेरी में शामिल करें.

जवाब में, हर देश के खरीदारों के लिए फ़नल मेट्रिक का कुल डेटा मिलता है:

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

दूसरी क्वेरी: मुद्रा के हिसाब से खरीदारी और कार्ट वैल्यू मेट्रिक वापस पाना

मुद्रा के हिसाब से सेगमेंट की गई खरीदारी की वैल्यू, ऑर्डर की औसत वैल्यू, और कार्ट ट्रांसफ़र की वैल्यू पाने के लिए, इस क्वेरी का इस्तेमाल करें:

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_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'

BETWEEN का इस्तेमाल करके, तारीख की किसी सीमा के दौरान मिले क्लिक को एग्रीगेट करने के लिए, SELECT क्लॉज़ से date को हटाया जा सकता है:

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