खास जानकारी

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

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

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

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

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

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

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

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

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

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

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

नीचे दिए गए JSON कोड के जवाब का सैंपल देखें. इसमें बताया गया है कि इस कारोबारी या कंपनी को 4,440 क्लिक कैसे मिले सभी डेस्टिनेशन पर उनके सभी प्रॉडक्ट की परफ़ॉर्मेंस एक साथ दिखाई जाएगी, जैसे कि 1 दिसंबर, 2020 और 21 दिसंबर, 2020.

{"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,546 क्लिक कैसे मिले 1 दिसंबर, 2020 को उनके सभी डेस्टिनेशन पर उनके सभी प्रॉडक्ट का इस्तेमाल करेगा और उनके सभी डेस्टिनेशन पर, उनके सभी प्रॉडक्ट पर 829 क्लिक मिले 2 दिसंबर, 2020. इस तारीख से, 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"
      }
    }
]}