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

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

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

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

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

बैनर विज्ञापन सिर्फ़ मीडिएशन में काम करते हैं. हालांकि, MREC बैनर नहीं होता है. बिडिंग में किसी भी तरह के बैनर विज्ञापन का इस्तेमाल नहीं किया जा सकता.

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

  • Google Mobile Ads SDK का नया वर्शन
  • Unity 5.6 या इसके बाद का वर्शन
  • [बिडिंग के लिए]: AppLovin 4.2.0 या उसके बाद के वर्शन के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन (सबसे नया वर्शन सुझाया गया है)
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 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 Services रिज़ॉल्वर > Android रिज़ॉल्वर > फ़ोर्स रिज़ॉल्व चुनें. Unity Play Services रिज़ॉल्वर लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन को नए सिरे से तैयार करेगी. साथ ही, तय की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

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

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

Google मोबाइल विज्ञापन मीडिएशन प्लगिन वर्शन 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 के दस्तावेज़ देखें.

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

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

पक्का करें कि आपनेके लिए अपना टेस्ट डिवाइस रजिस्टर किया हो और 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, हर ज़ोन में एक समय पर सिर्फ़ 1 विज्ञापन लोड कर सकता है.
106 विज्ञापन प्रदर्शन के लिए तैयार नहीं है.
108 AppLovin अडैप्टर, अनुरोध किए जा रहे विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता.

iOS

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

AppLovin Unity मीडिएशन प्लगिन में बदलाव का लॉग

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