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

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

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

• 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 ऑब्जेक्ट दिखाती हैं. इसमें 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_attempts
  • account_linking_rate
  • purchase_count
  • cancellations
  • average_purchase_product_count
  • cart_transfers
  • average_cart_product_count

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

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

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

SELECT
  date,
  account_id,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_attempts,
  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'

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

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingAttempts": "125",
        "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_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"
      }
    }
  ]
}

ऐडवांस खाते के लेवल पर क्वेरी

accounts.reports.search अनुरोध के parent पैरामीटर में ऐडवांस खाता (एक से ज़्यादा क्लाइंट वाला खाता या एग्रीगेटर खाता) डालकर, ucp_agentic_performance_view और ucp_agentic_product_performance_view, दोनों के लिए क्वेरी की जा सकती है. जैसे, accounts/{advanced_account_id}.

दोनों व्यू में, account_id कॉलम में हमेशा लीफ Merchant Center खाता आईडी होता है. यह ऐडवांस खाते के तहत क्वेरी करने पर, व्यक्तिगत उप-खाता आईडी होता है. इसके अलावा, स्टैंडअलोन खाते से क्वेरी करने पर, स्टैंडअलोन खाता आईडी होता है. ऐडवांस खाता लेवल पर क्वेरी करते समय, SELECT क्लॉज़ में account_id को शामिल करने से यह तय होता है कि मेट्रिक को किस तरह ग्रुप किया जाएगा:

• account_id को शामिल न करें (ऐडवांस खाते के लेवल पर एग्रीगेट किया गया): account_id को न चुनने पर, रिस्पॉन्स में ऐडवांस खाते से जुड़े सभी उप-खातों की मेट्रिक एग्रीगेट की जाती हैं.
• account_id चुनें (उप-खाते के हिसाब से बांटा गया): account_id को चुनने पर, जवाब में आंकड़ों को लीफ़ account_id के हिसाब से बांटा जाता है. इससे ऐडवांस खाते के तहत हर उप-खाते के लिए अलग-अलग लाइनें दिखती हैं.

ऐडवांस खाते से एग्रीगेट की गई मेट्रिक वापस पाना

ऐडवांस खाते के लेवल पर रोल अप की गई कुल यूसीपी फ़नल मेट्रिक को वापस पाने के लिए, अपने ऐडवांस खाते के आईडी को parent संसाधन के तौर पर इस्तेमाल करके अनुरोध भेजें. साथ ही, SELECT क्लॉज़ से account_id को हटा दें:

SELECT
  date,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_attempts,
  account_linking_rate,
  purchase_count,
  cancellations
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

जवाब में, ऐडवांस खाते के सभी उप-खातों के लिए, हर तारीख और ग्राहक के देश के हिसाब से एग्रीगेट की गई एक लाइन दिखती है:

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

उप-खाते के हिसाब से मेट्रिक हासिल करना

किसी ऐडवांस खाते के बारे में क्वेरी करते समय, नतीजों को उप-खाते के हिसाब से बांटने के लिए, SELECT क्लॉज़ में account_id को शामिल करें:

SELECT
  date,
  account_id,
  customer_country_code,
  buy_button_clicks,
  accounts_linked,
  account_linking_attempts,
  account_linking_rate,
  purchase_count,
  cancellations
FROM ucp_agentic_performance_view
WHERE date = '2026-09-20'

account_id में हमेशा लीफ़ खाते का आईडी होता है. इसलिए, रिस्पॉन्स में ऐडवांस खाते के तहत हर उप-खाते के लिए एक अलग लाइन दिखती है:

{
  "results": [
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "123456789",
        "customerCountryCode": "US",
        "buyButtonClicks": "420",
        "accountsLinked": "85",
        "accountLinkingAttempts": "125",
        "accountLinkingRate": 0.68,
        "purchaseCount": "64",
        "cancellations": "3"
      }
    },
    {
      "ucpAgenticPerformanceView": {
        "date": {
          "year": 2026,
          "month": 9,
          "day": 20
        },
        "accountId": "987654321",
        "customerCountryCode": "US",
        "buyButtonClicks": "310",
        "accountsLinked": "55",
        "accountLinkingAttempts": "100",
        "accountLinkingRate": 0.55,
        "purchaseCount": "46",
        "cancellations": "2"
      }
    }
  ]
}