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

प्लैटफ़ॉर्म चुनें: Android (बीटा) Android iOS Unity Flutter

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

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

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

¹ ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन फ़ॉर्मैट, सिर्फ़ वॉटरफ़ॉल इंटिग्रेशन के लिए उपलब्ध है.

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

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

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

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

• GMA Next-Gen SDK पर अपलोड हुआ नया वीडियो

• मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश

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

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

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

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

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

ज़ोन बनाएं

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

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

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

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

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

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

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

'कंपनियां' सेक्शन में AppLovin को जोड़ना

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

बिड रिक्वेस्ट पर सुरक्षित तरीके से सिग्नल शेयर करना

एसडीके से बिडिंग के लिए सुरक्षित सिग्नल शेयरिंग की अनुमति देना

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

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

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

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

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

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

ऐप्लिकेशन-लेवल की gradle फ़ाइल में, ये implementation dependencies और कॉन्फ़िगरेशन जोड़ें:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:applovin:13.5.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:applovin:13.5.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

• AppLovin Android SDK डाउनलोड करें, applovin-sdk-x.y.z.jar को एक्सट्रैक्ट करें, और इसे अपने प्रोजेक्ट में जोड़ें.

• Google की Maven रिपॉज़िटरी पर, AppLovin अडैप्टर आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें. इसके बाद, AppLovin अडैप्टर की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

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

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

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

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

AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setHasUserConsent(true)
AppLovinMediationSnippets.kt

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

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

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

AppLovin अडैप्टर का 13.0.0.1 या इसके बाद का वर्शन, AppLovin मीडिएशन को अपने-आप बंद कर देता है. यह उन ऐप्लिकेशन के लिए होता है जो GMA Next-Gen SDK के साथ इनमें से कोई भी सेटिंग लागू करते हैं:

• बच्चों को ध्यान में रखकर कॉन्टेंट दिखाने की सेटिंग

• सहमति देने की मान्य उम्र से कम के उपयोगकर्ता

अमेरिका के राज्यों के निजता कानून

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

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

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

AppLovinPrivacySettings.setDoNotSell(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setDoNotSell(true)
AppLovinMediationSnippets.kt

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

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

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

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

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

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

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

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

वैकल्पिक चरण

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

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

Bundle extras = new AppLovinExtras.Builder()
  .setMuteAudio(true)
  .build();
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
  .putAdSourceExtrasBundle(ApplovinAdapter.class, extras)
  .build();

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

अनुकूलन

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

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

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

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