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

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

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

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

¹ वॉटरफ़ॉल में सिर्फ़ 320x50 और 728x90 बैनर साइज़ काम करते हैं. बिडिंग की सुविधा, बैनर विज्ञापनों के साथ काम नहीं करती.

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

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

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

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

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

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

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

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

app-ads.txt फ़ाइल अपडेट करना

Authorized Sellers for Apps app-ads.txt, IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे ही चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.

AppLovin के लिए app-ads.txt लागू करने के लिए, AppLovin को अपनी app-ads.txt फ़ाइल में जोड़ें.

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

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

दूसरा चरण: AdMob के यूआई में AppLovin की डिमांड सेट अप करना

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

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

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

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

pub.dev के ज़रिए इंटिग्रेशन

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

dependencies:
  gma_mediation_applovin: ^

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

Applovin के लिए, Google Mobile Ads mediation प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें. साथ ही, एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने 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],
);

अनुकूलन

लॉन्च ऐक्टिविटी में कॉल जोड़ने से, AppLovin को ऐप्लिकेशन शुरू होते ही इवेंट ट्रैक करने की सुविधा मिलती है.GmaMediationApplovin.initializeSdk('sdkKey')

गड़बड़ी के कोड

अगर अडैप्टर को AppLovin से विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास में जाकर, विज्ञापन के जवाब में हुई गड़बड़ी की जांच कर सकते हैं:ResponseInfo

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

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

विज्ञापन लोड न होने पर, AppLovin अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:

AppLovin Flutter Mediation Adapter के बदलावों का लॉग

वर्शन 2.3.2

• AppLovin Android अडैप्टर वर्शन 13.3.1.1 के साथ काम करता है.
• AppLovin iOS अडैप्टर के 13.3.1.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.3.1

• AppLovin Android अडैप्टर 13.3.1.0 के साथ काम करता है.
• AppLovin iOS अडैप्टर के 13.3.1.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.3.0

• AppLovin Android अडैप्टर वर्शन 13.3.0.0 के साथ काम करता है.
• AppLovin iOS अडैप्टर के 13.3.0.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.2.1

• AppLovin Android adapter version 13.2.0.1 के साथ काम करता है.
• AppLovin iOS अडैप्टर के 13.2.0.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.2.0

• AppLovin Android अडैप्टर 13.2.0.0 के साथ काम करता है.
• AppLovin iOS अडैप्टर के 13.2.0.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.1.0

• AppLovin Android अडैप्टर वर्शन 13.1.0.0 के साथ काम करता है.
• AppLovin iOS अडैप्टर के 13.1.0.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 5.3.1 के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.0.0

• AppLovin Android अडैप्टर वर्शन 13.0.1.0 के साथ काम करता है.
• AppLovin iOS अडैप्टर के 13.0.1.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 5.3.1 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.2.0

• AppLovin Android अडैप्टर 12.6.1.0 के साथ काम करता है.
• AppLovin iOS अडैप्टर के 12.6.1.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 5.1.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.1.0

• GmaMediationApplovin के लिए एपीआई अब स्टैटिक नहीं है.
• AppLovin Android अडैप्टर वर्शन 12.4.3.0 के साथ काम करता है.
• AppLovin iOS अडैप्टर के 12.4.2.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 5.1.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.0.0

• शुरुआती रिलीज़.

• AppLovin Android अडैप्टर के 12.3.0.0 वर्शन के साथ काम करता है.
• AppLovin iOS अडैप्टर के 12.2.1.0 वर्शन के साथ काम करता है.

• इसे Google Mobile Ads Flutter Plugin के वर्शन 5.0.0 के साथ बनाया और टेस्ट किया गया है.