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

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

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

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

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

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

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

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

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

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

Google Mobile Ads SDK का सबसे नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

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

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

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

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

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

बिडिंग

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

झरना

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

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

बिडिंग

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

झरना

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

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

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

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

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

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

दूसरा चरण: Ad Manager के यूज़र इंटरफ़ेस में, AppLovin की मांग सेट अप करना

अपने Ad Manager खाते में साइन इन करें.

कंपनियों में Applovin जोड़ना

बिडिंग

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

झरना

एडमिन > कंपनियां पर जाएं. इसके बाद, सभी कंपनियां टैब में नई कंपनी बटन पर क्लिक करें. विज्ञापन नेटवर्क चुनें.

विज्ञापन नेटवर्क के तौर पर Applovin चुनें. इसके बाद, कोई यूनीक नाम डालें और मीडिएशन चालू करें. डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. साथ ही, पिछले सेक्शन में मिली रिपोर्ट कुंजी डालें.

आपको उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं है. बदलाव करने के बाद, सेव करें पर क्लिक करें.

सुरक्षित सिग्नल शेयर करने की सुविधा चालू करना

बिडिंग

एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाते की सेटिंग टैब पर जाएं. इसके बाद, सुरक्षित सिग्नल शेयर करने की सुविधा की समीक्षा करें और उसे टॉगल करके चालू करें. सेव करें पर क्लिक करें.

झरना

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

Applovin बिडिंग को कॉन्फ़िगर करना

बिडिंग

डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, SDK बिडिंग टैब में जाकर, नया बिडर पर क्लिक करें.

बिडर के तौर पर Applovin चुनें.

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

जारी रखें पर क्लिक करें.

हो गया पर क्लिक करें.

झरना

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

विज्ञापन यूनिट मैपिंग को कॉन्फ़िगर करना

बिडिंग

डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, SDK बिडिंग टैब में जाकर, Applovin के लिए कंपनी चुनें.

विज्ञापन यूनिट मैपिंग टैब पर जाएं और नई विज्ञापन यूनिट मैपिंग पर क्लिक करें.

कोई विज्ञापन यूनिट चुनें. कोई विज्ञापन यूनिट और फ़ॉर्मैट चुनें. साथ ही, इन्वेंट्री टाइप के तौर पर मोबाइल ऐप्लिकेशन और अपना मोबाइल ऐप्लिकेशन चुनें. इसके बाद, पिछले सेक्शन में मिली SDK टूल की कुंजी डालें. आखिर में, सेव करें पर क्लिक करें.

झरना

डिलीवरी > नतीजे के ग्रुप पर जाएं और नया नतीजा ग्रुप बटन पर क्लिक करें. अपना मोबाइल ऐप्लिकेशन चुनें.

नीचे की ओर स्क्रोल करें और नतीजों से जुड़े विज्ञापन दिखाने वाले पार्टनर जोड़ें पर क्लिक करें.

वह कंपनी चुनें जिसे आपने पिछले सेक्शन में, Applovin के लिए बनाया था. इंटिग्रेशन टाइप के तौर पर मोबाइल SDK टूल का मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर चालू है चुनें.

अपने ऐप्लिकेशन का ऐप्लिकेशन आईडी डालें. साथ ही, पिछले सेक्शन में मिली SDK टूल की कुंजी और ज़ोन आईडी के साथ-साथ डिफ़ॉल्ट सीपीएम वैल्यू डालें. सेव करें पर क्लिक करें.

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

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

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

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

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

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

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

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

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

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

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

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

SDK टूल के 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 या इसके बाद का वर्शन, उन ऐप्लिकेशन के लिए AppLovin मीडिएशन को अपने-आप बंद कर देता है जो Google Mobile Ads SDK के साथ इनमें से किसी एक सेटिंग का एलान करते हैं:

अगर 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 इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं होती.

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

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

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

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

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

वैकल्पिक चरण

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

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

Java

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

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

Kotlin

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

val request = AdManagerAdRequest.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 अडैप्टर से ये कोड और मैसेज मिलते हैं:

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