Performance reports

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": "4,440"
      }
    }
  ]
}

सेगमेंट

परफ़ॉर्मेंस रिपोर्ट में सेगमेंटेशन के लिए, segments fields का इस्तेमाल किया जा सकता है. उदाहरण के लिए, 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

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

सेगमेंट मान
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 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 टेबल में मौजूद फ़ील्ड देखें.