Performance reports

Merchant API, परफ़ॉर्मेंस रिपोर्ट उपलब्ध कराता है. उदाहरण के लिए, product_performance_view. इस पेज पर, परफ़ॉर्मेंस रिपोर्ट के स्ट्रक्चर के बारे में बताया गया है.

मेट्रिक

आपको जिन मेट्रिक (उदाहरण के लिए, clicks और impressions) के लिए क्वेरी करनी है उन्हें शामिल करें. परफ़ॉर्मेंस डेटा के लिए Reports service से क्वेरी करने के लिए, आपको तारीख की सीमा पर फ़िल्टर जोड़ना होगा.

यहां एक सैंपल क्वेरी दी गई है. यह क्वेरी, तारीख की तय सीमा के दौरान मिले क्लिक की कुल संख्या के साथ एक लाइन दिखाती है:

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

आपको वह डेटा बताना होगा जो आपको वापस चाहिए. वाइल्डकार्ड (उदाहरण के लिए, SELECT *) से गड़बड़ी का मैसेज मिलता है.

यहां दिए गए सैंपल जवाब से पता चलता है कि कारोबारी या कंपनी को 1 दिसंबर, 2023 से 21 दिसंबर, 2023 के बीच, सभी प्रॉडक्ट और मार्केटिंग के सभी तरीकों पर कुल 4,440 क्लिक मिले.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4440"
      }
    }
  ]
}

सेगमेंट

परफ़ॉर्मेंस रिपोर्ट में सेगमेंटेशन के लिए, सेगमेंट फ़ील्ड का इस्तेमाल किया जा सकता है. उदाहरण के लिए, marketing_method के लिए क्वेरी करने पर, हर मार्केटिंग तरीके के लिए एक लाइन वाली रिपोर्ट मिलती है. साथ ही, SELECT क्लॉज़ में उस मार्केटिंग तरीके के लिए आपकी तय की गई मेट्रिक मिलती हैं.

सेगमेंट फ़ील्ड, प्रॉडक्ट एट्रिब्यूट (उदाहरण के लिए, offer_id, brand, और category) या इवेंट एट्रिब्यूट (उदाहरण के लिए, date और marketing_method) हो सकते हैं.

सेगमेंट फ़ील्ड, एसक्यूएल में GROUP BY की तरह काम करते हैं. सेगमेंट फ़ील्ड, चुनी गई मेट्रिक को अलग-अलग करते हैं. साथ ही, SELECT क्लॉज़ में मौजूद हर सेगमेंट के हिसाब से ग्रुप करते हैं.

यहां एक सैंपल क्वेरी दी गई है. इससे, तारीख की सीमा की जोड़ी गई शर्त के हिसाब से, हर दिन मिले क्लिक की संख्या का पता चलता है. साथ ही, clicks के हिसाब से घटते क्रम में जानकारी मिलती है. सिर्फ़ वे पंक्तियां दिखाई जाती हैं जिनमें कम से कम एक अनुरोध की गई मेट्रिक की वैल्यू शून्य नहीं होती.

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

यहां दिए गए सैंपल रिस्पॉन्स से पता चलता है कि कारोबारी या कंपनी को 1 दिसंबर, 2023 को सभी प्रॉडक्ट और मार्केटिंग के सभी तरीकों पर कुल 1,546 क्लिक मिले. वहीं, 2 दिसंबर, 2023 को सभी प्रॉडक्ट और मार्केटिंग के सभी तरीकों पर कुल 829 क्लिक मिले. कारोबारी या कंपनी को 3 दिसंबर, 2023 को कोई क्लिक नहीं मिला. इसलिए, उस तारीख के लिए कोई डेटा नहीं दिखाया गया है.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}

Merchant Center में कस्टम रिपोर्ट की तरह ही, Merchant Reports API की मदद से एक ही क्वेरी में कई सेगमेंट तय किए जा सकते हैं.

यहां एक सैंपल क्वेरी दी गई है. इससे आपके खाते में मौजूद सभी प्रॉडक्ट पर मिले क्लिक की जानकारी मिलती है. यह जानकारी 30 दिनों की अवधि के लिए होती है. इसे marketing_method और offer_id के हिसाब से सेगमेंट किया जाता है:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

इस क्वेरी के जवाब में, offer_id और marketing_method के हर कॉम्बिनेशन के लिए एक लाइन शामिल होती है. साथ ही, उस कॉम्बिनेशन के लिए क्लिक की संख्या भी शामिल होती है:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

कैटगरी और प्रॉडक्ट टाइप

Merchant Center क्वेरी लैंग्वेज, मेट्रिक को दो ग्रुप में बांटने की सुविधा देती है. इन ग्रुप को एट्रिब्यूट के आधार पर तय किया जा सकता है. इससे आपको अपनी इन्वेंट्री को व्यवस्थित करने में मदद मिलती है:

कैटगरी के लेवल

Google की प्रॉडक्ट टैक्सोनॉमी से ली गई कैटगरी. अगर आपने अपने प्रॉडक्ट के लिए कोई कैटगरी नहीं दी है, तो Google उसे अपने-आप कोई कैटगरी असाइन कर सकता है. इसके अलावा, अगर आपने कोई कैटगरी दी है, तो Google उसे और बेहतर बना सकता है.

प्रॉडक्ट टाइप के लेवल

प्रॉडक्ट टाइप, आपके बांटी गई कैटगरी के आधार पर तय किए जाते हैं. कैटेगरी लेवल के उलट, यहां पहले से तय की गई वैल्यू का कोई सेट नहीं होता.

कैटगरी और प्रॉडक्ट टाइप, दोनों एट्रिब्यूट को कई लेवल वाले क्रम में व्यवस्थित किया जाता है. प्रॉडक्ट स्पेसिफ़िकेशन में, हर लेवल को > वर्ण से अलग किया जाता है. हालांकि, रिपोर्ट में आपको हर लेवल को अलग-अलग चुनना होता है.

उदाहरण के लिए, किसी ऐसे प्रॉडक्ट पर विचार करें जिसके प्रॉडक्ट टाइप के लेवल ये हैं:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

रिपोर्ट में हर लेवल को उसके फ़ील्ड में दिखाया जाता है:

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

कीमत की मेट्रिक, जैसे कि conversion_value, को Price टाइप का इस्तेमाल करके दिखाया जाता है. अगर मेट्रिक कई मुद्राओं में उपलब्ध है, तो हर मुद्रा के लिए वैल्यू अलग-अलग लाइन में दिखाई जाती है. उदाहरण के लिए, यह क्वेरी:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

से ये नतीजे मिलते हैं:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

अगर किसी क्वेरी में कीमत और कीमत के अलावा अन्य मेट्रिक, दोनों का अनुरोध किया जाता है, तो कीमत वाली मेट्रिक को कीमत के अलावा अन्य मेट्रिक से अलग नतीजों वाली लाइनों में दिखाया जाता है. हर मुद्रा कोड के लिए, नतीजों वाली एक लाइन होती है. उदाहरण के लिए, यहां दी गई क्वेरी:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

यह जवाब मिलता है:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

आपके चुने गए सभी फ़ील्ड, जवाब में दिखाए जाते हैं. भले ही, उनकी वैल्यू अब भी डिफ़ॉल्ट वैल्यू या शून्य हो.

क्वेरी के लिए उपलब्ध फ़ील्ड के बारे में ज़्यादा जानने के लिए, productPerformanceView टेबल में मौजूद फ़ील्ड देखें.