खास जानकारी

रिपोर्टिंग एपीआई

Reporting API की मदद से व्यापारी/कंपनी, Merchant Center की क्वेरी लैंग्वेज की मदद से, अपने परफ़ॉर्मेंस डेटा से प्रोग्राम के हिसाब से जुड़ सकते हैं. यह सीधे तौर पर Merchant Center में कस्टम रिपोर्ट बनाने की सुविधा जैसा ही है. Reporting API को ये फ़ायदे हैं:

• इससे बड़े व्यापारियों/कंपनियों/कारोबारियों को प्रॉडक्ट लिस्टिंग का परफ़ॉर्मेंस डेटा, अपने इंटरनल या तीसरे पक्ष के रिपोर्टिंग सिस्टम में इंपोर्ट करने की सुविधा मिलती है.
• इससे उपयोगकर्ता, तीसरे पक्ष के पार्टनर, और एग्रीगेटर, Merchant Center खातों में रिपोर्टिंग को ऐक्सेस कर सकते हैं.

API का इस्तेमाल करने वाले लोग यह तय कर सकते हैं कि Search कॉल के जवाब में वे परफ़ॉर्मेंस का कौनसा डेटा पाना चाहते हैं, जैसे कि:

• उपयोगकर्ता को दिखने वाली मेट्रिक, जैसे कि क्लिक, इंप्रेशन
• वे डाइमेंशन जिनमें डेटा को सेगमेंट करना है (उदाहरण के लिए: OfferId, तारीख)
• शर्तें पूरी करना ज़रूरी है (उदाहरण के लिए: क्लिक > 100)

Reporting API की क्वेरी भाषा, Shopping के लिए Content API को परफ़ॉर्मेंस मेट्रिक (क्लिक, इंप्रेशन) के लिए क्वेरी कर सकती है. इस क्वेरी को अलग-अलग डाइमेंशन (रिपोर्ट किए गए इवेंट एट्रिब्यूट जैसे प्रोग्राम और तारीख, और प्रॉडक्ट एट्रिब्यूट जैसे ब्रैंड, कैटगरी वगैरह) के हिसाब से सेगमेंट किया जा सकता है. Reports सेवा के लिए Search तरीके का इस्तेमाल करके ऐसा किया जाता है.

Reports सेवा के लिए क्वेरी से मिलने वाला नतीजा, ReportRow इंस्टेंस की सूची होती है. हर ReportRow, आपकी क्वेरी में बताए गए सेगमेंट के लिए अनुरोध की गई मेट्रिक की वैल्यू दिखाता है. अगर कोई सेगमेंट तय नहीं किया गया है, तो एक पंक्ति दिखाई जाती है और सभी सेगमेंट में एग्रीगेट की गई मेट्रिक दिखाई जाती हैं. नहीं तो, अगर मेट्रिक के साथ किसी भी सेगमेंट का अनुरोध किया जाता है, तो रिस्पॉन्स में हर खास सेगमेंट के लिए एक पंक्ति दिखती है. एक ही क्वेरी में कई सेगमेंट और कई मेट्रिक को चुना जा सकता है.

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

मेट्रिक के लिए क्वेरी

उन मेट्रिक (क्लिक, इंप्रेशन, सीटीआर वगैरह) के लिए क्वेरी की जा सकती है जिन्हें आपको दिखाना है. रिपोर्ट सेवा की क्वेरी करने के लिए आपको तारीख की सीमा पर फ़िल्टर जोड़ना होगा. नीचे दी गई नमूना क्वेरी सिर्फ़ एक पंक्ति दिखाती है: किसी तारीख की सीमा में जोड़ी गई शर्त के तहत क्लिक की कुल संख्या.

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

अहम जानकारी: आपको जो डेटा चाहिए उसके बारे में साफ़ तौर पर जानकारी देनी चाहिए. कोई भी वाइल्डकार्ड (जैसे, Select metrics.*) गड़बड़ी दिखाएगा.

रिस्पॉन्स का उदाहरण

नीचे दिए गए JSON कोड के सैंपल से पता चलता है कि इस व्यापारी/कंपनी/कारोबारी को 1 दिसंबर,2020 से 21 दिसंबर, 2020 के बीच अपने सभी प्रॉडक्ट को मिलाकर 4, 440 क्लिक कैसे मिले.

{"results": [
    {
      "metrics": {
        "clicks": "4,440"
      }
    }
]}

अहम जानकारी: अगर आपने क्वेरी में कोई सेगमेंट नहीं चुना है, तो आपको सिर्फ़ एक लाइन में मेट्रिक दिखेगी.

सेगमेंट के लिए क्वेरी

मेट्रिक के साथ-साथ, सेगमेंट के लिए भी क्वेरी की जा सकती है. यह किसी प्रॉडक्ट (offer_id, brand, category वगैरह) या रिपोर्ट किए गए इवेंट (date, program) का एट्रिब्यूट हो सकता है. रिपोर्ट किया गया इवेंट, किसी प्रॉडक्ट के लिए मिलने वाला इंप्रेशन या क्लिक होता है.

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

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

रिस्पॉन्स का उदाहरण

नीचे दिए गए JSON कोड के सैंपल से पता चलता है कि इस व्यापारी/कंपनी को 1 दिसंबर,2020 को अपने सभी डेस्टिनेशन से जुड़े सभी प्रॉडक्ट पर 1, 546 क्लिक और 2 दिसंबर, 2020 को उनके सभी डेस्टिनेशन से 829 क्लिक कैसे मिले. 3 दिसंबर, 2020 के लिए कोई भी ऑब्जेक्ट वापस नहीं किया जाएगा, क्योंकि उस दिन व्यापारी/कंपनी को कोई क्लिक नहीं मिला था.

{
  "results": [
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        }
      },
      "metrics": {
        "clicks": "1546"
      }
    },
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        }
      },
      "metrics": {
        "clicks": "829"
      }
    }
]}

अहम जानकारी: सेगमेंट सिर्फ़ तब चुने जा सकते हैं, जब मेट्रिक भी चुनी गई हों. अगर क्वेरी में कोई मेट्रिक नहीं चुना जाता है, तो आपको गड़बड़ी दिखेगी.