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

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

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

एपीआई का इस्तेमाल करने वाले लोग यह तय कर सकते हैं कि उन्हें Search API कॉल के रिस्पॉन्स में कौनसी परफ़ॉर्मेंस का डेटा चाहिए. जैसे:

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

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

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

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

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

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

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

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