रिपोर्टिंग की खास जानकारी

Campaign Manager 360 API, Campaign Manager 360 के ज़रिए ट्रैफ़िक किए गए विज्ञापनों का डेटा वापस पाने के कई तरीके उपलब्ध कराता है.

रिपोर्टिंग सेवा

Reports सेवा का इस्तेमाल करके रिपोर्ट जनरेट करने के लिए, कई चरणों वाली प्रोसेस को पूरा करना होता है. इसमें रिपोर्ट फ़ाइलों (जैसे कि CSV या Excel फ़ॉर्मैट) को कॉन्फ़िगर करना, जनरेट करना, और वापस पाना शामिल है. यह Campaign Manager 360 API के लिए स्टैंडर्ड रिपोर्टिंग पाथ है. यह बड़े डेटासेट, शेड्यूल की गई ऑटोमेटेड स्क्रिप्ट या फ़ाइलों का इस्तेमाल करने वाले डाउनस्ट्रीम ऐप्लिकेशन के लिए सही है.

आम तौर पर, वर्कफ़्लो में ये चरण शामिल होते हैं:

1. किसी Report संसाधन को तय करें या ढूंढें. इसमें डाइमेंशन, मेट्रिक, तारीख की सीमाएं, और फ़िल्टर शामिल होते हैं. यह संसाधन, यूनीक रिपोर्ट आईडी के साथ सेव होता है. रिपोर्ट बनाना और अपडेट करना लेख पढ़ें.
2. reports.run तरीके को कॉल करके, रिपोर्ट जनरेट करने की प्रोसेस शुरू करें. इससे रिपोर्ट को चलाने के लिए लाइन में लगा दिया जाता है और एक प्लेसहोल्डर File संसाधन मिलता है. रिपोर्ट खोजना और चलाना लेख पढ़ें.
3. समय-समय पर File संसाधन का स्टेटस देखें. यह प्रोसेस एसिंक्रोनस तरीके से चलती है. इसलिए, किसी फ़ाइल का स्टेटस PROCESSING से शुरू होगा और प्रोसेस पूरी होने पर REPORT_AVAILABLE पर बदल जाएगा. रिपोर्ट खोजना और चलाना लेख पढ़ें.
4. रिपोर्ट जनरेट होने के बाद, फ़ाइल का कॉन्टेंट (CSV या Excel) फ़ेच करें. रिपोर्ट डाउनलोड करना लेख पढ़ें.

रिपोर्ट को सिंक्रोनस तरीके से जनरेट करना

अगर आपको कम डेटा के लिए रिपोर्ट फ़ाइल (CSV या Excel) जनरेट करनी है, तो synchronous पैरामीटर को true पर सेट करके, reports.run तरीके को कॉल करके रिपोर्ट को सिंक्रोनस तरीके से चलाया जा सकता है. एपीआई, रिपोर्ट को कम समय में जनरेट करने की कोशिश करता है. अगर क्वेरी को पूरा होने में ज़्यादा समय लगता है, तो रिपोर्ट अपने-आप एसिंक्रोनस क्यू में चली जाती है.

ज़्यादा जानकारी के लिए, सिंक्रोनस रिपोर्ट देखें.

क्वेरी रिपोर्ट का डेटा

रिपोर्ट फ़ाइल जनरेट करने के बजाय, सीधे रिपोर्टिंग डेटा को क्वेरी करने के लिए, reportData.query तरीके का इस्तेमाल करें.

• Report संसाधन बनाने और सेव करने के बजाय, अनुरोध में सीधे तौर पर डाइमेंशन, मेट्रिक, और फ़िल्टर करने या क्रम से लगाने की अन्य शर्तें तय की जाती हैं.
• जवाब में स्ट्रक्चर्ड रिपोर्ट डेटा होता है. इससे जनरेट की गई फ़ाइल को पोल करने और डाउनलोड करने की ज़रूरत नहीं होती.
• यह अनुरोध, 60 सेकंड की सीमा के साथ सिंक्रोनस तरीके से पूरा होता है.

ज़्यादा जानकारी के लिए, JSON रिपोर्ट डेटा को क्वेरी करना लेख पढ़ें.