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

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

पहला चरण: Liftoff Monetize के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना

अपने Liftoff Monetize खाते में साइन अप या लॉग इन करें.

Add Application बटन पर क्लिक करके, अपने ऐप्लिकेशन को Liftoff Monetize डैशबोर्ड में जोड़ें.

फ़ॉर्म भरें और उसमें सभी ज़रूरी जानकारी डालें.

Android

iOS

ऐप्लिकेशन बन जाने के बाद, Liftoff Monetize ऐप्लिकेशन डैशबोर्ड से अपना ऐप्लिकेशन चुनें.

Android

iOS

ऐप्लिकेशन आईडी को नोट करें.

Android

iOS

नए प्लेसमेंट जोड़ना

AdMob मीडिएशन (अलग-अलग नेटवर्क से विज्ञापन दिखाना) के साथ इस्तेमाल करने के लिए नया प्लेसमेंट बनाने के लिए, Liftoff Monetize Placements डैशबोर्ड पर जाएं. इसके बाद, प्लेसमेंट जोड़ें बटन पर क्लिक करें और ड्रॉप-डाउन सूची से अपना ऐप्लिकेशन चुनें.

नए प्लेसमेंट जोड़ने के बारे में जानकारी यहां दी गई है:

ऐप का खुलना

इंटरस्टीशियल चुनें और प्लेसमेंट का नाम डालें. इसके बाद, स्किप किया जा सकने वाला के लिए हां चुनें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

बैनर चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

300x250 बैनर

MREC चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

मध्यवर्ती

इंटरस्टीशियल चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

इनाम दिया गया

इनाम वाला विज्ञापन चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

इनाम वाला इंटरस्टीशियल विज्ञापन

इनाम वाले विज्ञापन को चुनें. प्लेसमेंट का नाम डालें, स्किप किया जा सकने वाला चालू करें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

मूल भाषा वाला

नेटिव चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

रेफ़रंस आईडी नोट करें और ठीक है पर क्लिक करें.

ऐप का खुलना

300x250 बैनर

मध्यवर्ती

इनाम वाले विज्ञापन

इनाम वाला इंटरस्टीशियल विज्ञापन

मूल भाषा वाला

अपना रिपोर्टिंग एपीआई पासकोड ढूंढना

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

वॉटरफ़ॉल

AdMob विज्ञापन यूनिट का आईडी सेट अप करने के लिए, आपको ऐप्लिकेशन आईडी और रेफ़रंस आईडी के साथ-साथ, Liftoff Monetize रिपोर्टिंग एपीआई पासकोड की भी ज़रूरत होगी. Liftoff Monetize Reports डैशबोर्ड पर जाएं और रिपोर्टिंग एपीआई पासकोड देखने के लिए, रिपोर्टिंग एपीआई पासकोड बटन पर क्लिक करें.

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

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

Liftoff Monetize के लिए app-ads.txt लागू करने के लिए, Liftoff Monetize की app-ads.txt एंट्री डाउनलोड करें और उन्हें अपनी मौजूदा app-ads.txt फ़ाइल में जोड़ें. ज़्यादा जानकारी के लिए, app-ads.txt देखें.

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

टेस्ट विज्ञापनों को चालू करने के लिए, Liftoff Monetize डैशबोर्ड पर जाएं और Applications पर जाएं.

अपने ऐप्लिकेशन के प्लेसमेंट रेफ़रंस आईडी सेक्शन में जाकर, वह ऐप्लिकेशन चुनें जिसके लिए आपको टेस्ट विज्ञापन चालू करने हैं. टेस्ट विज्ञापन चालू करने के लिए, स्टेटस सेक्शन में जाकर, टेस्ट मोड को सिर्फ़ टेस्ट विज्ञापन दिखाएं पर सेट करें.

Android

iOS

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

    npm

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

    ऊन

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

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

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

Liftoff Monetize React Native अडैप्टर का वर्शन लागू नहीं और इसके बाद के वर्शन, जीडीपीआर के तहत सहमति के सिग्नल को Liftoff Monetize SDK टूल को पास करने की सुविधा देते हैं. ये सिग्नल, IAB के पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) के साथ इंटिग्रेट किए गए सहमति मैनेजमेंट प्लैटफ़ॉर्म से पास किए जाते हैं. ज़्यादा जानकारी के लिए, Android और iOS के लिए, जीडीपीआर के सुझाए गए निर्देशों को लागू करने का तरीका देखें.

अमेरिका के निजता कानून

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

यहां दिए गए सैंपल कोड में, Liftoff Monetize अडैप्टर को सहमति की जानकारी मैन्युअल तरीके से भेजने का तरीका बताया गया है:

import { LiftoffMonetizeMediation } from '@google/gma-mediation-liftoffmonetize';
// ...

LiftoffMonetizeMediation.setCCPAStatus({ optedIn: true });

ज़्यादा जानकारी के लिए, सीसीपीए के तहत सुझाए गए तरीके को लागू करने के निर्देश देखें. ये निर्देश, Android और iOS के लिए उपलब्ध हैं. साथ ही, यह भी जानें कि इस तरीके में कौनसी वैल्यू दी जा सकती हैं.

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

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

Android

फ़ॉर्मैट क्लास का नाम
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (वॉटरफ़ॉल) com.google.ads.mediation.vungle.VungleMediationAdapter
बैनर (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
बैनर (वॉटरफ़ॉल) com.vungle.mediation.VungleInterstitialAdapter
इंटरस्टीशियल (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
इंटरस्टीशियल (वॉटरफ़ॉल) com.vungle.mediation.VungleInterstitialAdapter
इनाम वाला विज्ञापन (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
इनाम वाला विज्ञापन (वॉटरफ़ॉल) com.vungle.mediation.VungleAdapter
इनाम वाला इंटरस्टीशियल विज्ञापन (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
इनाम वाला इंटरस्टीशियल विज्ञापन (वॉटरफ़ॉल) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

फ़ॉर्मैट क्लास का नाम
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (बिडिंग) GADMediationAdapterVungle
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (वॉटरफ़ॉल) GADMediationAdapterVungle
बैनर (बिडिंग) GADMediationAdapterVungle
बैनर (वॉटरफ़ॉल) GADMAdapterVungleInterstitial
इंटरस्टीशियल (बिडिंग) GADMediationAdapterVungle
इंटरस्टीशियल (वॉटरफ़ॉल) GADMAdapterVungleInterstitial
इनाम वाला विज्ञापन (बिडिंग) GADMediationAdapterVungle
इनाम वाला विज्ञापन (वॉटरफ़ॉल) GADMAdapterVungleRewardBasedVideoAd
इनाम वाला इंटरस्टीशियल विज्ञापन (बिडिंग) GADMediationAdapterVungle
इनाम वाला इंटरस्टीशियल विज्ञापन (वॉटरफ़ॉल) GADMediationAdapterVungle

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

Android

गड़बड़ी का कोड वजह
101 सर्वर के पैरामीटर अमान्य हैं. जैसे, ऐप्लिकेशन आईडी या प्लेसमेंट आईडी.
102 अनुरोध किया गया बैनर साइज़, Liftoff Monetize के विज्ञापन के मान्य साइज़ से मेल नहीं खाता.
103 Liftoff Monetize को विज्ञापनों का अनुरोध करने के लिए, Activity कॉन्टेक्स्ट की ज़रूरत होती है.
104 Vungle SDK, एक ही प्लेसमेंट आईडी के लिए कई विज्ञापन लोड नहीं कर सकता.
105 Vungle SDK टूल शुरू नहीं हो सका.
106 Vungle SDK टूल ने लोड कॉलबैक की सूचना दी, लेकिन Banners.getBanner() या Vungle.getNativeAd() ने शून्य दिखाया.
107 Vungle SDK, विज्ञापन दिखाने के लिए तैयार नहीं है.
108 Vungle SDK ने अमान्य बिडिंग टोकन दिखाया.

iOS

गड़बड़ी का कोड वजह
101 सर्वर के पैरामीटर अमान्य हैं. जैसे, ऐप्लिकेशन आईडी या प्लेसमेंट आईडी.
102 इस नेटवर्क कॉन्फ़िगरेशन के लिए, पहले से ही एक विज्ञापन लोड है. Vungle SDK, एक ही प्लेसमेंट आईडी के लिए दूसरा विज्ञापन लोड नहीं कर सकता.
103 जिस विज्ञापन साइज़ का अनुरोध किया गया है वह Liftoff Monetize के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता है.
104 Vungle SDK, बैनर विज्ञापन को रेंडर नहीं कर सका.
105 Vungle SDK, एक बार में सिर्फ़ एक बैनर विज्ञापन लोड करता है. भले ही, प्लेसमेंट आईडी कुछ भी हो.
106 Vungle SDK ने एक कॉलबैक भेजा, जिसमें बताया गया कि विज्ञापन नहीं चलाया जा सकता.
107 Vungle SDK, विज्ञापन दिखाने के लिए तैयार नहीं है.

Vungle SDK से जुड़ी गड़बड़ियों के लिए, गड़बड़ी के कोड: iOS और Android के लिए Vungle SDK देखें.

वर्शन 0.1.0

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