AppLovin को AdMob मीडिएशन (अलग-अलग नेटवर्क से विज्ञापन दिखाना) के साथ इंटिग्रेट करना

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप का खुलना  1
बैनर  2
मध्यवर्ती
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन
मूल भाषा वाला

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

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

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

जारी रखने से पहले, इनकी पुष्टि करें:

  • Google Mobile Ads SDK for React Native का नया वर्शन.
  • React Native फ़्रेमवर्क का वर्शन 0.85.0 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads SDK for React Native के साथ कॉन्फ़िगर किया गया ऐसा React Native प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads SDK for React Native सेट अप करना लेख पढ़ें.
    • पक्का करें कि आपने gma-sdk-react-native फ़ोल्डर से adapters फ़ोल्डर को डाउनलोड और एक्सट्रैक्ट कर लिया हो. अगर आपके पास adapters फ़ोल्डर नहीं है, तो Google Mobile Ads SDK for React Native इंस्टॉल करें में जाकर, पहला, दूसरा, और तीसरा चरण अपनाएं.
  • AdMob मीडिएशन सेट अप करें.

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

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

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

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

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

बिडिंग

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

वॉटरफ़ॉल

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

ज़ोन बनाएं

बिडिंग

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

वॉटरफ़ॉल

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

Zone ID का नाम डालें. प्लैटफ़ॉर्म के तौर पर Android को चुनें. इसके अलावा, विज्ञापन का टाइप चुनें.

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

Android

iOS

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

Android

iOS

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

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

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

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

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

दूसरा चरण: AdMob के यूआई में AppLovin की डिमांड सेट अप करना

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

Android

निर्देशों के लिए, Android के लिए दी गई गाइड में दूसरा चरण देखें.

iOS

निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.

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

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

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

अपने प्रोजेक्ट की रूट डायरेक्ट्री में, AppLovin के लिए Google Mobile Ads SDK for React Native मीडिएशन अडैप्टर इंस्टॉल करें. नीचे दिए गए कदमों को पूरा करें:

  1. Google Mobile Ads SDK for React Native अडैप्टर की tar फ़ाइल को gma-sdk-react-native/adapters/applovin/ डायरेक्ट्री से अपने प्रोजेक्ट की local_packages/ डायरेक्ट्री में कॉपी करें. अगर आपके पास adapters फ़ोल्डर नहीं है, तो ज़रूरी शर्तें देखें.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/applovin/gma-mediation-applovin-0.1.0.tgz local_packages/

    EXTRACT_DIR को उस डायरेक्ट्री के पाथ से बदलें जहां आपने संग्रह को एक्सट्रैक्ट किया है.

  2. अपने पसंदीदा पैकेज मैनेजर का इस्तेमाल करके, अडैप्टर पैकेज इंस्टॉल करें:

    npm

    npm install ./local_packages/gma-mediation-applovin-0.1.0.tgz

    ऊन

    yarn add ./local_packages/gma-mediation-applovin-0.1.0.tgz

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

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

AppLovin React Native अडैप्टर का वर्शन 0.1.0 और इसके बाद के वर्शन, UMP SDK से जीडीपीआर के तहत सहमति के सिग्नल पास करने की सुविधा देते हैं. साथ ही, ये उन सहमति मैनेजमेंट प्लैटफ़ॉर्म से भी सहमति के सिग्नल पास करने की सुविधा देते हैं जो Google की अन्य सहमति की खास जानकारी को AppLovin SDK के साथ इंटिग्रेट करते हैं. ज़्यादा जानकारी के लिए, टीसीएफ़ के दूसरे वर्शन के लिए सहमति देखें.

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

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

AppLovin के लिए Google Mobile Ads React Native मीडिएशन प्लगिन, उन ऐप्लिकेशन के लिए AppLovin के लिए मीडिएशन को अपने-आप बंद कर देता है जो उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग का इस्तेमाल करके, बच्चे को उपयोगकर्ता के तौर पर दिखाते हैं.

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

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

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

import { AppLovinMediation } from '@google/gma-mediation-applovin';
// ...

AppLovinMediation.setDoNotSell(true);

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

वैकल्पिक चरण

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

AppLovin अडैप्टर, विज्ञापन दिखाने के अनुरोध में AppLovinMediationExtras ऑब्जेक्ट को पास करने की सुविधा देता है, ताकि नेटवर्क के हिसाब से पैरामीटर सेट किए जा सकें. यहां दिए गए सैंपल कोड से पता चलता है कि isMuted पैरामीटर का इस्तेमाल करके, वीडियो विज्ञापनों पर ऑडियो को कैसे बंद किया जा सकता है:

import { AdRequest } from '@google/mobile-ads';
import { AppLovinMediationExtras } from '@google/gma-mediation-applovin';

const request: AdRequest = {
  // ...
  mediationExtras: [
    new AppLovinMediationExtras({
      isMuted: true, // Mute audio for AppLovin ads
    }),
  ],
};

ऑप्टिमाइज़ेशन

लॉन्च गतिविधि में को कॉल करने से, 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 Adapter, अनुरोध किए जा रहे विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता.
109 कॉन्टेक्स्ट, गतिविधि का इंस्टेंस नहीं है.
110 SDK टूल की कुंजी मौजूद नहीं है.
112 उपयोगकर्ता कोई बच्चा है.
113 विज्ञापन यूनिट का आईडी मौजूद नहीं है.

iOS

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

वर्शन 0.1.0

  • शुरुआती रिलीज़.