इस गाइड में मीडिएशन की मदद से, 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 का एपीआई लेवल 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 मीडिएशन अडैप्टर चेंजलॉग
वर्शन 1.0.0
- शुरुआती रिलीज़.
- Liftoff Monetize Android अडैप्टर वर्शन 7.3.1.0 के साथ काम करने की पुष्टि
- इस बात की पुष्टि की गई है कि LiftoffMonetize iOS अडैप्टर वर्शन 7.3.2.0 के साथ काम करता है या नहीं
- इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.1.0 की मदद से बनाया और टेस्ट किया गया है.