इस गाइड में, मीडिएशन का इस्तेमाल करके, 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 या इसके बाद का वर्शन
- Android पर डिप्लॉय करने के लिए
- Android एपीआई लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
- Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया, काम करने वाला Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
- मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड
पहला चरण: Liftoff Monetize के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
अपने Liftoff Monetize खाते में साइन अप करें या लॉग इन करें.
ऐप्लिकेशन जोड़ें बटन पर क्लिक करके, अपने ऐप्लिकेशन को Liftoff के कमाई करने वाले डैशबोर्ड में जोड़ें.
सभी ज़रूरी जानकारी डालकर फ़ॉर्म भरें.
Android
iOS
जब आपका ऐप्लिकेशन बन जाए, तो Liftoff Monetize Applications डैशबोर्ड से अपना ऐप्लिकेशन चुनें.
Android
iOS
ऐप्लिकेशन आईडी को नोट करें.
Android
iOS
नए प्लेसमेंट जोड़ना
AdMob मीडिएशन के साथ इस्तेमाल करने के लिए नया प्लेसमेंट बनाने के लिए, Liftoff के प्लेसमेंट से कमाई करने वाले डैशबोर्ड पर जाएं. इसके बाद, प्लेसमेंट जोड़ें बटन पर क्लिक करें और ड्रॉप-डाउन सूची से अपना ऐप्लिकेशन चुनें.
नए प्लेसमेंट जोड़ने का विवरण नीचे दिया गया है:
ऐप का खुलना
अचानक दिखने वाला (इंटरस्टीशियल) विकल्प चुनें और प्लेसमेंट का नाम डालें. इसके बाद, स्किप किए जा सकने वाले के लिए हां चुनें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
बैनर
बैनर चुनें, प्लेसमेंट का नाम डालें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
300x250 बैनर
MREC चुनें, प्लेसमेंट का नाम डालें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज के सबसे नीचे जारी रखें बटन पर क्लिक करें.
मध्यवर्ती
इंटरस्टीशियल चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
इनाम दिया गया
इनाम चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
इनाम वाला इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन को चुनें. प्लेसमेंट का नाम डालें, स्किप किया जा सकता है को चालू करें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
मूल भाषा वाला
नेटिव चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज के सबसे नीचे जारी रखें बटन पर क्लिक करें.
रेफ़रंस आईडी को नोट करें और अच्छा लग रहा है पर क्लिक करें.
ऐप का खुलना
बैनर
300x250 बैनर
मध्यवर्ती
इनाम दिया गया
इनाम वाला इंटरस्टीशियल विज्ञापन
मूल भाषा वाला
अपना Reporting API पासकोड ढूंढना
बिडिंग
बिडिंग इंटिग्रेशन के लिए, ऐसा करना ज़रूरी नहीं है.
झरना
AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, आपको ऐप्लिकेशन आईडी और रेफ़रंस आईडी के साथ-साथ, अपनी Liftoff Monetize रिपोर्टिंग एपीआई पासकोड की भी ज़रूरत होगी. रिपोर्टिंग एपीआई पासकोड देखने के लिए, Liftoff Monetize के रिपोर्ट डैशबोर्ड पर जाएं और रिपोर्टिंग एपीआई पासकोड बटन पर क्लिक करें.
टेस्ट मोड चालू करें
टेस्ट विज्ञापनों को चालू करने के लिए, अपने Liftoff Monetize डैशबोर्ड पर जाएं और ऐप्लिकेशन पर जाएं.
अपने ऐप्लिकेशन के प्लेसमेंट रेफ़रंस आईडी सेक्शन में जाकर, वह ऐप्लिकेशन चुनें जिसके लिए आपको टेस्ट विज्ञापन दिखाने की सुविधा चालू करनी है. टेस्ट विज्ञापन दिखाने की सुविधा चालू करने के लिए, स्थिति सेक्शन में जाकर, सिर्फ़ टेस्ट विज्ञापन दिखाएं के लिए टेस्ट मोड को चुनें.
Android
iOS
दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में, Liftoff Monetize demand सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.
जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Liftoff जोड़ें
AdMob के यूज़र इंटरफ़ेस (यूआई) में, जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Liftoff जोड़ने के लिए, जीडीपीआर सेटिंग और अमेरिका के कानूनों की सेटिंग में दिया गया तरीका अपनाएं.
तीसरा चरण: Vungle SDK टूल और Liftoff Monetize अडैप्टर इंपोर्ट करना
pub.dev के ज़रिए इंटिग्रेशन
अपने पैकेज की pubspec.yaml फ़ाइल में,Liftoff Monetize SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.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 के लिए सुझाए गए निर्देश देखें.
पांचवां चरण: ज़रूरी कोड जोड़ना
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() ने null दिखाया. |
| 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 टूल देखें.
Liftoff Monetize Flutter मीडिएशन अडैप्टर में हुए बदलावों का लॉग
अगला वर्शन
- इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.2.0 की मदद से बनाया और टेस्ट किया गया है.
वर्शन 1.1.0
- Liftoff Monetize के Android अडैप्टर के 7.4.0.1 वर्शन के साथ काम करने की पुष्टि की गई
- LiftoffMonetize के iOS अडैप्टर के 7.4.0.1 वर्शन के साथ काम करने की पुष्टि की गई
- Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.
वर्शन 1.0.0
- शुरुआती रिलीज़.
- Liftoff Monetize के Android अडैप्टर के 7.3.1.0 वर्शन के साथ काम करने की पुष्टि की गई है
- LiftoffMonetize के iOS अडैप्टर के 7.3.2.0 वर्शन के साथ काम करने की पुष्टि की गई
- इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.1.0 की मदद से बनाया और टेस्ट किया गया है.