हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google Advertising and Measurement Community सर्वर में AdMob के आधिकारिक Discord चैनल से जुड़ें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

इंटिग्रेशन
बिडिंग
झरना
फ़ॉर्मैट
बैनर	¹
मध्यवर्ती
इनाम दिया गया
मूल भाषा वाला

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

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

Android का एपीआई लेवल 23 या इसके बाद का वर्शन

[बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, AppLovin अडैप्टर 9.4.2.0 या इसके बाद के वर्शन का इस्तेमाल करें (नए वर्शन का इस्तेमाल करने का सुझाव दिया जाता है).

Google Mobile Ads SDK का नया वर्शन
मीडिएशन की सुविधा चालू करना शुरुआती निर्देश

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

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

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

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

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

बिडिंग

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

झरना

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

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

बिडिंग

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

झरना

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

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

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

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

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 को जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपको किसी मौजूदा मीडिएशन ग्रुप में बदलाव करना है, तो उस मीडिएशन ग्रुप के नाम पर क्लिक करके उसमें बदलाव करें. इसके बाद, Applovin को विज्ञापन सोर्स के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन का फ़ॉर्मैट और प्लैटफ़ॉर्म डालें. इसके बाद, जारी रखें पर क्लिक करें.

अपने मीडिएशन ग्रुप को कोई नाम दें और टारगेट करने के लिए जगहें चुनें. इसके बाद, मीडिएशन ग्रुप की स्थिति को चालू है पर सेट करें. इसके बाद, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

इस मीडिएशन ग्रुप को अपनी मौजूदा AdMob विज्ञापन यूनिट में से एक या उससे ज़्यादा से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट का कार्ड दिखेगा. इसमें आपकी चुनी गई विज्ञापन यूनिट दिखेंगी:

Applovin को विज्ञापन सोर्स के तौर पर जोड़ना

बिडिंग

विज्ञापन सोर्स सेक्शन में मौजूद, बिडिंग कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, Applovin चुनें .

Applovin के साथ बिडिंग पार्टनरशिप सेट अप करें और पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें.

स्वीकार करें और सहमत हों पर क्लिक करें. इसके बाद, जारी रखें पर क्लिक करें.

अगर आपने Applovin के लिए पहले से कोई मैपिंग की हुई है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिला एसडीके कुंजी डालें. इसके बाद, हो गया पर क्लिक करें.

झरना

विज्ञापन सोर्स सेक्शन में मौजूद, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें.

Applovin को चुनें और ऑप्टिमाइज़ करें स्विच को चालू करें. Applovin के लिए विज्ञापन सोर्स ऑप्टिमाइज़ेशन सेट अप करने के लिए, पिछले सेक्शन में मिला रिपोर्ट का मुख्य कोड डालें. इसके बाद, Applovin के लिए ईसीपीएम वैल्यू डालें और जारी रखें पर क्लिक करें.

अगर आपने Applovin के लिए पहले से ही मैपिंग की हुई है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, अपने ऐप्लिकेशन का ऐप्लिकेशन आईडी डालें. साथ ही, पिछले सेक्शन में मिला एसडीके कुंजी और ज़ोन आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

ध्यान दें: विज्ञापन सोर्स ऑप्टिमाइज़ेशन को, मीडिएशन नेटवर्क के लिए eCPM का सटीक हिसाब लगाने के लिए ज़रूरी डेटा इकट्ठा करने में कुछ दिन लगते हैं. इस बीच, विज्ञापन सोर्स के ऑप्टिमाइज़ेशन की स्थिति PENDING है. इसलिए, आपको नेटवर्क के लिए मैन्युअल तरीके से ईसीपीएम वैल्यू सेट करनी होगी. ईसीपीएम का हिसाब लगाने के बाद, विज्ञापन सोर्स आपकी ओर से ईसीपीएम को अपने-आप अपडेट करना शुरू कर देता है.

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

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

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

Android Studio इंटिग्रेशन (सुझाया गया)

अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, यहां दी गई डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. AppLovin SDK टूल और अडैप्टर के सबसे नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.4.0")
    implementation("com.google.ads.mediation:applovin:13.3.1.1")
}

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

AppLovin Android SDK डाउनलोड करें, applovin-sdk-x.y.z.jar को एक्सट्रैक्ट करें, और इसे अपने प्रोजेक्ट में जोड़ें.
Google के Maven Repository पर मौजूद, AppLovin अडैप्टर आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें. इसके बाद, AppLovin अडैप्टर की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

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

ईयू में रहने वाले उपयोगकर्ताओं की सहमति और जीडीपीआर

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

एसडीके के 12.0.0 वर्शन के बाद से, AppLovin इन जगहों से सहमति स्ट्रिंग पढ़ सकता है: शेयर की गई प्राथमिकताएं और इसके हिसाब से सहमति का स्टेटस सेट कर सकता है.

अगर AppLovin SDK टूल के 12.0.0 या इसके बाद के वर्शन का इस्तेमाल नहीं किया जा रहा है या ऐसे सीएमपी का इस्तेमाल नहीं किया जा रहा है जो सहमति स्ट्रिंग को शेयर की गई प्राथमिकताओं में लिखता है, तो setHasUserContent तरीके का इस्तेमाल किया जा सकता है. यहां दिए गए उदाहरण में, AppLovin SDK को सहमति की जानकारी दी गई है. आपको इन विकल्पों को सेट करना होगा. इसके बाद ही, Google Mobile Ads SDK को शुरू करें, ताकि यह पक्का किया जा सके कि ये विकल्प AppLovin SDK को सही तरीके से फ़ॉरवर्ड किए गए हैं.

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context)

ज़्यादा जानकारी के लिए, AppLovin की निजता सेटिंग देखें.

नाबालिग उपयोगकर्ताओं के बारे में जानकारी देना

AppLovin SDK 13.0.0 से, AppLovin अब उम्र से जुड़ी पाबंदी वाले उपयोगकर्ता फ़्लैग के साथ काम नहीं करता. साथ ही, लागू कानूनों के तहत "बच्चे" के तौर पर परिभाषित किए गए उपयोगकर्ता के लिए, AppLovin SDK को शुरू या इस्तेमाल नहीं किया जा सकता. ज़्यादा जानकारी के लिए, AppLovin के इस दस्तावेज़ को पढ़ें: बच्चों के डेटा को इकट्ठा करने या बच्चों के लिए उपलब्ध सेवाओं या सिर्फ़ बच्चों के लिए बनाए गए ऐप्लिकेशन का इस्तेमाल करने पर पाबंदी.

AppLovin अडैप्टर का 13.0.0.1 या इसके बाद का वर्शन, Google Mobile Ads SDK के साथ इनमें से कोई भी सेटिंग इस्तेमाल करने वाले ऐप्लिकेशन के लिए, AppLovin मीडिएशन को अपने-आप बंद कर देता है:

अगर AppLovin अडैप्टर के 12.6.1.0 या इससे पहले के वर्शन का इस्तेमाल किया जा रहा है, तो AppLovin SDK टूल की मदद से, उम्र से जुड़ी पाबंदी वाले उपयोगकर्ता का फ़्लैग सेट करने के बारे में जानने के लिए, AppLovin के दस्तावेज़ पढ़ें.

अमेरिका के निजता कानून

अमेरिका के राज्यों में निजता से जुड़े कानूनों के मुताबिक, उपयोगकर्ताओं को उनकी "निजी जानकारी" (जैसा कि कानूनी तौर पर उन शब्दों को परिभाषित किया गया है) की "बिक्री" से ऑप्ट आउट करने का अधिकार देना ज़रूरी है. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर, "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से देना होगा. अमेरिका के राज्यों में निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने की सेवा के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google इस सेटिंग को आपके मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.

AppLovin SDK टूल में setDoNotSell तरीका शामिल है. इससे पब्लिशर, निजी जानकारी को बेचने से ऑप्ट आउट कर सकते हैं.

यहां दिए गए उदाहरण में, सहमति की यह जानकारी AppLovin SDK को भेजी जाती है. आपको इन विकल्पों को सेट करना होगा. इसके बाद ही, Google Mobile Ads SDK को शुरू करें, ताकि ये विकल्प AppLovin SDK को सही तरीके से फ़ॉरवर्ड किए जा सकें.

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setDoNotSell(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setDoNotSell(true, context)

ज़्यादा जानकारी के लिए, AppLovin के निजता से जुड़े दस्तावेज़ देखें.

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

AppLovin इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं होती.

छठा चरण: लागू किए गए बदलावों की जांच करना

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

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

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

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

वैकल्पिक चरण

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

AppLovin अडैप्टर, setMuteAudio() के साथ काम करता है. इसकी मदद से, वीडियो विज्ञापनों में ऑडियो बंद किया जा सकता है. इस तरीके को AppLovinExtras.Builder() ऑब्जेक्ट से कॉल किया जा सकता है:

Java

Bundle extras = new AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build();

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter.class, extras)
   .build();

Kotlin

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

अनुकूलन

ऐप्लिकेशन लॉन्च होते ही AppLovin SDK टूल को शुरू करने से, AppLovin को ऐप्लिकेशन शुरू होते ही इवेंट ट्रैक करने की सुविधा मिलती है.

Java

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk();

Kotlin

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk()

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

अगर अडैप्टर को AppLovin से विज्ञापन नहीं मिलता है, तो पब्लिशर विज्ञापन के जवाब में मौजूद गड़बड़ी की जानकारी देख सकते हैं. इसके लिए, उन्हें नीचे दिए गए क्लास में जाकर ResponseInfo.getAdapterResponses() का इस्तेमाल करना होगा:

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

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

गड़बड़ी का कोड	कारण
-1009 से -1, 204	AppLovin SDK टूल में कोई गड़बड़ी हुई है. ज़्यादा जानकारी के लिए, AppLovin के दस्तावेज़ देखें.
101	विज्ञापन का अनुरोध किया गया साइज़, AppLovin के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
103	कॉन्टेक्स्ट की वैल्यू शून्य है.
104	AppLovin का बिड टोकन मौजूद नहीं है.
105	एक ही ज़ोन के लिए कई विज्ञापनों का अनुरोध किया गया है. AppLovin, हर ज़ोन के लिए एक बार में सिर्फ़ एक विज्ञापन लोड कर सकता है.
106	विज्ञापन दिखाने के लिए तैयार नहीं है.
108	AppLovin अडैप्टर, अनुरोध किए गए विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता.
109	कॉन्टेक्स्ट, गतिविधि का इंस्टेंस नहीं है.
110	सर्वर के अमान्य पैरामीटर (जैसे, SDK की वैल्यू शून्य है).
112	उपयोगकर्ता बच्चा है.