खास जानकारी

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

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

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

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

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

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

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

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

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

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

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

यहां दिए गए 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"
      }
    }
]}