AppLovin को मीडिएशन के साथ इंटिग्रेट करना

इस गाइड में, मीडिएशन का इस्तेमाल करके, AppLovin से विज्ञापन लोड करने और दिखाने के लिए, Google Mobile Ads SDK टूल का इस्तेमाल करने का तरीका बताया गया है. इसमें बिडिंग और वॉटरफ़ॉल इंटिग्रेशन, दोनों के बारे में बताया गया है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में AppLovin को जोड़ने का तरीका बताया गया है. साथ ही, AppLovin SDK टूल और अडैप्टर को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका भी बताया गया है.

इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट

AdMob AppLovin के लिए मीडिएशन अडैप्टर में ये सुविधाएं होती हैं:

¹ बैनर विज्ञापन (एमआरईसी बैनर को छोड़कर) सिर्फ़ मीडिएशन में काम करते हैं. बिडिंग की सुविधा, किसी भी तरह के बैनर विज्ञापनों के साथ काम नहीं करती.

ज़रूरी शर्तें

• Google Mobile Ads SDK का सबसे नया वर्शन
• Flutter 3.7.0 या इसके बाद का वर्शन
• Android पर डिप्लॉय करने के लिए
  • Android एपीआई लेवल 21 या उसके बाद का वर्शन
• iOS पर डिप्लॉय करने के लिए
  • iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
• Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया, काम करने वाला Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
• मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

पहला चरण: AppLovin के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना

अपने AppLovin खाते में साइन अप करें या लॉग इन करें.

AdMob विज्ञापन यूनिट सेट अप करने के लिए, आपको AppLovin SDK पासकोड और रिपोर्ट पासकोड की ज़रूरत होगी. दोनों वैल्यू देखने के लिए, AppLovin यूज़र इंटरफ़ेस (यूआई) > खाता > कुंजियां पर जाएं.

अगर आपको सिर्फ़ बिडिंग को इंटिग्रेट करना है, तो मीडिएशन सेटिंग कॉन्फ़िगर करें.

मीडिएशन के लिए ऐप्लिकेशन चुनना

एक क्षेत्र बनाएं

टेस्ट मोड चालू करना

AppLovin के टेस्ट विज्ञापनों को चालू करने के तरीके के बारे में जानने के लिए, AppLovin के MAX टेस्ट मोड की गाइड में दिए गए निर्देशों का पालन करें.

दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में AppLovin की मांग सेट अप करना

अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना

जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में AppLovin Corp. को जोड़ना

AdMob के यूज़र इंटरफ़ेस (यूआई) में, जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Applovin Corp. को जोड़ने के लिए, जीडीपीआर सेटिंग और अमेरिका के कानूनों की सेटिंग में दिया गया तरीका अपनाएं.

तीसरा चरण: AppLovin SDK टूल और अडैप्टर इंपोर्ट करना

pub.dev की मदद से इंटिग्रेशन

अपने पैकेज की pubspec.yaml फ़ाइल में,AppLovin SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_applovin: ^1.0.0

मैन्युअल इंटिग्रेशन

AppLovin के लिए, Google Mobile Ads मीडिएशन प्लग इन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को निकालें और निकाले गए प्लग इन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लग इन का रेफ़रंस दें. इसके लिए, यहां दी गई डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

चौथा चरण: AppLovin SDK टूल पर निजता सेटिंग लागू करना

ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर

Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति के तहत, आपको यह पक्का करना होगा कि डिवाइस आइडेंटिफ़ायर और निजी डेटा के इस्तेमाल के बारे में, यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले उपयोगकर्ताओं को कुछ जानकारी दी गई हो और उनसे सहमति ली गई हो. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. सहमति मांगते समय, आपको अपनी मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी डेटा इकट्ठा कर सकता है, पा सकता है या इस्तेमाल कर सकता है. साथ ही, आपको हर नेटवर्क के इस्तेमाल के बारे में जानकारी देनी होगी. फ़िलहाल, Google ऐसे नेटवर्क पर उपयोगकर्ता की सहमति के विकल्प को अपने-आप पास नहीं कर सकता.

अगर आपने किसी ऐसे सीएमपी का इस्तेमाल नहीं किया है जो शेयर की गई प्राथमिकताओं में सहमति स्ट्रिंग लिखता है, तो आपके पास 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 की निजता से जुड़ा दस्तावेज़ देखें.

पांचवां चरण: ज़रूरी कोड जोड़ना

छठा चरण: लागू करने की जांच करना

टेस्ट विज्ञापन चालू करना

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, Applovin यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो.

टेस्ट विज्ञापनों की पुष्टि करना

यह पुष्टि करने के लिए कि आपको Applovin से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में Applovin (बिडिंग) और Applovin (वॉटरफ़ॉल) विज्ञापन स्रोत का इस्तेमाल करके, विज्ञापन के किसी एक स्रोत की जांच की सुविधा चालू करें.

वैकल्पिक चरण

नेटवर्क के हिसाब से पैरामीटर

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 का इस्तेमाल करके, विज्ञापन के जवाब में मौजूद गड़बड़ी की जांच कर सकते हैं:

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

जब कोई विज्ञापन लोड नहीं होता है, तो AppLovin अडैप्टर से ये कोड और मैसेज मिलते हैं:

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 वर्शन के साथ बनाया और टेस्ट किया गया.