इस गाइड में, मीडिएशन का इस्तेमाल करके, Liftoff Monetize से विज्ञापन लोड करने और दिखाने के लिए, Google Mobile Ads SDK टूल का इस्तेमाल करने का तरीका बताया गया है. इसमें बिडिंग और वॉटरफ़ॉल इंटिग्रेशन, दोनों के बारे में बताया गया है. इस लेख में, Liftoff Monetize को किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में जोड़ने का तरीका बताया गया है. साथ ही, Vungle SDK और अडैप्टर को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका भी बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
इंटिग्रेशन | |
---|---|
बिडिंग | |
झरना | |
फ़ॉर्मैट | |
ऐप का खुलना | 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 Monetize डैशबोर्ड में जोड़ें.
सभी ज़रूरी जानकारी डालकर फ़ॉर्म भरें.
Android
iOS
जब आपका ऐप्लिकेशन बन जाए, तो Liftoff Monetize Applications डैशबोर्ड से अपना ऐप्लिकेशन चुनें.
Android
iOS
ऐप्लिकेशन आईडी को नोट कर लें.
Android
iOS
नए प्लेसमेंट जोड़ें
AdMob मीडिएशन के साथ इस्तेमाल करने के लिए नया प्लेसमेंट बनाने के लिए, Liftoff के प्लेसमेंट से कमाई करने वाले डैशबोर्ड पर जाएं. इसके बाद, प्लेसमेंट जोड़ें बटन पर क्लिक करें और ड्रॉप-डाउन सूची से अपना ऐप्लिकेशन चुनें.
नए प्लेसमेंट जोड़ने के बारे में जानकारी यहां दी गई है:
ऐप का खुलना
अचानक दिखने वाला (इंटरस्टीशियल) विकल्प चुनें और प्लेसमेंट का नाम डालें. इसके बाद, स्किप किए जा सकने वाले के लिए हां चुनें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
बैनर
बैनर चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
300x250 बैनर
MREC चुनें, प्लेसमेंट का नाम डालें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज के सबसे नीचे जारी रखें बटन पर क्लिक करें.
मध्यवर्ती
इंटरस्टीशियल चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
इनाम दिया गया
इनाम वाले विज्ञापन को चुनें, प्लेसमेंट का नाम डालें और बाकी बचा फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज के सबसे नीचे जारी रखें बटन पर क्लिक करें.
इनाम वाले इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन को चुनें. प्लेसमेंट का नाम डालें, स्किप किया जा सकता है को चालू करें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
मूल भाषा वाला
नेटिव चुनें, प्लेसमेंट का नाम डालें, और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज के सबसे नीचे जारी रखें बटन पर क्लिक करें.
रेफ़रंस आईडी को नोट करें और ठीक है पर क्लिक करें.
ऐप का खुलना
बैनर
300x250 बैनर
मध्यवर्ती
इनाम दिया गया
इनाम वाले इंटरस्टीशियल विज्ञापन
मूल भाषा वाला
Reporting API पासकोड का पता लगाना
बिडिंग
बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.
झरना
अपना AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, ऐप्लिकेशन आईडी और रेफ़रंस आईडी के साथ-साथ, आपको Liftoff Monetize Reporting API पासकोड की ज़रूरत होगी. रिपोर्टिंग एपीआई पासकोड देखने के लिए, Liftoff Monetize के रिपोर्ट डैशबोर्ड पर जाएं और रिपोर्टिंग एपीआई पासकोड बटन पर क्लिक करें.
टेस्ट मोड चालू करें
टेस्ट विज्ञापनों को चालू करने के लिए, Liftoff Monetize डैशबोर्ड पर जाएं और Applications पर जाएं.
अपने ऐप्लिकेशन के प्लेसमेंट रेफ़रंस आईडी सेक्शन में जाकर, वह ऐप्लिकेशन चुनें जिसके लिए आपको टेस्ट विज्ञापन दिखाने की सुविधा चालू करनी है. टेस्ट विज्ञापन दिखाने की सुविधा चालू करने के लिए, स्थिति सेक्शन में जाकर, सिर्फ़ टेस्ट विज्ञापन दिखाएं के लिए टेस्ट मोड को चुनें.
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
मैन्युअल इंटिग्रेशन
इसके लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन का सबसे नया वर्शन डाउनलोड करें
Liftoff Monetize,
डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें और एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर को जोड़ें
(और इसकी सामग्री) को आपके 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 के दस्तावेज़ का पालन करें.
छठा चरण: लागू होने की जांच करना
टेस्ट विज्ञापनों को चालू करें
पक्का करें कि आपनेके लिए अपना टेस्ट डिवाइस रजिस्टर किया हो और Liftoff Monetize यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो. AdMob
टेस्ट विज्ञापनों की पुष्टि करें
यह पुष्टि करने के लिए कि Liftoff Monetizeसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.
गड़बड़ी कोड
अगर अडैप्टर को 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 की मदद से बनाया और टेस्ट किया गया है.