इस गाइड में, मीडिएशन का इस्तेमाल करके, AppLovin से विज्ञापन लोड करने और दिखाने के लिए, Google Mobile Ads SDK टूल का इस्तेमाल करने का तरीका बताया गया है. इसमें बिडिंग और वॉटरफ़ॉल इंटिग्रेशन, दोनों के बारे में बताया गया है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में AppLovin को जोड़ने का तरीका बताया गया है. साथ ही, AppLovin SDK टूल और अडैप्टर को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका भी बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
AppLovin के AdMob मीडिएशन अडैप्टर में ये काम किए जा सकते हैं:
इंटिग्रेशन | |
---|---|
बिडिंग | |
झरना | |
फ़ॉर्मैट | |
बैनर | 1 |
मध्यवर्ती | |
इनाम दिया गया |
बैनर विज्ञापन सिर्फ़ मीडिएशन में काम करते हैं. हालांकि, MREC बैनर के साथ काम नहीं करता. बिडिंग में किसी भी तरह के बैनर विज्ञापन का इस्तेमाल नहीं किया जा सकता.
ज़रूरी शर्तें
- Google Mobile Ads SDK का सबसे नया वर्शन
- Flutter 3.7.0 या इसके बाद का वर्शन
- Android पर डिप्लॉय करने के लिए
- Android का एपीआई लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS 12.0 या इसके बाद का डिप्लॉयमेंट टारगेट
- Google के मोबाइल विज्ञापन SDK टूल के साथ कॉन्फ़िगर किया गया Flutter एक काम कर रहा प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें देखें.
- मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड
पहला चरण: AppLovin यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करें
अपने AppLovin खाते में साइन अप करें या लॉग इन करें.
AdMob विज्ञापन यूनिट सेट अप करने के लिए, आपको AppLovin SDK पासकोड और रिपोर्ट पासकोड की ज़रूरत होगी. इन्हें ढूंढने के लिए, AppLovin यूज़र इंटरफ़ेस (यूआई) > खाता > बटन पर जाएं और दोनों वैल्यू देखें.
अगर आपको सिर्फ़ बिडिंग को इंटिग्रेट करना है, तो मीडिएशन सेटिंग कॉन्फ़िगर करें.
मीडिएशन के लिए ऐप्लिकेशन चुनें
बिडिंग
बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.
झरना
AppLovin यूज़र इंटरफ़ेस (यूआई) पर, रजिस्टर किए गए अपने ऐप्लिकेशन पर जाने के लिए, कमाई करना सेक्शन में जाकर ऐप्लिकेशन चुनें. उपलब्ध ऐप्लिकेशन की सूची से, वह ऐप्लिकेशन चुनें जिसका आपको मीडिएशन के साथ इस्तेमाल करना है.
एक क्षेत्र बनाएं
बिडिंग
बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.
झरना
रजिस्टर किए गए ज़ोन आईडी देखने के लिए, AppLovin यूज़र इंटरफ़ेस (यूआई) पर, कमाई करना सेक्शन में जाकर ज़ोन चुनें. अगर आपने अपने ऐप्लिकेशन के लिए पहले ही ज़रूरी ज़ोन बना लिए हैं, तो सीधे दूसरे चरण पर जाएं. नया ज़ोन आईडी बनाने के लिए, ज़ोन बनाएं पर क्लिक करें.
ज़ोन आईडी का नाम डालें. इसके बाद, प्लैटफ़ॉर्म के तौर पर Android चुनें और विज्ञापन टाइप चुनें.
सीपीएम या AppLovin की ओर से ऑप्टिमाइज़ की गई में से किसी एक को चुनकर, ज़ोन के लिए कीमत कॉन्फ़िगर करें. फ़्लैट सीपीएम विकल्प के लिए, सीपीएम को हर देश के हिसाब से कॉन्फ़िगर किया जा सकता है. इसके बाद, सेव करें पर क्लिक करें.
Android
iOS
ज़ोन बन जाने के बाद, ज़ोन आईडी कॉलम में ज़ोन आईडी देखा जा सकता है.
Android
iOS
टेस्ट मोड चालू करें
AppLovin के टेस्ट विज्ञापनों को चालू करने के तरीके के बारे में जानने के लिए, AppLovin के MAX टेस्ट मोड की गाइड में दिए गए निर्देशों का पालन करें.
दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में AppLovin की मांग सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.
AppLovin Corp. को जीडीपीआर और अमेरिका के कानूनों के तहत आने वाले विज्ञापन पार्टनर की सूची में जोड़ें
AdMob के यूज़र इंटरफ़ेस (यूआई) में, जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Applovin Corp. को जोड़ने के लिए, जीडीपीआर सेटिंग और अमेरिका के कानूनों की सेटिंग में दिया गया तरीका अपनाएं.
तीसरा चरण: AppLovin SDK टूल और अडैप्टर इंपोर्ट करना
pub.dev की मदद से इंटिग्रेशन
अपने पैकेज की pubspec.yaml
फ़ाइल में,AppLovin SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_applovin: ^1.0.0
मैन्युअल इंटिग्रेशन
इसके लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन का सबसे नया वर्शन डाउनलोड करें
AppLovin,
डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें और एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर को जोड़ें
(और इसकी सामग्री) को आपके Flutter प्रोजेक्ट में शामिल करना होगा. फिर, अपने
pubspec.yaml
फ़ाइल में यह डिपेंडेंसी जोड़कर:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
चौथा चरण: AppLovin SDK टूल पर निजता सेटिंग लागू करें
ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर
Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति के तहत, आपको यह पक्का करना होगा कि डिवाइस आइडेंटिफ़ायर और निजी डेटा के इस्तेमाल के बारे में, यूरोपियन इकनॉमिक एरिया (ईईए) के उपयोगकर्ताओं को कुछ जानकारी दी गई है और उनसे सहमति ली गई है. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. सहमति लेते समय, आपको अपनी मीडिएशन चेन में हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी डेटा को इकट्ठा, हासिल या इस्तेमाल कर सकता है. साथ ही, आपको हर नेटवर्क के इस्तेमाल के बारे में जानकारी देनी होगी. फ़िलहाल, Google ऐसे नेटवर्क के लिए उपयोगकर्ता की सहमति के विकल्प को अपने-आप पास नहीं कर सकता.
AppLovin, शेयर की गई प्राथमिकताओं से सहमति स्ट्रिंग को पढ़ने और उसके हिसाब से सहमति की स्थिति सेट करने की सुविधा देता है.अगर आपने
शेयर की गई प्राथमिकताओं में सहमति स्ट्रिंग लिखने वाले सीएमपी का इस्तेमाल नहीं किया है, तो आपके पास
GmaMediationApplovin.setHasUserConsent()
और
GmaMediationApplovin.setIsAgeRestrictedUser()
के तरीकों का इस्तेमाल करने का विकल्प है. नीचे दिया गया सैंपल कोड, AppLovin SDK टूल को
सहमति की जानकारी भेजने का तरीका बताता है. Google Mobile Ads SDK टूल को शुरू करने से पहले, ये विकल्प सेट करने ज़रूरी हैं. इससे यह पक्का किया जा सकेगा कि ये विकल्प, AppLovin SDK टूल को सही तरीके से फ़ॉरवर्ड किए जाएं.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
ज़्यादा जानकारी के लिए, AppLovin की निजता सेटिंग देखें.
अमेरिका के निजता कानून
अमेरिका के राज्यों के निजता कानून के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" की "बिक्री" से ऑप्ट आउट करने का अधिकार देना ज़रूरी है. इससे जुड़ी शर्तों के बारे में इस कानून में साफ़ तौर पर बताया गया है. "बिक्री करने वाले" पक्ष को अपने होम पेज पर, ऑप्ट आउट के लिए "मेरी निजी जानकारी न बेचें" लिंक देना ज़रूरी है. अमेरिका के निजता कानूनों के पालन से जुड़ी गाइड, Google विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग को चालू करने की सुविधा देती है. हालांकि, Google आपकी मीडिएशन चेन के हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको अपनी मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकता है. साथ ही, नीति का पालन करने के लिए, उन सभी नेटवर्क के दिशा-निर्देशों का पालन करना होगा.
AppLovin के लिए Google Mobile Ads मीडिएशन प्लग इन केमें,
GmaMediationApplovin.setDoNotSell()
का तरीका शामिल है. नीचे दिया गया सैंपल कोड, AppLovin SDK टूल को
सहमति से जुड़ी जानकारी भेजने का तरीका बताता है. Google Mobile Ads SDK टूल को शुरू करने से पहले, ये विकल्प सेट करने होंगे. इससे यह पक्का किया जा सकेगा कि ये विकल्प, AppLovin SDK टूल को सही तरीके से फ़ॉरवर्ड किए जाएं.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
ज़्यादा जानकारी के लिए, AppLovin की निजता से जुड़ा दस्तावेज़ देखें.
पांचवां चरण: ज़रूरी कोड जोड़ना
Android
AppLovin इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं होती.
iOS
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, AppLovin के दस्तावेज़ में दिया गया तरीका अपनाएं.
छठा चरण: लागू करने की जांच करना
टेस्ट विज्ञापनों को चालू करें
पक्का करें कि आपनेके लिए अपना टेस्ट डिवाइस रजिस्टर किया हो और AppLovin यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो. AdMob
टेस्ट विज्ञापनों की पुष्टि करें
यह पुष्टि करने के लिए कि AppLovinसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, AppLovin (Bidding) and AppLovin (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.
वैकल्पिक चरण
नेटवर्क के हिसाब से पैरामीटर
नेटवर्क के हिसाब से पैरामीटर सेट करने के लिए, AppLovin अडैप्टर, विज्ञापन अनुरोध में AppLovinMediationExtras
ऑब्जेक्ट को पास करने की सुविधा देता है. नीचे दिया गया सैंपल कोड यह बताता है कि isMuted
पैरामीटर का इस्तेमाल करके, वीडियो विज्ञापनों में ऑडियो कैसे बंद किया जाता है:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
अनुकूलन
अपनी लॉन्च ऐक्टिविटी में कॉल-टू-ऐक्शन
GmaMediationApplovin.initializeSdk('sdkKey')
जोड़ने पर, ऐप्लिकेशन शुरू होने के साथ ही AppLovin को इवेंट ट्रैक करने की सुविधा मिलती है.
गड़बड़ी के कोड
अगर अडैप्टर को AppLovin से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास के तहत ResponseInfo
का इस्तेमाल करके, विज्ञापन के जवाब में मौजूद गड़बड़ी की जांच कर सकते हैं:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
जब कोई विज्ञापन लोड नहीं होता है, तो AppLovin अडैप्टर से ये कोड और मैसेज मिलते हैं:
Android
गड़बड़ी का कोड | कारण |
---|---|
-1009 से -1, 204 | AppLovin SDK टूल से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, AppLovin का दस्तावेज़ देखें. |
101 | विज्ञापन का अनुरोध किया गया साइज़, AppLovin इस्तेमाल किए जा सकने वाले बैनर साइज़ से मेल नहीं खाता. |
103 | संदर्भ शून्य है. |
104 | AppLovin बिड टोकन खाली है. |
105 | एक ही ज़ोन के लिए कई विज्ञापनों का अनुरोध किया गया है. AppLovin, हर ज़ोन के हिसाब से एक समय पर सिर्फ़ एक विज्ञापन लोड कर सकता है. |
106 | विज्ञापन दिखाने के लिए तैयार नहीं है. |
108 | AppLovin अडैप्टर, अनुरोध किए जा रहे विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता. |
iOS
गड़बड़ी का कोड | कारण |
---|---|
-1009 से -1, 204 | AppLovin SDK टूल में कोई गड़बड़ी मिली है. ज़्यादा जानकारी के लिए, AppLovin का दस्तावेज़ देखें. |
101 | विज्ञापन का अनुरोध किया गया साइज़, AppLovin इस्तेमाल किए जा सकने वाले बैनर साइज़ से मेल नहीं खाता. |
102 | AdMob यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए AppLovin सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं. |
103 | AppLovin का विज्ञापन नहीं दिखाया जा सका. |
104 | एक ही ज़ोन के लिए कई विज्ञापनों का अनुरोध किया गया है. AppLovin, हर ज़ोन के हिसाब से एक समय पर सिर्फ़ एक विज्ञापन लोड कर सकता है. |
105 | AppLovin SDK टूल की कुंजी नहीं मिली. |
107 | बिड टोकन खाली है. |
108 | AppLovin अडैप्टर, अनुरोध किए गए विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता. |
110 | AppLovin ने लोड होने का कॉलबैक भेजा, लेकिन कोई विज्ञापन लोड नहीं हुआ. |
111 | AppLovin SDK टूल का इंस्टेंस वापस नहीं लाया जा सका. |
112 | उपयोगकर्ता बच्चा है. |
AppLovin Flutter मीडिएशन अडैप्टर में हुए बदलावों का लॉग
अगला वर्शन
- इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.2.0 की मदद से बनाया और टेस्ट किया गया है.
1.2.0
- इस बात की पुष्टि की गई है कि AppLovin Android अडैप्टर के वर्शन 12.6.1.0 के साथ काम करता है या नहीं.
- इस बात की पुष्टि की गई है कि AppLovin iOS अडैप्टर वर्शन 12.6.1.0 के साथ काम करता है या नहीं.
- Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.
1.1.0
- GmaMediationApplovin के लिए एपीआई अब स्टैटिक नहीं है.
- इस बात की पुष्टि की गई है कि AppLovin Android अडैप्टर के वर्शन 12.4.3.0 के साथ काम करता है या नहीं.
- AppLovin iOS अडैप्टर के वर्शन 12.4.2.0 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.
1.0.0
- शुरुआती रिलीज़.
- इस बात की पुष्टि की गई है कि AppLovin Android अडैप्टर वर्शन 12.3.0.0 के साथ काम करता है या नहीं
- AppLovin iOS अडैप्टर के वर्शन 12.2.1.0 के साथ काम करने की पुष्टि की गई
- इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.0.0 की मदद से बनाया और टेस्ट किया गया है.