तीसरे पक्ष, 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 खाता बनाया जा सकता है या एक मुख्य खाता बनाया जा सकता है, जिसका इस्तेमाल सभी क्लाइंट के लिए किया जाएगा. अगर आपका कोई खाता हैक हो जाता है, तो पहला विकल्प ज़्यादा सुरक्षित होता है. इसका मतलब है कि आपको पहला चरण सिर्फ़ एक बार पूरा करना होगा.
पहले चरण में आपने जो भी किया हो, दूसरे चरण में आपको हर नए क्लाइंट से कहना होगा कि वह आपके बनाए गए Google खाते को अपने Ad Manager नेटवर्क में उपयोगकर्ता के तौर पर जोड़े.
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 हेडर को उस क्लाइंट के नेटवर्क कोड पर सेट किया हो जिसके लिए एपीआई कॉल किया जा रहा है. हमारी सभी क्लाइंट लाइब्रेरी, इसे प्रोग्राम के हिसाब से सेट करने की अनुमति देती हैं. उदाहरण के लिए, Ads Java क्लाइंट लाइब्रेरी में, DfpSession इंस्टेंस बनाते समय प्रोग्राम के हिसाब से नेटवर्क कोड सेट किया जा सकता है.
एपीआई के बारे में अप-टू-डेट रहना
यह ज़रूरी है कि आपको इस बारे में अप-टू-डेट जानकारी हो कि एपीआई के कौनसे वर्शन अब काम नहीं करते या बंद हो गए हैं. साथ ही, नए वर्शन कब रिलीज़ किए जाएंगे. किसी वर्शन के बंद होने पर, आपको अचानक कोई समस्या नहीं होनी चाहिए. साथ ही, आपके क्लाइंट को भी कोई समस्या नहीं होनी चाहिए. हम अपने ग्राहकों की तरह, तीसरे पक्षों को बंद होने वाली सुविधाओं और सेवाओं के बारे में हमेशा जानकारी नहीं दे पाते. इसलिए, एपीआई से जुड़े अपडेट पाने के लिए, हमारे तीन मुख्य चैनलों में से किसी एक की सदस्यता लेना और सूचना सेटिंग में बदलाव करना आपकी ज़िम्मेदारी है:
हम अपनी डेवलपर साइट पर बंद होने का शेड्यूल भी उपलब्ध कराते हैं. आपको इस पर नियमित तौर पर नज़र रखनी चाहिए.