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

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

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

AppLovin के लिए मीडिएशन अडैप्टर AdMob की मदद से, ये काम किए जा सकते हैं:

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर	^1
मध्यवर्ती
इनाम दिया गया

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

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

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

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

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

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

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

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

बिडिंग

बिडिंग इंटिग्रेशन के लिए यह चरण ज़रूरी नहीं है.

झरना

अपने रजिस्टर किए गए ऐप्लिकेशन पर जाने के लिए, AppLovin यूज़र इंटरफ़ेस (यूआई) पर, कमाई करना सेक्शन में ऐप्लिकेशन को चुनें. उपलब्ध ऐप्लिकेशन की सूची से वह ऐप्लिकेशन चुनें जिसे आप मीडिएशन के साथ इस्तेमाल करना चाहते हैं.

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

बिडिंग

बिडिंग इंटिग्रेशन के लिए यह चरण ज़रूरी नहीं है.

झरना

अपने रजिस्टर किए गए ज़ोन आईडी पाने के लिए, AppLovin यूज़र इंटरफ़ेस (यूआई) पर, कमाई करना सेक्शन में ज़ोन चुनें. अगर आपने ऐप्लिकेशन के लिए ज़रूरी ज़ोन पहले ही बना लिए हैं, तो सीधे दूसरे चरण पर जाएं. नया ज़ोन आईडी बनाने के लिए, ज़ोन बनाएं पर क्लिक करें.

ज़ोन आईडी का नाम डालें, प्लैटफ़ॉर्म के तौर पर Android चुनें, और विज्ञापन का टाइप चुनें.

फ़्लैट सीपीएम या AppLovin से ऑप्टिमाइज़ किया गया चुनकर, ज़ोन के लिए कीमत कॉन्फ़िगर करें. फ़्लैट सीपीएम विकल्प के लिए, हर देश के हिसाब से सीपीएम को कॉन्फ़िगर किया जा सकता है. इसके बाद, सेव करें पर क्लिक करें.

Android

iOS

ज़ोन बन जाने के बाद, ज़ोन आईडी कॉलम में उसका आईडी देखा जा सकता है.

Android

iOS

ध्यान दें: हमारा सुझाव है कि आप हर AdMob विज्ञापन यूनिट के हिसाब से AppLovin ज़ोन बनाएं. इससे AdMob ज़्यादा असरदार तरीके से मीडिएशन में विज्ञापन सोर्स को ऑप्टिमाइज़ किया जा सकेगा.

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

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

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

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

Android

निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.

iOS

निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.

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

अहम जानकारी: पुष्टि करें कि आपके पास खाता मैनेजमेंट की अनुमति है, ताकि ईयू (यूरोपीय संघ) की सहमति के साथ-साथ जीडीपीआर, सीपीआरए, और उपयोगकर्ता मैसेज सेवा प्लैटफ़ॉर्म का कॉन्फ़िगरेशन पूरा किया जा सके. ज़्यादा जानकारी के लिए, अपने खाते के लिए उपयोगकर्ता का ऐक्सेस मैनेज करना देखें.

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

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

ध्यान दें: AppLovin और Google Mobile Ads 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 ऐसे नेटवर्क के लिए उपयोगकर्ता की सहमति का विकल्प अपने-आप नहीं भेज सकता.

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

अहम जानकारी: ऐप्लिकेशन रिलीज़ करने से पहले, AdMob और AppLovin अपने ऐप्लिकेशन के लिए टेस्ट मोड बंद करें.

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

यह पुष्टि करने के लिए कि 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	यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए AppLovin सर्वर पैरामीटर AdMob अमान्य है.
103	AppLovin विज्ञापन नहीं दिखाया जा सका.
104	एक ही ज़ोन के लिए कई विज्ञापनों का अनुरोध किया गया. AppLovin हर ज़ोन के लिए, एक समय पर सिर्फ़ एक विज्ञापन लोड कर सकता है.
105	AppLovin SDK टूल कुंजी नहीं मिली.
107	बोली टोकन खाली है.
108	AppLovin अडैप्टर, अनुरोध किए जा रहे विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता है.
110	AppLovin ने लोड करने के लिए एक कॉलबैक भेजा है, लेकिन कोई विज्ञापन लोड नहीं किया है.

AppLovin Flutter मीडिएशन अडैप्टर चेंजलॉग

1.1.0

• GmaMediationApplowin के लिए एपीआई अब काम नहीं करता.
• 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 वर्शन के साथ बनाया और टेस्ट किया गया.