मेरा पहला ऐप्लिकेशन में बताए गए तरीके से अपने क्लाइंट ऐप्लिकेशन को सेट अप करने के बाद, रिपोर्ट का अनुरोध करने और उन्हें डाउनलोड करने के लिए, Search Ads 360 API का इस्तेमाल किया जा सकता है. इनमें से किसी भी तरह के अनुरोध किए जा सकते हैं:
- सिंक्रोनस
इसके लिए, सिर्फ़ एक अनुरोध की ज़रूरत होती है. इससे रिपोर्ट, JSON फ़ॉर्मैट के जवाब में दिखती है. सिंक्रोनस अनुरोध:
- सिर्फ़ विज्ञापन देने वाले और इंजन खाते की रिपोर्ट दिखाई जा सकती हैं
- Search Ads 360 की मदद से रिपोर्ट जनरेट होने तक, अपने क्लाइंट को ब्लॉक करें
अगर आपने विज्ञापन देने वाले किसी बड़े संगठन या इंजन-खाते की रिपोर्ट के लिए अनुरोध किया है, तो हम एसिंक्रोनस तरीके का इस्तेमाल करने का सुझाव देते हैं.
- एसिंक्रोनस
इसके लिए, आपको शुरुआती अनुरोध भेजना होगा. इसमें उस डेटा के बारे में बताया जाना चाहिए जो आपको रिपोर्ट में चाहिए. इसके बाद, Search Ads 360 को पोल कराने के लिए और अनुरोध भेजे जाते हैं. Search Ads 360, रिपोर्ट जनरेट करने के बाद, रिपोर्ट को एक या उससे ज़्यादा फ़ाइलों के तौर पर डाउनलोड करने के लिए अनुरोध भेजता है. एसिंक्रोनस अनुरोध:
- कोई भी रिपोर्ट टाइप दिखा सकता है
- बहुत बड़ी रिपोर्ट को कई फ़ाइलों में शेयर करता है
- रिपोर्ट को CSV या TSV फ़ॉर्मैट के तौर पर फ़ॉर्मैट करता है
डेटा मॉडल: पंक्तियां और कॉलम
Search Ads 360, रिपोर्ट में मौजूद डेटा को पंक्तियों और कॉलम में व्यवस्थित करता है. आपने जिस तरह की रिपोर्ट का अनुरोध किया है उसके आधार पर, दिखाई जाने वाली लाइन तय होती हैं. उदाहरण के लिए, अगर आपने कीवर्ड रिपोर्ट का अनुरोध किया है, तो हर लाइन में एक कीवर्ड के बारे में डेटा होगा. सभी रिपोर्ट टाइप की सूची के लिए, रिपोर्ट टाइप रेफ़रंस देखें. अपने रिपोर्ट अनुरोध में, हर कॉलम को नाम देकर यह तय किया जा सकता है कि आपको रिपोर्ट में कौनसे कॉलम दिखाने हैं. हर तरह की रिपोर्ट के लिए दिखाए जा सकने वाले कॉलम की सूची के लिए, रिपोर्ट टाइप रेफ़रंस देखें.
कॉलम का व्यवहार
किसी कॉलम का व्यवहार इस बात पर निर्भर करता है कि कॉलम में किस तरह का डेटा मौजूद है (रिपोर्ट टाइप रेफ़रंस हर कॉलम का व्यवहार दिखाता है):
एट्रिब्यूट कॉलम. एट्रिब्यूट कॉलम में, कैंपेन का नाम या कीवर्ड बिड जैसा डेटा होता है. इससे कैंपेन में किसी इकाई को कॉन्फ़िगर किया जाता है या उसकी पहचान की जाती है. Search Ads 360 API हमेशा एट्रिब्यूट कॉलम की मौजूदा वैल्यू दिखाता है. भले ही, अनुरोध में कोई भी तारीख या तारीख की सीमा दी गई हो. उदाहरण के लिए, अगर आपने कल किसी कीवर्ड की बिड को 2.00 से बदलकर 1.50 किया था और इसके बाद पिछले महीने के डेटा की रिपोर्ट का अनुरोध किया, तो रिपोर्ट कीवर्ड बिड के लिए 1.50 वैल्यू दिखाएगी.
मेट्रिक कॉलम. मेट्रिक कॉलम में, आपके कैंपेन की परफ़ॉर्मेंस का डेटा होता है. जैसे, किसी विज्ञापन पर मिले क्लिक की संख्या, Floodlight टैग से रिकॉर्ड की गई विज़िट की संख्या या आय. जब तक किसी एक दिन की समयसीमा तय नहीं की जाती, तब तक एपीआई, मेट्रिक कॉलम के लिए एग्रीगेट वैल्यू दिखाता है. उदाहरण के लिए, अगर आपने पिछले महीने के डेटा के लिए रिपोर्ट का अनुरोध किया है, तो एपीआई पिछले महीने के क्लिक की कुल संख्या दिखाएगा.
सेगमेंट कॉलम. सेगमेंट कॉलम, डेटा को अलग-अलग पंक्तियों में बांटता है. उदाहरण के लिए,
dateएक सेगमेंट कॉलम है, जिसे कई तरह की रिपोर्ट के लिए तय किया जा सकता है. अगर आपने कीवर्ड रिपोर्ट में 01-01-2013 से 07-01-2013 की तारीख की सीमा वाली कीवर्ड रिपोर्ट मेंdateकॉलम तय किया, तो एपीआई हर कीवर्ड के लिए सात पंक्तियां दिखाएगा. हर कीवर्ड एक दिन के हिसाब से और उस दिन की मेट्रिक दिखाएगा. सेगमेंट में बांटी गई रिपोर्ट देखें.
मुद्राएं
आपके रिपोर्ट अनुरोध में, मॉनेटरी डेटा (dailyBudget जैसे एट्रिब्यूट और cost जैसी मेट्रिक, दोनों) की मुद्रा बताई जानी चाहिए. इनमें से कोई एक जानकारी दी जा सकती है:
- एजेंसी की मुद्रा, अगर रिपोर्ट किसी एजेंसी, विज्ञापन देने वाले या इंजन खाते के लिए दायरे में दी गई है.
- विज्ञापन देने वाले की मुद्रा, अगर रिपोर्ट किसी विज्ञापन देने वाले या इंजन खाते के दायरे में आती है.
- इंजन खाते की मुद्रा, अगर रिपोर्ट किसी इंजन खाते के दायरे में आती है.
- USD
मुद्रा बताने के लिए,
Reports.request.statisticsCurrency के अनुरोध वाली प्रॉपर्टी का इस्तेमाल करें.
इस रिपोर्ट से ही, Reports.statisticsCurrencyCode प्रॉपर्टी में मुद्रा की जानकारी मिलेगी.
समय क्षेत्र
Search Ads 360 की मेट्रिक, बिना टाइम ज़ोन वाली तारीखों में स्टोर की जाती हैं. ये तारीखें, इंजन मेट्रिक (जैसे कि क्लिक, इंप्रेशन, और विज़िट) के लिए, इंजन खाते के टाइम ज़ोन के हिसाब से होती हैं. साथ ही, ये कन्वर्ज़न मेट्रिक (जैसे, कार्रवाइयां, लेन-देन, और आय) के लिए Campaign Manager नेटवर्क के टाइम ज़ोन के हिसाब से होती हैं. जब किसी रिपोर्ट की सभी मेट्रिक एक ही टाइम ज़ोन से आती हैं, तो
वह टाइम ज़ोन अनुरोध में दिखाया जाएगा. ऐसा न करने पर, कोई टाइम ज़ोन नहीं दिखाया जाएगा.
आपके अनुरोधों के लिए Reports.request.verifySingleTimeZone: true को सेट किया जा सकता है, ताकि ऐसी रिपोर्ट फ़ेल हो जाएं जिनमें एक से ज़्यादा टाइम ज़ोन की मेट्रिक मौजूद हों.
अगर किसी रिपोर्ट में मौजूद सभी मेट्रिक एक ही टाइम ज़ोन की हैं, तो वह टाइम ज़ोन
Reports.statisticsTimeZoneReports में दिखेगा.