Performance reports

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

मेट्रिक

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

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

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

सेगमेंट

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

यहां एक सैंपल क्वेरी दी गई है, जो 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

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

सेगमेंट मान
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"
        }
      }
    }
  ]
}

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