परफ़ॉर्मेंस रिपोर्ट

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

मेट्रिक

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

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

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 आपके प्रॉडक्ट को अपने-आप कोई कैटगरी असाइन कर सकता है. इसके अलावा, वह दी गई कैटगरी को और बेहतर बना सकता है.

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

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

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

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

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 टेबल में मौजूद फ़ील्ड देखें.