सेगमेंट की गई रिपोर्ट

Search Ads 360 Reporting API का नया वर्शन अब उपलब्ध है. नए एपीआई से कस्टम रिपोर्ट बनाने और डेटा को रिपोर्टिंग ऐप्लिकेशन में इंटिग्रेट करने की बेहतर सुविधा और प्रक्रियाएं शामिल हैं. Search Ads 360 के नए वर्शन की रिपोर्टिंग पर माइग्रेट करने और उसका इस्तेमाल करने के बारे में ज़्यादा जानें एपीआई.

Search Ads 360 API सिर्फ़ तब तक एग्रीगेट किया गया डेटा दिखाता है, जब तक कि ज़्यादा जानकारी वाला और सेगमेंट में बंटा हुआ डेटा सबमिट नहीं किया जाता डेटा शामिल है. उदाहरण के लिए, किसी कीवर्ड में क्लिक कॉलम रिपोर्ट में, आपकी तय की गई समयसीमा के दौरान किसी कीवर्ड पर मिले क्लिक की कुल संख्या बताई जाती है.

keywordText keywordLandingPage क्लिक
विजेट http://www.example.com 6000

लेकिन यदि आप तिमाही के आधार पर सेगमेंट करने वाली किसी कीवर्ड रिपोर्ट का अनुरोध करते हैं, तो प्रत्येक कीवर्ड के लिए आपको आपको हर तिमाही के लिए एक लाइन दिखेगी और क्लिक वाले कॉलम में तिमाही का कुल योग दिखेगा.

keywordText keywordLandingPage quarterStart quarterEnd क्लिक
विजेट http://www.example.com 2012-01-01 2012-03-31 1000
विजेट http://www.example.com 2012-04-01 2012-06-30 1000
विजेट http://www.example.com 2012-07-01 2012-09-30 1000
विजेट http://www.example.com 2012-10-01 2012-12-31 3000

ध्यान दें कि सेगमेंट की गई रिपोर्ट सिर्फ़ तब ही लाइन दिखाती है, जब किसी सेगमेंट के लिए डेटा उपलब्ध हो. उदाहरण के लिए, floodlightActivity कॉलम वाली कीवर्ड रिपोर्ट में, एक कीवर्ड और अगर कोई मेट्रिक एट्रिब्यूट नहीं की गई है, तो रिपोर्ट में Floodlight ऐक्टिविटी पेयर नहीं दिखेगा भी शामिल करें.

कुछ सेगमेंट, खास कॉलम के साथ काम नहीं करते

कुछ सेगमेंट की वजह से, कुछ कॉलम में अमान्य डेटा दिख सकता है. उदाहरण के लिए, floodlightActivity का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब Floodlight को रिपोर्ट करने वाले कॉलम शामिल किए गए हों डेटा, जैसे कि dfaActions, dfaRevenue, dfaTransactions, और dfaWeightedActions. अन्य तरह के कन्वर्ज़न कॉलम (जैसे adWordsConversions) या ऐसे कॉलम जो इंजन मेट्रिक (जैसे, क्लिक और इंप्रेशन), इसमें Floodlight से रिपोर्ट किया गया डेटा शामिल नहीं होता. इसलिए, अगर अमान्य वैल्यू दी गई हैं, तो floodlightActivity के आधार पर रिपोर्ट को सेगमेंट करें.

सेगमेंट की गई रिपोर्ट का अनुरोध करने का तरीका

सेगमेंट की गई रिपोर्ट का अनुरोध करने के लिए, एक ऐसा कॉलम शामिल करें जिसमें segment को रिपोर्ट के टाइप रेफ़रंस में उसके व्यवहार के तौर पर दिखाया गया हो.

नीचे दिया गया एसिंक्रोनस अनुरोध, तिमाही के हिसाब से सेगमेंट की गई कीवर्ड रिपोर्ट के लिए है. कॉन्टेंट बनाने क्लिक कॉलम में दी गई हर लाइन में, तिमाही के लिए मिले क्लिक की कुल संख्या दिखेगी:

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345" // Replace with your IDs
  },
  "reportType": "keyword",

  "columns": [
     { "columnName": "campaignId" },
     { "columnName": "keywordText" },
     { "columnName": "keywordLandingPage" },

     { "columnName": "quarterStart" },
     { "columnName": "quarterEnd" },
     { "columnName": "clicks" },
  ]
  "timeRange" : {
    "startDate" : "2012-01-01",
    "endDate" : "2012-12-31"
  },
  "downloadFormat": "csv",
  "maxRowsPerFile": 5000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
  
ध्यान दें: तारीखों को लेकर सावधानी बरतें. अगर तिमाही रिपोर्ट का अनुरोध किया जा रहा है, तो पक्का करें कि रिपोर्ट की timeRange इसमें पूरी तिमाही शामिल होती है. नहीं तो आपको सिर्फ़ अधूरे नतीजे मिलेंगे, जिससे लोगों को लगता है कि क्लिक, आय वगैरह में भारी कमी आई है.

एक से ज़्यादा सेगमेंट के लिए अनुरोध करना

एक अनुरोध में एक से ज़्यादा सेगमेंट कॉलम शामिल किए जा सकते हैं. निम्न पर ध्यान दें:

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

  • एक ही अनुरोध में, समय से जुड़े अलग-अलग तरह के सेगमेंट शामिल नहीं किए जा सकते. उदाहरण के लिए, एक ही अनुरोध में, तिमाही और महीने के हिसाब से सेगमेंट नहीं किए जा सकते.

  • हर अतिरिक्त सेगमेंट के साथ, पंक्तियों की संख्या बहुत ज़्यादा बढ़ सकती है.