तीसरे पक्ष, Ad Manager के सीधे उपयोगकर्ता नहीं होते हैं. ऐसा हो सकता है कि उनके पास अपना खुद का Ad Manager नेटवर्क न हो. इसके बजाय, वे अपने उन क्लाइंट के लिए Ad Manager के साथ सेवाएं या इंटिग्रेशन बनाते हैं, जो Ad Manager के ग्राहक हैं. इस गाइड में, तीसरे पक्ष के इंटिग्रेशन के बारे में बुनियादी बातें बताई गई हैं. इसमें, सबसे सही तरीके, सलाह, और तरकीबें बताई गई हैं.
इस गाइड में यह माना गया है कि आपको Ad Manager API के बारे में जानकारी है. अगर आपको Ad Manager API के बारे में जानकारी नहीं है, तो कृपया हमारे शुरुआती निर्देश देखें.
तीसरे पक्ष के तौर पर शुरू करना
Ad Manager API का इस्तेमाल करके, Ad Manager के किसी ग्राहक के नेटवर्क को ऐक्सेस करने के लिए, नीचे दिए गए दिशा-निर्देशों का पालन करें. Google की अनुमति की ज़रूरत नहीं है. हालांकि, ध्यान रखें कि Ad Manager API को ऐक्सेस और/या इस्तेमाल करके, आप Ad Manager API के नियमों और शर्तों से सहमत होते हैं.
तीसरे पक्ष के तौर पर Ad Manager इंटिग्रेशन की जांच करने का तरीका
तीसरे पक्ष के तौर पर, आपके मन में यह सवाल आ सकता है कि क्लाइंट के प्रोडक्शन नेटवर्क के साथ विज्ञापन चलाने से पहले, अपने Ad Manager इंटिग्रेशन की जांच कैसे की जाए. हमारा सुझाव है कि आप टेस्ट नेटवर्क बनाएं. इसके लिए ज़रूरी नहीं है कि आप Ad Manager का ग्राहक हों. Google खाता रखने वाला कोई भी व्यक्ति टेस्ट नेटवर्क बना सकता है.
हालांकि, ध्यान रखें कि टेस्ट और प्रोडक्शन नेटवर्क के बीच अंतर है. टेस्ट नेटवर्क, विज्ञापन नहीं दिखा सकते. ज़रूरी नहीं है कि टेस्ट नेटवर्क में वे सभी सुविधाएं हों जो आपके क्लाइंट के प्रोडक्शन नेटवर्क पर उपलब्ध होती हैं. अगर आपको Ad Manager की उन सुविधाओं की जांच करनी है जो आपके टेस्ट नेटवर्क पर उपलब्ध नहीं हैं, तो Ad Manager रीसेलर से ऐसे नेटवर्क का ऐक्सेस खरीदा जा सकता है जो टेस्ट नहीं करता.
इसके अलावा, आपको अपने क्लाइंट को साफ़ तौर पर बताना चाहिए कि उनके प्रोडक्शन नेटवर्क पर किन सुविधाओं का होना ज़रूरी है, ताकि आपका ऐप्लिकेशन ठीक से काम कर सके. आपके ऐप्लिकेशन को ऐसे मामलों पर काम करना चाहिए जहां अपवादों को पकड़ कर अच्छी तरह से काम न कर पाने या अपने क्लाइंट की सूची बनाकर रखकर सुविधाएं मौजूद न हों और हर सुविधा में कौनसी सुविधाएं हों या नहीं हों. यह आपके क्लाइंट की ज़िम्मेदारी होनी चाहिए कि वह अपने नेटवर्क पर सुविधाओं को मैनेज करने के लिए, Google में अपने संपर्कों के साथ काम करे.
पुष्टि करना: क्लाइंट के Ad Manager नेटवर्क को ठीक से ऐक्सेस करने का तरीका
आपका ऐप्लिकेशन आपके क्लाइंट के Ad Manager नेटवर्क को ऐक्सेस कर सके, इसके लिए आपको पुष्टि करने का वर्कफ़्लो सुरक्षित तरीके से सेट अप करना होगा.
इसमें दो चरण शामिल हैं:
- अपने Google खाते का ईमेल पता बनाएं. इसका इस्तेमाल अपने क्लाइंट के नेटवर्क को ऐक्सेस करने के लिए किया जाएगा.
- क्लाइंट से कहें कि वह इस खाते को अपने Ad Manager नेटवर्क में उपयोगकर्ता के तौर पर जोड़े.
पहले चरण में, हर क्लाइंट के लिए अलग-अलग Google खाता बनाया जा सकता है या एक मुख्य खाता बनाया जा सकता है, जिसका इस्तेमाल सभी क्लाइंट के लिए किया जाएगा. आपके किसी खाते के साथ छेड़छाड़ होने की स्थिति में, पिछला विकल्प ज़्यादा सुरक्षित होता है. बाद का मतलब है कि आपको पहला चरण सिर्फ़ एक बार पूरा करना होगा.
इससे कोई फ़र्क़ नहीं पड़ता कि चरण 1 के लिए आप क्या करते हैं, दूसरे चरण में आपको हर नए क्लाइंट से कहना होगा कि वह उनके Ad Manager नेटवर्क में उपयोगकर्ता के तौर पर आपके लिए सही Google खाता जोड़े.
1. Google खाता बनाना
Google खाता बनाने के कई तरीके हैं, जिन्हें Ad Manager नेटवर्क से जोड़ा जा सकता है.
पहला विकल्प: OAuth2 सेवा खाता बनाएं, जो आपके लिए सेवा खाते का ऐसा ईमेल पता जनरेट करे जो Google खाते के तौर पर काम करता हो. नया सेवा खाता बनाने के लिए निर्देश.
दूसरा विकल्प: नए उपयोगकर्ता के तौर पर साइन अप करके, सामान्य Google खाता ("Gmail" खाता) बनाया जा सकता है. अगर आपके पास पहले से कोई Google खाता है, तो इस साइन अप को गुप्त विंडो या नए ब्राउज़र सेशन में पूरा करें. इसके अलावा, अगर आपकी कंपनी Google Workspace का इस्तेमाल करती है, तो आपके पास अपनी कंपनी के डोमेन में Google खाता बनाने और उसका इस्तेमाल करने का विकल्प है. इस गाइड में, हम इन दोनों को एक "सामान्य" Google खाता मानते हैं.
2. क्लाइंट को आपके Google खाते को उनके नेटवर्क से जोड़ने के लिए कहें
अपने क्लाइंट के नेटवर्क को ऐक्सेस करने के लिए Google खाता मिलने के बाद, उसे अपने Ad Manager नेटवर्क में नए उपयोगकर्ता के तौर पर खाते को जोड़ने के लिए कहें.
अगर आपने उन्हें OAuth2 सेवा खाते का ईमेल पता उपलब्ध कराया है, तो उन्हें अपने नेटवर्क में जोड़ने के लिए कहें.
अगर आप उन्हें सामान्य Google खाता उपलब्ध करा रहे हैं, तो उनसे अपने नेटवर्क में उपयोगकर्ता के तौर पर अपना खाता जोड़ने के लिए कहें.
आप चाहे किसी भी तरीके का इस्तेमाल करें, लेकिन अपने क्लाइंट से यह चर्चा ज़रूर कर लें कि आपके खाते की भूमिकाएं और अनुमतियां कौनसी होनी चाहिए, ताकि आपका ऐप्लिकेशन आपके क्लाइंट के नेटवर्क पर ज़रूरत के मुताबिक डेटा ऐक्सेस कर सके.
अब अपने क्लाइंट के Ad Manager नेटवर्क पर एपीआई कॉल किए जा सकते हैं. पक्का करें कि आपने उस क्लाइंट के नेटवर्क कोड पर networkCode SOAP हेडर सेट किया है जिस पर एपीआई कॉल किया जा रहा है. हमारी सभी क्लाइंट लाइब्रेरी इसे प्रोग्राम के हिसाब से सेट करने की अनुमति देती हैं. उदाहरण के लिए, विज्ञापन Java क्लाइंट लाइब्रेरी में, DfpSession इंस्टेंस बनाते समय प्रोग्राम के रूप में नेटवर्क कोड सेट किया जा सकता है.
एपीआई के साथ अप-टू-डेट रहना
एपीआई के कौनसे वर्शन के बंद या बंद होने की जानकारी चाहिए और नए वर्शन रिलीज़ होने पर, आपको अप-टू-डेट रखना ज़रूरी है. कोई भी वर्शन बंद होने और आपके क्लाइंट को नुकसान पहुंचाने का जोखिम होने पर आप किसी भी तरह की गतिविधि में शामिल नहीं होना चाहेंगे. हम अपने ग्राहकों की तरह किसी भी समय, कुछ समय के लिए किसी तीसरे पक्ष की कंपनी से संपर्क नहीं कर सकते. इसलिए, यह आपकी ज़िम्मेदारी है कि आप एपीआई अपडेट के लिए हमारे तीन मुख्य चैनल में से किसी एक की सदस्यता लें और अपनी सूचना सेटिंग में बदलाव करें:
हम अपनी डेवलपर साइट पर रोक लगाने का शेड्यूल भी उपलब्ध कराते हैं. आपको समय-समय पर इसकी निगरानी करनी चाहिए.
सहायता पाना
अगर आपको Ad Manager इंटिग्रेशन से जुड़ी कोई समस्या आती है, तो हम आपकी समस्या के आधार पर ये चैनल उपलब्ध कराते हैं. अगर प्रॉडक्ट के बारे में आपका कोई सवाल है, तो कृपया Ad Manager के प्रॉडक्ट फ़ोरम को लिखें. अगर आपके पास एपीआई से जुड़ा कोई सवाल है, तो कृपया Ad Manager API फ़ोरम में पूछें. यह अंतर करने के बारे में सलाह पाने के लिए, कृपया यह ब्लॉग पोस्ट देखें. इसमें यह बताया गया है कि क्या कोई प्रॉडक्ट-लेवल का सवाल है या एपीआई से जुड़ा कोई सवाल.