इस गाइड में, मीडिएशन का इस्तेमाल करके, Liftoff Monetize से विज्ञापन लोड करने और दिखाने के लिए, Google Mobile Ads SDK टूल का इस्तेमाल करने का तरीका बताया गया है. इसमें बिडिंग और वॉटरफ़ॉल इंटिग्रेशन, दोनों के बारे में बताया गया है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Liftoff Monetize जोड़ने का तरीका बताया गया है. साथ ही, Flutter ऐप्लिकेशन में Vungle SDK टूल और अडैप्टर को इंटिग्रेट करने का तरीका भी बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| झरना | |
| फ़ॉर्मैट | |
| ऐप का खुलना | 1, 2 |
| बैनर | 1 |
| मध्यवर्ती | |
| इनाम दिया गया | |
| इनाम वाला इंटरस्टीशियल विज्ञापन | 1 |
| मूल भाषा वाला | 1, 2 |
1 इस फ़ॉर्मैट के लिए, बिडिंग इंटिग्रेशन का ओपन बीटा वर्शन उपलब्ध है.
इस फ़ॉर्मैट के लिए, 2 वॉटरफ़ॉल इंटिग्रेशन का ओपन बीटा वर्शन उपलब्ध है.
ज़रूरी शर्तें
- Google Mobile Ads SDK का सबसे नया वर्शन
- Flutter 3.7.0 या इसके बाद का वर्शन
- [बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, AppLovin 5.1.0 या उसके बाद के वर्शन के लिए Google Mobile Ads मीडिएशन प्लग इन का इस्तेमाल करें (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)
- Android पर डिप्लॉय करने के लिए
- Android एपीआई लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
- Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया, काम करने वाला Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
- मीडिएशन पूरा करें शुरुआती निर्देशों की गाइड
पहला चरण: Liftoff Monetize के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
अपने Liftoff Monetize खाते में साइन अप करें या लॉग इन करें.
ऐप्लिकेशन जोड़ें बटन पर क्लिक करके, अपने ऐप्लिकेशन को Liftoff के कमाई करने वाले डैशबोर्ड में जोड़ें.
सभी ज़रूरी जानकारी डालकर फ़ॉर्म भरें.
ऐप्लिकेशन बनाने के बाद, Liftoff Monetize ऐप्लिकेशन डैशबोर्ड से अपना ऐप्लिकेशन चुनें.
ऐप्लिकेशन आईडी को नोट करें.
नए प्लेसमेंट जोड़ना
AdMob मीडिएशन के साथ इस्तेमाल करने के लिए नया प्लेसमेंट बनाने के लिए, Liftoff Monetize प्लेसमेंट डैशबोर्ड पर जाएं. इसके बाद, प्लेसमेंट जोड़ें बटन पर क्लिक करें और ड्रॉप-डाउन सूची से अपना ऐप्लिकेशन चुनें.
नए प्लेसमेंट जोड़ने के बारे में जानकारी यहां दी गई है:
इंटरस्टीशियल चुनें और प्लेसमेंट का नाम डालें. इसके बाद, स्किप किया जा सकता है के लिए हां चुनें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
बैनर चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
एमआरईसी चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
इंटरस्टीशियल चुनें, प्लेसमेंट का नाम डालें, और फ़ॉर्म का बाकी हिस्सा भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
इनाम चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
इनाम चुनें. प्लेसमेंट का नाम डालें, स्किप किया जा सकता है को चालू करें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
नेटिव चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
रेफ़रंस आईडी को नोट करें और ठीक है पर क्लिक करें.
अपना Reporting API पासकोड ढूंढना
बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.
AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, आपको ऐप्लिकेशन आईडी और रेफ़रंस आईडी के साथ-साथ, अपनी Liftoff Monetize रिपोर्टिंग एपीआई पासकोड की भी ज़रूरत होगी. रिपोर्टिंग एपीआई पासकोड देखने के लिए, Liftoff Monetize के रिपोर्ट डैशबोर्ड पर जाएं और रिपोर्टिंग एपीआई पासकोड बटन पर क्लिक करें.
टेस्ट मोड चालू करना
टेस्ट विज्ञापन चालू करने के लिए, अपने Liftoff Monetize डैशबोर्ड पर जाएं और ऐप्लिकेशन पर जाएं.
अपने ऐप्लिकेशन के प्लेसमेंट रेफ़रंस आईडी सेक्शन में जाकर, वह ऐप्लिकेशन चुनें जिसके लिए आपको टेस्ट विज्ञापन दिखाने की सुविधा चालू करनी है. टेस्ट विज्ञापन दिखाने की सुविधा चालू करने के लिए, स्थिति सेक्शन में जाकर, सिर्फ़ टेस्ट विज्ञापन दिखाएं के लिए टेस्ट मोड को चुनें.
दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में, Liftoff Monetize demand को सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
निर्देशों के लिए, Android के लिए बनी गाइड में दूसरा चरण देखें.
निर्देशों के लिए, iOS के लिए बनी गाइड में दूसरा चरण देखें.
जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Liftoff को जोड़ना
AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Liftoff जोड़ने के लिए, यूरोप के कानूनों की सेटिंग और अमेरिका के कानूनों की सेटिंग में दिया गया तरीका अपनाएं.
तीसरा चरण: Vungle SDK टूल और Liftoff Monetize अडैप्टर इंपोर्ट करना
pub.dev की मदद से इंटिग्रेशन करना
अपने पैकेज की pubspec.yaml फ़ाइल में, Liftoff Monetize SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_liftoffmonetize: ^1.1.0
मैन्युअल इंटिग्रेशन
Liftoff Monetize के लिए, Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को निकालें और निकाले गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लग इन का रेफ़रंस दें. इसके लिए, यहां दी गई डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
चौथा चरण: Liftoff Monetize SDK टूल पर निजता सेटिंग लागू करना
ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर
Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति के तहत, आपको यह पक्का करना होगा कि डिवाइस आइडेंटिफ़ायर और निजी डेटा के इस्तेमाल के बारे में, यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले उपयोगकर्ताओं को कुछ जानकारी दी गई हो और उनसे सहमति ली गई हो. इस नीति में, ईयू के ई-निजता निर्देश और सामान्य डेटा से जुड़े सुरक्षा कानून जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. सहमति मांगते समय, आपको अपनी मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी डेटा इकट्ठा कर सकता है, पा सकता है या इस्तेमाल कर सकता है. साथ ही, आपको हर नेटवर्क के इस्तेमाल के बारे में जानकारी देनी होगी. फ़िलहाल, Google ऐसे नेटवर्क पर उपयोगकर्ता की सहमति की जानकारी अपने-आप नहीं भेज सकता.
Liftoff Monetize के लिए Google Mobile Ads मीडिएशन प्लग इन में,
GmaMediationLiftoffmonetize.setGDPRStatus() तरीका शामिल है. यहां दिए गए सैंपल कोड में, Vungle SDK टूल को सहमति की जानकारी भेजने का तरीका बताया गया है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK की मदद से विज्ञापनों का अनुरोध करने से पहले, इसे आज़माएं.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, जीडीपीआर के सुझाए गए Android और iOS के लिए, लागू करने के निर्देश देखें.
अमेरिका के निजता कानून
अमेरिका के राज्यों के निजता कानून के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" की "बिक्री" से ऑप्ट आउट करने का अधिकार देना ज़रूरी है. इससे जुड़ी शर्तों के बारे में इस कानून में साफ़ तौर पर बताया गया है. "बिक्री करने वाले" पक्ष को अपने होम पेज पर, ऑप्ट आउट के लिए "मेरी निजी जानकारी न बेचें" लिंक देना ज़रूरी है. अमेरिका के निजता कानूनों का पालन करने के लिए बनी गाइड में, Google की विज्ञापन सेवा के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा दी गई है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर यह सेटिंग लागू नहीं कर सकता. इसलिए, आपको अपनी मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकता है. साथ ही, नीति का पालन करने के लिए, उन सभी नेटवर्क के दिशा-निर्देशों का पालन करना होगा.
Liftoff Monetize के लिए Google Mobile Ads मीडिएशन प्लग इन में,
GmaMediationLiftoffmonetize.setCCPAStatus() तरीका शामिल है. यहां दिए गए सैंपल कोड में, Vungle SDK टूल को सहमति की जानकारी देने का तरीका बताया गया है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK की मदद से विज्ञापनों का अनुरोध करने से पहले, इसे आज़माएं.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, सीसीपीए के तहत, Android और iOS के लिए सुझाए गए निर्देश देखें.
पांचवां चरण: ज़रूरी कोड जोड़ना
Liftoff Monetize इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं है.
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, Liftoff Monetize के दस्तावेज़ का पालन करें.
छठा चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापन चालू करना
पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, Liftoff Monetize के यूज़र इंटरफ़ेस (यूआई) में, टेस्ट मोड चालू किया हो.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको Liftoff Monetize से टेस्ट विज्ञापन मिल रहे हैं या नहीं, विज्ञापन जांचने वाले टूल में Liftoff Monetize (बिडिंग) और Liftoff Monetize (वॉटरफ़ॉल) विज्ञापन स्रोत का इस्तेमाल करके, विज्ञापन के किसी एक स्रोत की जांच करने की सुविधा चालू करें.
गड़बड़ी के कोड
अगर अडैप्टर को Liftoff Monetize से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास में ResponseInfo का इस्तेमाल करके, विज्ञापन के जवाब से जुड़ी गड़बड़ी की जांच कर सकते हैं:
| फ़ॉर्मैट | कक्षा का नाम |
|---|---|
| ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (बिडिंग) | 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 |
| फ़ॉर्मैट | कक्षा का नाम |
|---|---|
| ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (बिडिंग) | GADMediationAdapterVungle |
| ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (वॉटरफ़ॉल) | GADMediationAdapterVungle |
| बैनर (बिडिंग) | GADMediationAdapterVungle |
| बैनर (वॉटरफ़ॉल) | GADMAdapterVungleInterstitial |
| इंटरस्टीशियल (बिडिंग) | GADMediationAdapterVungle |
| इंटरस्टीशियल (वॉटरफ़ॉल) | GADMAdapterVungleInterstitial |
| इनाम वाले विज्ञापन (बिडिंग) | GADMediationAdapterVungle |
| इनाम वाला (वॉटरफ़ॉल) | GADMAdapterVungleRewardBasedVideoAd |
| इनाम वाला इंटरस्टीशियल (बिडिंग) | GADMediationAdapterVungle |
| इनाम वाला इंटरस्टीशियल (वॉटरफ़ॉल) | GADMediationAdapterVungle |
जब कोई विज्ञापन लोड नहीं होता है, तो Liftoff Monetize ऐडैप्टर से मिलने वाले कोड और मैसेज यहां दिए गए हैं:
| गड़बड़ी का कोड | कारण |
|---|---|
| 101 | सर्वर पैरामीटर अमान्य हैं. जैसे, ऐप्लिकेशन आईडी या प्लेसमेंट आईडी. |
| 102 | अनुरोध किया गया बैनर साइज़, Liftoff Monetize के किसी मान्य विज्ञापन साइज़ से मैप नहीं होता. |
| 103 | विज्ञापनों का अनुरोध करने के लिए, Liftoff Monetize को Activity कॉन्टेक्स्ट की ज़रूरत होती है. |
| 104 | Vungle SDK टूल, एक ही प्लेसमेंट आईडी के लिए कई विज्ञापन लोड नहीं कर सकता. |
| 105 | Vungle SDK टूल को शुरू नहीं किया जा सका. |
| 106 | Vungle SDK टूल ने लोड होने का कॉलबैक दिखाया, लेकिन Banners.getBanner() या Vungle.getNativeAd() ने null दिखाया. |
| 107 | Vungle SDK, विज्ञापन चलाने के लिए तैयार नहीं है. |
| 108 | Vungle SDK टूल से अमान्य बिडिंग टोकन मिला. |
| गड़बड़ी का कोड | कारण |
|---|---|
| 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 टूल देखें.
Liftoff Monetize Flutter मीडिएशन अडैप्टर में हुए बदलावों का लॉग
1.1.0
- iOS प्लगिन अब एक स्टैटिक फ़्रेमवर्क है.
- Liftoff Monetize के Android अडैप्टर के 7.4.3.0 वर्शन के साथ काम करने की पुष्टि की गई है
- Liftoff Monetize के iOS अडैप्टर के 7.4.4.0 वर्शन के साथ काम करने की पुष्टि की गई
- Google Mobile Ads Flutter प्लग इन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया.
1.0.0
- शुरुआती रिलीज़.
- Liftoff Monetize के Android अडैप्टर के 7.3.1.0 वर्शन के साथ काम करने की पुष्टि की गई है
- LiftoffMonetize के iOS अडैप्टर के 7.3.2.0 वर्शन के साथ काम करने की पुष्टि की गई
- Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.