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

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

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

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

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

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

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

  • Google Mobile Ads SDK का सबसे नया वर्शन
  • Unity 5.6 या इसके बाद का वर्शन
  • [बिडिंग के लिए]: AppLovin 4.2.0 या उसके बाद के वर्शन के लिए Google Mobile Ads मीडिएशन प्लग इन (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 21 या उसके बाद का वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
  • Google के मोबाइल विज्ञापन SDK टूल के साथ कॉन्फ़िगर किया गया Unity एक काम कर रहा प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें देखें.
  • मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

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

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

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

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

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

बिडिंग

बिडिंग इंटिग्रेशन के लिए, ऐसा करना ज़रूरी नहीं है.

झरना

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

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

बिडिंग

बिडिंग इंटिग्रेशन के लिए, ऐसा करना ज़रूरी नहीं है.

झरना

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

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

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

Android

iOS

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

Android

iOS

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

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

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

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

Android

निर्देशों के लिए, Android.

iOS

निर्देशों के लिए, iOS.

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

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

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

OpenUPM-CLI

अगर आपने OpenUPM-CLI इंस्टॉल किया है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Unity के लिए Google Mobile Ads का AppLovin मीडिएशन प्लग-इन इंस्टॉल किया जा सकता है:

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

Unity के पैकेज मैनेजर की सेटिंग खोलने के लिए, अपने Unity प्रोजेक्ट एडिटर में बदलाव करें > प्रोजेक्ट सेटिंग > पैकेज मैनेजर चुनें.

स्कोप वाली रजिस्ट्री टैब में, OpenUPM को स्कोप वाली रजिस्ट्री के तौर पर जोड़ें. इसके लिए, यह जानकारी दें:

  • नाम: OpenUPM
  • URL: https://package.openupm.com
  • दायरा: com.google

OpenUPM की जानकारी

इसके बाद, Unity Package Manager खोलने के लिए, विंडो > पैकेज मैनेजर पर जाएं. इसके बाद, ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.

Unity रजिस्ट्री

Google Mobile Ads AppLovin Mediation पैकेज चुनें और इंस्टॉल करें पर क्लिक करें.

OpenUPM से इंस्टॉल करना

Unity पैकेज

बदलावों की जानकारी में दिए गए डाउनलोड लिंक से, AppLovin के लिए Google Mobile Ads मीडिएशन प्लग इन का नया वर्शन डाउनलोड करें. इसके बाद, ज़िप फ़ाइल से GoogleMobileAdsAppLovinMediation.unitypackage को निकालें.

अपने Unity प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज चुनें और वह GoogleMobileAdsAppLovinMediation.unitypackage फ़ाइल ढूंढें जिसे आपने डाउनलोड किया है. पक्का करें कि सभी फ़ाइलें चुनी गई हों और इंपोर्ट करें पर क्लिक करें.

Unity से इंपोर्ट करना

इसके बाद, ऐसेट > बाहरी डिपेंडेंसी मैनेजर > Android रिज़ॉल्वर > बाध्य करके रिज़ॉल्व करें चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को फिर से शुरू से हल करेगी और बताई गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

फ़ोर्स रिज़ॉल्व

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

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

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

अगर आपने Apploin के 7.0.0 और इसके बाद के वर्शन के लिए, Google Mobile Ads मीडिएशन प्लगिन का इस्तेमाल नहीं किया है या शेयर की गई प्राथमिकताओं में सहमति स्ट्रिंग लिखने वाले सीएमपी का इस्तेमाल नहीं किया है, तो AppLovin.SetHasUserConsent() और AppLovin.SetIsAgeRestrictedUser() इन तरीकों का इस्तेमाल किया जा सकता है. यहां दिए गए सैंपल कोड में, AppLovin SDK को सहमति की जानकारी भेजने का तरीका बताया गया है. Google Mobile Ads SDK टूल को शुरू करने से पहले, ये विकल्प सेट करने ज़रूरी हैं. इससे यह पक्का किया जा सकेगा कि ये विकल्प, AppLovin SDK टूल को सही तरीके से फ़ॉरवर्ड किए जाएं.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

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

AppLovin.SetIsAgeRestrictedUser(true);

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

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

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

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

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, AppLovin के दस्तावेज़ में दिया गया तरीका अपनाएं.

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

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

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

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

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

वैकल्पिक चरण

अनुकूलन

अपनी लॉन्च ऐक्टिविटी में कॉल-टू-ऐक्शन AppLovin.Initialize() जोड़ने पर, ऐप्लिकेशन शुरू होने के साथ ही AppLovin को इवेंट ट्रैक करने की सुविधा मिलती है.

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

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

Android

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

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

जब कोई विज्ञापन लोड नहीं होता है, तो AppLovin अडैप्टर से ये कोड और मैसेज मिलते हैं:

Android

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

iOS

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

AppLovin Unity Mediation प्लग इन में हुए बदलावों का लॉग

अगला वर्शन

  • AppLovin क्लास से ये तरीके हटा दिए गए हैं:
    • Initialize()
    • SetIsAgeRestrictedUser(bool)

7.4.1 वर्शन

वर्शन 7.4.0

वर्शन 7.3.1

वर्शन 7.3.0

वर्शन 7.2.2

7.2.1 वर्शन

वर्शन 7.2.0

वर्शन 7.1.0

7.0.1 वर्शन

वर्शन 7.0.0

6.9.1 वर्शन

6.9.0 वर्शन

वर्शन 6.8.0

6.7.0 वर्शन

  • AppLovin Android अडैप्टर के 11.9.0.0 वर्शन के साथ काम करता है.
  • AppLovin iOS अडैप्टर के 11.9.0.0 वर्शन के साथ काम करता है.
  • Google Mobile Ads Unity प्लगिन के वर्शन 8.1.0 की मदद से, इसे बनाया और टेस्ट किया गया है.
  • अडैप्टर का कॉन्टेंट GoogleMobileAds/Mediation/AppLovin/ में ले जाया गया.
  • GoogleMobileAds.Mediation.AppLovin का इस्तेमाल करने के लिए, अडैप्टर नेमस्पेस को फिर से तैयार किया गया.

वर्शन 6.6.0

6.5.1 वर्शन

वर्शन 6.5.0

वर्शन 6.4.3

6.4.2 वर्शन

वर्शन 6.4.1

वर्शन 6.4.0

वर्शन 6.3.1

वर्शन 6.3.0

वर्शन 6.2.1

वर्शन 6.2.0

वर्शन 6.1.0

वर्शन 6.0.0

5.1.3 वर्शन

5.1.2 वर्शन

5.1.1 वर्शन

5.1.0 वर्शन

वर्शन 5.0.0

वर्शन 4.8.1

4.8.0 वर्शन

वर्शन 4.7.0

वर्शन 4.6.2

4.6.1 वर्शन

वर्शन 4.6.0

4.5.8 वर्शन

वर्शन 4.5.7

4.5.6 वर्शन

वर्शन 4.5.5

4.5.4 वर्शन

वर्शन 4.5.3

4.5.2 वर्शन

4.5.1 वर्शन

4.5.0 वर्शन

वर्शन 4.4.1

वर्शन 4.4.0

वर्शन 4.3.0

वर्शन 4.2.0

  • AppLovin Android अडैप्टर वर्शन 9.4.2.0 के साथ काम करता है.
  • AppLovin iOS अडैप्टर के 6.6.1.0 वर्शन के साथ काम करता है.

वर्शन 4.1.0

  • नए ओपन-बीटा Rewarded API के साथ काम करने के लिए, प्लग इन को अपडेट किया गया.
  • यह AppLovin के Android अडैप्टर के 9.2.1.1 वर्शन के साथ काम करता है.
  • AppLovin iOS अडैप्टर के 6.3.0.0 वर्शन के साथ काम करता है.

वर्शन 4.0.0

  • यह AppLovin के Android अडैप्टर के 9.2.1.0 वर्शन के साथ काम करता है.
  • AppLovin iOS अडैप्टर के 6.2.0.0 वर्शन के साथ काम करता है.

वर्शन 3.1.2

  • यह AppLovin के Android अडैप्टर के 8.1.4.0 वर्शन के साथ काम करता है.
  • यह AppLovin iOS अडैप्टर के 5.1.2.0 वर्शन के साथ काम करता है.

वर्शन 3.1.1

  • यह AppLovin के Android अडैप्टर के 8.1.0.0 वर्शन के साथ काम करता है.
  • AppLovin iOS अडैप्टर के 5.1.1.0 वर्शन के साथ काम करता है.

वर्शन 3.1.0

  • यह AppLovin के Android अडैप्टर के 8.1.0.0 वर्शन के साथ काम करता है.
  • AppLovin iOS अडैप्टर वर्शन 5.1.0.0 के साथ काम करता है.

वर्शन 3.0.3

  • AppLovin Android अडैप्टर के 8.0.2.1 वर्शन के साथ काम करता है.
  • यह AppLovin iOS अडैप्टर के 5.0.2.0 वर्शन के साथ काम करता है.

वर्शन 3.0.2

  • AppLovin के Android SDK टूल के 8.0.1 वर्शन के साथ काम करता है.
  • AppLovin iOS SDK टूल के 5.0.1 वर्शन के साथ काम करता है.

वर्शन 3.0.1

  • AppLovin Android SDK टूल के 8.0.0 वर्शन के साथ काम करता है.
  • AppLovin iOS SDK टूल के 5.0.1 वर्शन के साथ काम करता है.
  • AppLovin.SetIsAgeRestrictedUser() तरीका जोड़ा गया, ताकि यह पता चल सके कि उपयोगकर्ता, उम्र से जुड़ी पाबंदी वाली कैटगरी में शामिल है या नहीं.

वर्शन 3.0.0

  • AppLovin Android SDK टूल के 8.0.0 वर्शन के साथ काम करता है.
  • AppLovin iOS SDK टूल के 5.0.1 वर्शन के साथ काम करता है.
  • उपयोगकर्ता की सहमति के फ़्लैग को AppLovin SDK टूल पर फ़ॉरवर्ड करने के लिए, AppLovin.SetHasUserConsent() तरीका जोड़ा गया.

वर्शन 2.0.0

  • यह AppLovin के Android SDK टूल के 7.8.6 वर्शन के साथ काम करता है.
  • AppLovin iOS SDK टूल के 5.0.1 वर्शन के साथ काम करता है.

वर्शन 1.2.1

  • यह AppLovin के Android SDK टूल के 7.8.6 वर्शन के साथ काम करता है.
  • AppLovin iOS SDK के 4.8.3 वर्शन के साथ काम करता है.

वर्शन 1.2.0

  • AppLovin Android SDK टूल के 7.8.5 वर्शन के साथ काम करता है.
  • AppLovin iOS SDK के 4.8.3 वर्शन के साथ काम करता है.

वर्शन 1.1.0

  • AppLovin Android SDK के 7.7.0 वर्शन के साथ काम करता है.
  • AppLovin iOS SDK के 4.7.0 वर्शन के साथ काम करता है.

वर्शन 1.0.0

  • पहली रिलीज़!
  • यह AppLovin के Android SDK टूल के 7.4.1 वर्शन के साथ काम करता है.
  • AppLovin iOS SDK टूल के 4.4.1 वर्शन के साथ काम करता है.