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

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

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

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

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

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

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

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

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

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

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

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

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

बिडिंग

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

झरना

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

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

बिडिंग

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

झरना

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

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

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

Android

iOS

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

Android

iOS

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

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

अगर Applonin वर्शन 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 Mobile Ads मीडिएशन प्लगिन की सुविधा वर्शन 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 के दस्तावेज़ फ़ॉलो करें.

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

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

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

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

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

वैकल्पिक चरण

अनुकूलन

के लिए कॉल जोड़ें 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

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

iOS

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

AppLovin Unity मीडिएशन प्लगिन चेंजलॉग

वर्शन 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 वर्शन के साथ काम करता है.