myTarget को AdMob मीडिएशन के साथ इंटिग्रेट करना

इस गाइड में बताया गया है कि Google Mobile Ads SDK for React Native का इस्तेमाल करके, मीडिएशन की मदद से myTarget से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें वॉटरफ़ॉल इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में myTarget को कैसे जोड़ा जाता है. साथ ही, किसी React Native ऐप्लिकेशन में myTarget SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.

इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप का खुलना
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन
मूल भाषा वाला

ज़रूरी शर्तें

जारी रखने से पहले, इनकी पुष्टि करें:

  • Google Mobile Ads SDK for React Native का नया वर्शन.
  • React Native फ़्रेमवर्क का वर्शन 0.85.0 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads SDK for React Native के साथ कॉन्फ़िगर किया गया ऐसा React Native प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads SDK for React Native सेट अप करना लेख पढ़ें.
    • पक्का करें कि आपने gma-sdk-react-native फ़ोल्डर से adapters फ़ोल्डर को डाउनलोड और एक्सट्रैक्ट कर लिया हो. अगर आपके पास adapters फ़ोल्डर नहीं है, तो Google Mobile Ads SDK for React Native इंस्टॉल करें में जाकर, पहला, दूसरा, और तीसरा चरण अपनाएं.
  • AdMob मीडिएशन सेट अप करें.

पहला चरण: myTarget के यूआई में कॉन्फ़िगरेशन सेट अप करना

अपने myTarget खाते में लॉग इन करें. हेडर में ऐप्लिकेशन पर क्लिक करके, ऐप्लिकेशन पेज पर जाएं. ऐप्लिकेशन जोड़ें पर क्लिक करके अपना ऐप्लिकेशन जोड़ें.

अगर आपका ऐप्लिकेशन Android और iOS, दोनों प्लैटफ़ॉर्म पर काम करता है, तो आपको हर प्लैटफ़ॉर्म के लिए अलग-अलग सेट अप करना होगा.

Android

इसके बाद, अपने ऐप्लिकेशन का Google Play यूआरएल दें.

iOS

इसके बाद, अपने ऐप्लिकेशन का iTunes यूआरएल** डालें.

ऐप्लिकेशन जोड़ते समय, myTarget के लिए ज़रूरी है कि आप प्रोसेस पूरी करने से पहले एक विज्ञापन यूनिट बनाएं.

उपलब्ध विज्ञापन फ़ॉर्मैट में से बैनर चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें बटन पर क्लिक करें.

मध्यवर्ती

उपलब्ध विज्ञापन फ़ॉर्मैट में से इंटरस्टीशियल चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें बटन पर क्लिक करें.

इनाम दिया गया

उपलब्ध विज्ञापन फ़ॉर्मैट में से इनाम वाला वीडियो विज्ञापन चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें बटन पर क्लिक करें.

मूल भाषा वाला

उपलब्ध विज्ञापन फ़ॉर्मैट में से नेटिव चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

विज्ञापन यूनिट की ज़्यादा जानकारी वाले पेज पर, अपना स्लॉट आईडी नोट करें. यह आईडी, विज्ञापन यूनिट की सेटिंग में slot_id के तौर पर मौजूद होता है. इस स्लॉट आईडी का इस्तेमाल, अगले सेक्शन में आपकी AdMob विज्ञापन यूनिट को सेट अप करने के लिए किया जाएगा.

AdMob विज्ञापन यूनिट का आईडी सेट अप करने के लिए, आपको slot_id के साथ-साथ, myTarget के परमानेंट ऐक्सेस टोकन की भी ज़रूरत होगी. Profile टैब पर जाएं और ऐक्सेस टोकन को चुनें. अपना myTarget Permanent Access Token देखने के लिए, Create Token या Show Token पर क्लिक करें.

app-ads.txt फ़ाइल अपडेट करना

ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.

myTarget के लिए app-ads.txt लागू करने के लिए, फ़ाइल बनाने और उसे पब्लिश करने का तरीका देखें.

टेस्ट मोड को चालू करना

myTarget के यूज़र इंटरफ़ेस (यूआई) में, टेस्ट डिवाइस को जोड़ने और उसे कॉन्फ़िगर करने के लिए, myTarget के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

दूसरा चरण: AdMob के यूआई में myTarget की डिमांड सेट अप करना

अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना

Android

निर्देशों के लिए, Android के लिए दी गई गाइड में दूसरा चरण देखें.

iOS

निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.

Mail.ru को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना

AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में Mail.ru को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग

तीसरा चरण: myTarget SDK और अडैप्टर को इंपोर्ट करना

अपने प्रोजेक्ट की रूट डायरेक्ट्री में, myTarget के लिए Google Mobile Ads SDK for React Native मीडिएशन अडैप्टर इंस्टॉल करें. नीचे दिए गए कदमों को पूरा करें:

  1. Google Mobile Ads SDK for React Native अडैप्टर की tar फ़ाइल को gma-sdk-react-native/adapters/mytarget/ डायरेक्ट्री से अपने प्रोजेक्ट की local_packages/ डायरेक्ट्री में कॉपी करें. अगर आपके पास adapters फ़ोल्डर नहीं है, तो ज़रूरी शर्तें देखें.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/mytarget/gma-mediation-mytarget-0.1.0.tgz local_packages/

    EXTRACT_DIR को उस डायरेक्ट्री के पाथ से बदलें जहां आपने संग्रह को एक्सट्रैक्ट किया है.

  2. अपने पसंदीदा पैकेज मैनेजर का इस्तेमाल करके, अडैप्टर पैकेज इंस्टॉल करें:

    npm

    npm install ./local_packages/gma-mediation-mytarget-0.1.0.tgz

    ऊन

    yarn add ./local_packages/gma-mediation-mytarget-0.1.0.tgz

चौथा चरण: myTarget SDK पर निजता सेटिंग लागू करना

ईयू उपयोगकर्ता की सहमति से जुड़ी Google की नीति का पालन करने के लिए, आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूके, और स्विट्ज़रलैंड में अपने उपयोगकर्ताओं को कुछ ज़रूरी जानकारी साफ़ तौर पर देनी होगी. साथ ही, कानूनी रूप से ज़रूरी होने पर, कुकी या दूसरे लोकल स्टोरेज में इकट्ठा किए गए डेटा के इस्तेमाल के लिए भी उनकी सहमति लेनी होगी. इसके अलावा, लोगों के हिसाब से विज्ञापन दिखाने के मकसद से निजी डेटा इकट्ठा करने, शेयर करने, और इस्तेमाल करने के लिए भी उपयोगकर्ताओं की सहमति लेनी होगी. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. यह आपकी ज़िम्मेदारी है कि सहमति की जानकारी, आपकी मीडिएशन चेन में मौजूद हर विज्ञापन सोर्स को भेजी जाए.

myTarget React Native अडैप्टर का वर्शन लागू नहीं और इसके बाद के वर्शन, UMP SDK से जीडीपीआर के तहत सहमति के सिग्नल पास करने की सुविधा देते हैं. साथ ही, ये उन कंसेंट मैनेजमेंट प्लैटफ़ॉर्म से भी सहमति के सिग्नल पास करने की सुविधा देते हैं जो myTarget SDK के लिए, Google की अन्य सहमति की खास जानकारी के साथ इंटिग्रेट होते हैं.

अमेरिका के राज्यों के निजता कानून

अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.

Android और iOS की डेवलपर गाइड में, अमेरिका के निजता कानूनों वाला सेक्शन देखें.

पांचवां चरण: ज़रूरी कोड जोड़ना

Android

myTarget इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं है.

iOS

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, myTarget के दस्तावेज़ पढ़ें.

छठा चरण: लागू किए गए बदलावों की जांच करना

टेस्ट विज्ञापनों को चालू करना

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, myTarget यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो.

टेस्ट विज्ञापनों की पुष्टि करना

यह पुष्टि करने के लिए कि आपको myTarget से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में myTarget (वॉटरफ़ॉल) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.

वैकल्पिक चरण

नेटवर्क के हिसाब से पैरामीटर

myTarget अडैप्टर, विज्ञापन दिखाने के अनुरोध में MyTargetMediationExtras ऑब्जेक्ट को पास करने की सुविधा देता है. इससे नेटवर्क के हिसाब से पैरामीटर सेट किए जा सकते हैं.

myTarget iOS अडैप्टर से डीबग लॉगिंग को चालू या बंद करने के लिए, isIosDebugMode पैरामीटर का इस्तेमाल करें. iOS अडैप्टर, डिफ़ॉल्ट रूप से लॉगिंग की सुविधा चालू करता है. ज़्यादा जानकारी के लिए, iOS नेटवर्क के हिसाब से पैरामीटर गाइड देखें.

यहां दिए गए सैंपल कोड से, isIosDebugMode को सेट करने का तरीका पता चलता है:

import { MyTargetMediationExtras } from '@google/gma-mediation-mytarget';

const request: AdRequest = {
  // ...
  mediationExtras: [
    new MyTargetMediationExtras({
      isIosDebugMode: true, // Enable debug logging on iOS
    }),
  ],
};

गड़बड़ी के कोड

अगर अडैप्टर को myTarget से विज्ञापन नहीं मिलता है, तो पब्लिशर, विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से ResponseInfo का इस्तेमाल कर सकते हैं:

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

विज्ञापन लोड न होने पर, myTarget अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:

Android

गड़बड़ी का कोड कारण
100 myTarget SDK से गड़बड़ी का मैसेज मिला.
101 AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए myTarget सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
102 विज्ञापन का अनुरोध किया गया साइज़, myTarget के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
103 विज्ञापन दिखाने का अनुरोध, यूनिफ़ाइड नेटिव विज्ञापन दिखाने का अनुरोध नहीं है.
104 myTarget से लोड किया गया नेटिव विज्ञापन, अनुरोध किए गए नेटिव विज्ञापन से अलग है.
105 myTarget से लोड किए गए नेटिव विज्ञापन में, कुछ ज़रूरी ऐसेट मौजूद नहीं हैं. जैसे, इमेज या आइकॉन.
106 myTarget SDK, विज्ञापन नहीं दिखा सका.

iOS

गड़बड़ी का कोड कारण
100 myTarget SDK के पास फ़िलहाल कोई विज्ञापन उपलब्ध नहीं है.
101 AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए myTarget सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
102 myTarget Adapter, अनुरोध किए जा रहे विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता.
103 myTarget का ऐसा विज्ञापन दिखाने की कोशिश की गई जो लोड नहीं हुआ है.
104 विज्ञापन का अनुरोध किया गया साइज़, myTarget के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
105 नेटिव विज्ञापन की ज़रूरी ऐसेट मौजूद नहीं हैं.

वर्शन 0.1.1 (डेवलेपमेंट में है)

वर्शन 0.1.0

  • शुरुआती रिलीज़.