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

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

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

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

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

क्वेरी 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"
      }
    }
  ]
}

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

ucp_agentic_performance_view और ucp_agentic_product_performance_view, दोनों के लिए क्वेरी की जा सकती है. इसके लिए, accounts.reports.search अनुरोध के parent पैरामीटर में ऐडवांस खाता (एक से ज़्यादा क्लाइंट वाला खाता या एग्रीगेटर खाता) डालें. जैसे, 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_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",
        "accountLinkingRate": 0.65,
        "purchaseCount": "110",
        "cancellations": "5"
      }
    }
  ]
}

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

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

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

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