इंक्रीमेंटल रिपोर्ट

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

हर बार रिपोर्ट का अनुरोध करने पर पूरे डेटा को डंप करने के बजाय, समय-समय पर सिर्फ़ उस डेटा का अनुरोध किया जा सकता है जिसमें आपकी पिछली रिपोर्ट के बाद बदलाव हुआ है. ये इंक्रीमेंटल रिपोर्ट, पूरी रिपोर्ट की तुलना में काफ़ी कम होंगी.

इंक्रीमेंटल रिपोर्ट का अनुरोध करने पर, आपको इन बातों का ध्यान रखना चाहिए:

  • अब भी समय-समय पर पूरी रिपोर्ट के लिए अनुरोध करना बढ़िया रहता है, क्योंकि शायद कुछ बढ़ोतरी न हो. उदाहरण के लिए, अगर आपने जनवरी में हर हफ़्ते इंक्रीमेंटल रिपोर्ट का अनुरोध किया है, तो फ़रवरी के आखिर में आपको जनवरी के लिए पूरी रिपोर्ट का अनुरोध करना होगा. इससे, आपको जनवरी का पूरा डेटा मिल जाएगा.
  • यह पता लगाना हमेशा संभव नहीं होता कि कुछ इकाइयों में बदलाव हुआ है या नहीं. अगर Search Ads 360 को यह लगता है कि इकाई बदल गई है, तो इंक्रीमेंटल रिपोर्ट में कोई इकाई शामिल होगी. इसका मतलब है कि इंक्रीमेंटल रिपोर्ट में ऐसा डेटा हो सकता है जिसमें कोई बदलाव न किया गया हो.

इंक्रीमेंटल रिपोर्ट का अनुरोध करने के लिए, इनमें से कोई एक Reports.request.timeRange प्रॉपर्टी चुनें:

changedMetricsSinceTimestamp=timestamp

ऐसे अनुरोध मेट्रिक जो तय किए गए टाइमस्टैंप के बाद से बदल गए हैं. मेट्रिक हर दिन के डेटा के हिसाब से सेव होती हैं और यह एक दिन के लिए बदल सकती हैं, लेकिन अगले दिन नहीं. इसलिए, ऐसे अनुरोधों को दिन के हिसाब से सेगमेंट में बांटने की ज़रूरत होती है, क्योंकि date कॉलम मौजूद होना चाहिए. उदाहरण के लिए, clicks, actions, और date कॉलम वाली keyword रिपोर्ट, हर कीवर्ड और तारीख के लिए एक लाइन दिखाएगी जिसमें दिए गए टाइमस्टैंप के बाद से क्लिक या कार्रवाइयों की रिकॉर्ड की गई संख्या में बदलाव हुआ है.

टाइमस्टैंप, अनुरोध किए जाने के समय से आठ दिन पहले का नहीं होना चाहिए. बदली हुई सभी मेट्रिक को कैप्चर करने के लिए, हर सात दिन में कम से कम एक बार changedMetricsSinceTimestamp अनुरोध करें. साथ ही, मेट्रिक सेटलमेंट होने के बाद, हर तारीख की पूरी रिपोर्ट बनाएं. कम से कम सात दिन इंतज़ार करना सुरक्षित है. उदाहरण के तौर पर, हर दिन दो रिपोर्ट बनाना: पिछले 36 घंटों में बदली गई मेट्रिक के लिए इंक्रीमेंटल रिपोर्ट और आठ दिन पहले हुई मेट्रिक के लिए पूरी रिपोर्ट.

changedAttributesSinceTimestamp=timestamp

ऐसे अनुरोध एट्रिब्यूट जो दिए गए टाइमस्टैंप के बाद से बदल गए हैं. changedAttributesSinceTimestamp अनुरोध में सिर्फ़ एट्रिब्यूट कॉलम शामिल किए जा सकते हैं (कोई मेट्रिक या सेगमेंट कॉलम नहीं). यह अनुरोध रॉ इवेंट रिपोर्ट, जैसे कि conversion रिपोर्ट के लिए काम नहीं करता. उदाहरण के लिए, dailyBudget और campaignStartDate कॉलम वाली campaign रिपोर्ट, हर उस कैंपेन के लिए एक लाइन दिखाएगी जिसका रोज़ का बजट या शुरू होने की तारीख, दिए गए टाइमस्टैंप के बाद बदल गई है.

ध्यान दें कि पैरंट एट्रिब्यूट में किए गए बदलाव, changedAttributesSinceTimestamp रिपोर्ट में कैप्चर नहीं किए जाते हैं. उदाहरण के लिए, हो सकता है कि कोई कीवर्ड, पैरंट विज्ञापन ग्रुप से अपनी बिडिंग की रणनीति इनहेरिट करे. भले ही विज्ञापन ग्रुप को बिडिंग की नई रणनीति असाइन की गई हो, हो सकता है कि यह कीवर्ड रिपोर्ट में न दिखे. जिन एट्रिब्यूट कॉलम की वैल्यू पैरंट इकाइयों के हिसाब से होती है (इसलिए, changedAttributesSinceTimestamp रिपोर्ट में उनमें शामिल किए बिना भी बदलाव किया जा सकता है) उनमें आम तौर पर "लागू है" प्रीफ़िक्स होता है, जैसे कि effectiveLabelIds या effectiveBidStartegy.