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

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

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

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

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

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

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

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

Android API का लेवल 19 या उसके बाद वाला वर्शन

[बिडिंग के लिए]: AppLovin अडैप्टर 9.4.2.0 या इसके बाद का वर्शन है (नए वर्शन का सुझाव दिया जाता है)

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

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

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

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

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

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

बिडिंग

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

झरना

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

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

बिडिंग

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

झरना

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

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

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

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

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

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

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

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

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

बिडिंग

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

झरना

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

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

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

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

बिडिंग

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

झरना

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

बिडिंग कॉन्फ़िगर करें AppLovin

बिडिंग

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

बिड करने वाले के तौर पर AppLovin को चुनें.

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

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

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

झरना

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

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

बिडिंग

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

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

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

झरना

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

नीचे की ओर स्क्रोल करें और ईल्ड पार्टनर जोड़ें पर क्लिक करें.

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

पिछले सेक्शन में दिया गया Application ID of your app along with the SDK Key and the Zone ID और डिफ़ॉल्ट सीपीएम वैल्यू डालें. सेव करें पर क्लिक करें.

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

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

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

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

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

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

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

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

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

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

ईयू की सहमति और जीडीपीआर

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

SDK टूल के वर्शन 12.0.0 के बाद से, AppLovin, शेयर की गईप्राथमिकताओं से सहमति वाली स्ट्रिंग को पढ़ने और उसी हिसाब से सहमति की स्थिति सेट करने की सुविधा देता है.

अगर AppLovin SDK टूल के 12.0.0 के बाद के वर्शन का इस्तेमाल नहीं किया जा रहा है या ऐसे सीएमपी का इस्तेमाल नहीं किया जा रहा है जो शेयर की गई प्राथमिकताओं में सहमति वाली स्ट्रिंग को लिखता है, तो setHasUserContent और setIsAgeRestrictedUser तरीकों का इस्तेमाल किया जा सकता है. नीचे दिए गए सैंपल कोड में, 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)

इसके अलावा, अगर उपयोगकर्ता उम्र से जुड़ी पाबंदी वाली कैटगरी में आता है, तो नीचे दिए गए फ़्लैग को भी true पर सेट किया जा सकता है.

Java

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context);

Kotlin

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context)

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

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

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

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

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

यह पुष्टि करने के लिए कि AppLovinसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, AppLovin (Bidding) and AppLovin (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.

वैकल्पिक चरण

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

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.getAdapterResponse() का इस्तेमाल करके, विज्ञापन के रिस्पॉन्स में हो रही गड़बड़ी की जांच कर सकते हैं:

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