खास जानकारी

Merchant API (बीटा वर्शन) के बारे में जानें. यह Content API for Shopping का आधिकारिक उत्तराधिकारी है.

Merchant API (बीटा वर्शन) की नई सुविधाओं, गड़बड़ियों को ठीक करने के तरीकों, और रिलीज़ के अपडेट के बारे में अप-टू-डेट जानकारी पाएं.

Google पर अपने कारोबार और प्रॉडक्ट को मैनेज करने का तरीका जानें. साथ ही, बड़े पैमाने पर डेटा, अहम जानकारी, और यूनीक सुविधाओं का प्रोग्राम के हिसाब से ऐक्सेस पाने का तरीका जानें. अभी शुरू करें

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

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

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

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

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

Reporting API की क्वेरी भाषा, परफ़ॉर्मेंस मेट्रिक (क्लिक, इंप्रेशन) के लिए Content API for Shopping से क्वेरी कर सकती है. ऐसा हो सकता है कि 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"
      }
    }
]}

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