इस गाइड में बताया गया है कि मीडिएशन की मदद से, Liftoff Monetize से विज्ञापन दिखाने और लोड करने के लिए, Google Mobile Ads SDK का इस्तेमाल कैसे करें. इसमें बिडिंग और वॉटरफ़ॉल इंटिग्रेशन, दोनों का इस्तेमाल किया जाता है. इसमें किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Liftoff Monetize जोड़ने का तरीका बताया गया है. साथ ही, Vungle SDK टूल और अडैप्टर को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका भी बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | |
| फ़ॉर्मैट | |
| ऐप का खुलना | 1, 3 |
| बैनर | 2 |
| मध्यवर्ती | |
| इनाम दिया गया | |
| इनाम वाले इंटरस्टीशियल विज्ञापन | 2 |
1 इस फ़ॉर्मैट के लिए बिडिंग का इंटिग्रेशन, क्लोज़्ड बीटा वर्शन में है.
2 इस फ़ॉर्मैट के लिए बिडिंग का इंटिग्रेशन, ओपन बीटा वर्शन में उपलब्ध है.
3 इस फ़ॉर्मैट के लिए वॉटरफ़ॉल इंटिग्रेशन, क्लोज़्ड बीटा वर्शन में है.
ज़रूरी शर्तें
- नया Google Mobile Ads SDK
- Flutter 3.7.0 या इसके बाद का वर्शन
- Android पर डिप्लॉय करने के लिए
- Android API (एपीआई) लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट टारगेट, 12.0 या इसके बाद का होना चाहिए
- Google Mobile Ads SDK की मदद से कॉन्फ़िगर किया गया एक चालू प्रोजेक्ट, Flutter ज़्यादा जानकारी के लिए, शुरू करें देखें.
- मीडिएशन को पूरा करें शुरुआती निर्देश
पहला चरण: Liftoff Monetize यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करें
अपने LiftoffMonetize खाते में साइन अप करें या लॉग इन करें.
ऐप्लिकेशन जोड़ें बटन पर क्लिक करके, अपने ऐप्लिकेशन को Liftoff Monetize डैशबोर्ड में जोड़ें.
सभी ज़रूरी जानकारी डालकर फ़ॉर्म भरें.
Android
iOS
अपना ऐप्लिकेशन बन जाने के बाद, Liftoff Monetize ऐप्लिकेशन डैशबोर्ड से अपना ऐप्लिकेशन चुनें.
Android
iOS
ऐप्लिकेशन आईडी को ध्यान में रखें.
Android
iOS
नए प्लेसमेंट जोड़ें
मीडिएशन के साथ इस्तेमाल करने के लिए AdMob नया प्लेसमेंट बनाने के लिए, Liftoff Monetize प्लेसमेंट डैशबोर्ड पर जाएं. इसके बाद, प्लेसमेंट जोड़ें बटन पर क्लिक करें और ड्रॉप-डाउन सूची से अपना ऐप्लिकेशन चुनें.
नए प्लेसमेंट जोड़ने के विवरण नीचे दिए गए हैं:
ऐप का खुलना
अचानक दिखने वाला (इंटरस्टीशियल) विज्ञापन चुनें और प्लेसमेंट का नाम डालें. इसके बाद, स्किप किया जा सकने वाला के लिए हां चुनें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे जारी रखें पर क्लिक करें.
बैनर
बैनर चुनें और प्लेसमेंट का नाम डालें और फ़ॉर्म का बाकी हिस्सा भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
300x250 बैनर
MREC चुनें, प्लेसमेंट का नाम डालें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
मध्यवर्ती
अचानक दिखने वाला (इंटरस्टीशियल) विज्ञापन चुनें, प्लेसमेंट का नाम डालें और फ़ॉर्म का बाकी हिस्सा भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे जारी रखें बटन पर क्लिक करें.
इनाम दिया गया
इनाम वाले विज्ञापन चुनें और प्लेसमेंट का नाम डालें और फ़ॉर्म का बाकी हिस्सा भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
इनाम वाले इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन चुनें. प्लेसमेंट का नाम डालें, स्किप किया जा सकने वाला चालू करें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग की सुविधा को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे जारी रखें बटन पर क्लिक करें.
नेटिव लेआउट
नेटिव चुनें और प्लेसमेंट का नाम डालें और फ़ॉर्म का बाकी हिस्सा भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.
रेफ़रंस आईडी नोट करें और अच्छा लग रहा है पर क्लिक करें.
ऐप का खुलना
बैनर
300x250 बैनर
मध्यवर्ती
इनाम दिया गया
इनाम वाले इंटरस्टीशियल विज्ञापन
नेटिव लेआउट
अपनी Reporting API Key का पता लगाना
बिडिंग
बिडिंग इंटिग्रेशन के लिए यह चरण ज़रूरी नहीं है.
वॉटरफ़ॉल
ऐप्लिकेशन आईडी और रेफ़रंस आईडी के अलावा, आपको अपनी AdMob विज्ञापन यूनिट का आईडी सेट अप करने के लिए, Liftoff Monetize Reporting API की भी ज़रूरत होगी. Liftoff Monetize Report डैशबोर्ड पर जाएं और Reporting API Key को देखने के लिए, Reporting API कुंजी पर क्लिक करें.
टेस्ट मोड चालू करें
टेस्ट विज्ञापनों को चालू करने के लिए, अपने Liftoff Monetize डैशबोर्ड पर जाएं और Applications पर जाएं.
अपना ऐप्लिकेशन चुनें जिसके लिए आप अपने ऐप्लिकेशन के प्लेसमेंट रेफ़रंस आईडी सेक्शन में जाकर, टेस्ट विज्ञापन चालू करना चाहते हैं. टेस्ट विज्ञापनों को चालू करने के लिए, स्टेटस सेक्शन में सिर्फ़ टेस्ट विज्ञापन दिखाएं में टेस्ट मोड चुनें.
Android
iOS
दूसरा चरण: यूज़र इंटरफ़ेस (यूआई) में AdMob लिफ़्ट से कमाई करने की मांग सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.
जीडीपीआर और अमेरिका के कानूनों के तहत, विज्ञापन पार्टनर की सूची में Liftoff जोड़ें
जीडीपीआर सेटिंग और अमेरिका के कानूनों के बारे में सेटिंग में दिया गया तरीका अपनाएं, ताकि Liftoff को जीडीपीआर और अमेरिका के कानूनों के बारे में बताने वाली विज्ञापन पार्टनर सूची में AdMob यूज़र इंटरफ़ेस (यूआई) जोड़ा जा सके.
तीसरा चरण: 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 के दस्तावेज़
का पालन करें.
छठा चरण: लागू होने की जांच करना
टेस्ट विज्ञापनों को चालू करें
पक्का करें कि आपनेके लिए अपना टेस्ट डिवाइस रजिस्टर किया हो और Liftoff Monetize यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो. AdMob
टेस्ट विज्ञापनों की पुष्टि करें
यह पुष्टि करने के लिए कि Liftoff Monetizeसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.
गड़बड़ी कोड
अगर अडैप्टर को Liftoff Monetize से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास में ResponseInfo का इस्तेमाल करके, विज्ञापन के रिस्पॉन्स में दिख रही गड़बड़ी की जांच कर सकते हैं:
iOS
| फ़ॉर्मैट | कक्षा का नाम |
|---|---|
| बैनर | GADMAdapterVungleInterstitial |
| मध्यवर्ती | GADMAdapterVungleInterstitial |
| इनाम दिया गया | GADMAdapterVungleRewardहरवीडियो विज्ञापन |
जब कोई विज्ञापन लोड नहीं हो पाता है, तो Liftoff Monetize एडाप्टर का इस्तेमाल करता है, तो वह कोड और उससे जुड़े मैसेज यहां दिखाता है:
iOS
| गड़बड़ी का कोड | वजह |
|---|---|
| 1-100 | Vungle SDK टूल में कोई गड़बड़ी मिली है. ज़्यादा जानकारी के लिए, कोड देखें. |
| 101 | AdMob यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए Liftoff Monetize के सर्वर के पैरामीटर मौजूद नहीं हैं/अमान्य हैं. |
| 102 | इस नेटवर्क कॉन्फ़िगरेशन के लिए एक विज्ञापन पहले से लोड है. Vungle SDK टूल, एक ही प्लेसमेंट आईडी के लिए दूसरा विज्ञापन लोड नहीं कर सकता. |
| 103 | विज्ञापन का अनुरोध किया गया आकार Liftoff Monetize के साथ काम करने वाले बैनर के आकार से मेल नहीं खाता. |
| 104 | Vungle SDK टूल, बैनर विज्ञापन को रेंडर नहीं कर सका. |
| 105 | Vungle SDK टूल, एक बार में सिर्फ़ एक बैनर विज्ञापन लोड करने की सुविधा देता है. भले ही, प्लेसमेंट आईडी कुछ भी हो. |
| 106 | Vungle SDK टूल ने कॉलबैक भेजकर बताया कि विज्ञापन चलाया नहीं जा सकता. |
Liftoff Monetize Flutter Mediation Adapter बदलावलॉग
वर्शन 1.0.0
- शुरुआती रिलीज़.
- Liftoff Monetize Android अडैप्टर के 7.3.1.0 वर्शन के साथ काम करने की पुष्टि की गई
- LiftoffMonetize के iOS अडैप्टर के 7.3.2.0 वर्शन के साथ काम करने की पुष्टि की गई
- Google Mobile Ads Flutter प्लगिन के 5.1.0 वर्शन से बनाया और टेस्ट किया गया.