Google Ad Manager के साथ तीसरे पक्ष के तौर पर इंटिग्रेट करना

तीसरे पक्ष, 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 नेटवर्क को ऐक्सेस करने की अनुमति देने के लिए, आपको पुष्टि करने का वर्कफ़्लो सुरक्षित तरीके से सेट अप करना होगा.

इसके दो चरण हैं:

  1. Google खाते का ऐसा ईमेल पता बनाएं जिसका इस्तेमाल करके, आपको अपने क्लाइंट के नेटवर्क को ऐक्सेस करना है.
  2. क्लाइंट से कहें कि वह इस खाते को अपने Ad Manager नेटवर्क में उपयोगकर्ता के तौर पर जोड़े.

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

पहले चरण में आपने जो भी तरीका चुना हो, दूसरे चरण में आपको हर नए क्लाइंट से यह अनुरोध करना होगा कि वह आपके बनाए गए Google खाते को अपने Ad Manager नेटवर्क में उपयोगकर्ता के तौर पर जोड़े.

1. Google खाता बनाना

Ad Manager नेटवर्क में जोड़े जा सकने वाले Google खाते बनाने के कई तरीके हैं.

  • पहला विकल्प: OAuth2 सेवा खाता बनाएं. इससे आपके लिए सेवा खाते का एक ईमेल पता जनरेट होता है, जो Google खाते के तौर पर काम करता है. नया सेवा खाता बनाने के निर्देश.

  • दूसरा विकल्प: नए उपयोगकर्ता के तौर पर साइन अप करके, सामान्य Google खाता ("Gmail" खाता) बनाया जा सकता है. अगर आपके पास पहले से कोई Google खाता है, तो गुप्त विंडो या नए ब्राउज़र सेशन में साइन अप करें. इसके अलावा, अगर आपकी कंपनी Google Workspace का इस्तेमाल करती है, तो अपनी कंपनी के डोमेन में Google खाता बनाया जा सकता है. इसके बाद, इस खाते का इस्तेमाल किया जा सकता है. इस गाइड के लिए, हम इन दोनों को "सामान्य" Google खाता कहेंगे.

2. क्लाइंट से कहें कि वह आपके Google खाते को अपने नेटवर्क में जोड़े

अपने क्लाइंट के नेटवर्क को ऐक्सेस करने के लिए Google खाता पाने के बाद, उससे कहें कि वह खाते को अपने Ad Manager नेटवर्क में नए उपयोगकर्ता के तौर पर जोड़े.

चाहे आपने कोई भी तरीका चुना हो, अपने क्लाइंट से इस बारे में ज़रूर बात करें कि आपके खाते के पास कौनसी भूमिकाएं और अनुमतियां होनी चाहिए, ताकि आपका ऐप्लिकेशन आपके क्लाइंट के नेटवर्क पर ज़रूरी डेटा को ऐक्सेस कर सके.

अब अपने क्लाइंट के Ad Manager नेटवर्क पर एपीआई कॉल किए जा सकते हैं. पक्का करें कि आपने networkCode SOAP हेडर को उस क्लाइंट के नेटवर्क कोड पर सेट किया हो जिसके लिए एपीआई कॉल किया जा रहा है. हमारी सभी क्लाइंट लाइब्रेरी में, इस सेटिंग को प्रोग्राम के हिसाब से सेट करने की सुविधा मिलती है. उदाहरण के लिए, ads Java क्लाइंट लाइब्रेरी में, DfpSession इंस्टेंस बनाते समय, नेटवर्क कोड को प्रोग्राम के हिसाब से सेट किया जा सकता है.

एपीआई के बारे में अप-टू-डेट रहना

यह ज़रूरी है कि आपको इस बारे में अप-टू-डेट जानकारी मिलती रहे कि कौनसे एपीआई वर्शन काम करना बंद कर चुके हैं या बंद होने वाले हैं. साथ ही, नए वर्शन कब रिलीज़ होते हैं. जब कोई वर्शन बंद हो जाता है, तो आपको अचानक से कोई झटका नहीं लगता. साथ ही, आपके क्लाइंट के काम में कोई रुकावट नहीं आती. हम हमेशा तीसरे पक्षों से संपर्क नहीं कर पाते. ऐसा इसलिए, क्योंकि हम अपने ग्राहकों के लिए ऐसा करते हैं. इसलिए, एपीआई अपडेट पाने के लिए, आपको हमारे तीन मुख्य चैनलों में से किसी एक को सब्सक्राइब करना होगा. साथ ही, सूचना सेटिंग में बदलाव करना होगा:

हम अपनी डेवलपर साइट पर, बंद होने वाले एपीआई का शेड्यूल भी उपलब्ध कराते हैं. आपको इस पर नियमित रूप से नज़र रखनी चाहिए.