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

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

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

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

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

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

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

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

ऐप्लिकेशन जोड़ें बटन पर क्लिक करके, अपने ऐप्लिकेशन को Liftoff Monetize डैशबोर्ड में जोड़ें.

फ़ॉर्म में सभी ज़रूरी जानकारी भरें.

Android

iOS

ऐप्लिकेशन बन जाने के बाद, Liftoff Monetize Applications डैशबोर्ड से अपना ऐप्लिकेशन चुनें.

Android

iOS

ऐप्लिकेशन आईडी को नोट करें.

Android

iOS

नए प्लेसमेंट जोड़ना

AdMob मीडिएशन के साथ इस्तेमाल करने के लिए नया प्लेसमेंट बनाने के लिए, Liftoff Monetize Placements डैशबोर्ड पर जाएं. इसके बाद, प्लेसमेंट जोड़ें बटन पर क्लिक करें और ड्रॉप-डाउन सूची से अपना ऐप्लिकेशन चुनें.

नए प्लेसमेंट जोड़ने के बारे में जानकारी यहां दी गई है:

ऐप का खुलना

इंटरस्टीशियल चुनें और प्लेसमेंट का नाम डालें. इसके बाद, स्किप किए जा सकने वाले विज्ञापनों के लिए, हां चुनें और फ़ॉर्म के बाकी हिस्से को भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

बैनर चुनें. इसके बाद, प्लेसमेंट का नाम डालें और फ़ॉर्म में पूछी गई बाकी जानकारी दें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

300x250 बैनर

एमआरईसी चुनें. इसके बाद, प्लेसमेंट का नाम डालें और फ़ॉर्म में पूछी गई बाकी जानकारी भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

मध्यवर्ती

इंटरस्टीशियल चुनें. इसके बाद, प्लेसमेंट का नाम डालें और फ़ॉर्म के बाकी हिस्से को भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

इनाम दिया गया

इनाम वाला विकल्प चुनें. इसके बाद, प्लेसमेंट का नाम डालें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

इनाम वाला इंटरस्टीशियल

इनाम वाला चुनें. प्लेसमेंट का नाम डालें, स्किप किए जा सकने वाले विकल्प को चालू करें, और बाकी का फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करें में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को टॉगल करके चालू है पर सेट करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

मूल भाषा वाला

नेटिव चुनें. इसके बाद, प्लेसमेंट का नाम डालें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग के लिए] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

रेफ़रंस आईडी नोट करें और ठीक है पर क्लिक करें.

ऐप का खुलना

300x250 बैनर

मध्यवर्ती

इनाम दिया गया

इनाम वाला इंटरस्टीशियल

मूल भाषा वाला

अपनी रिपोर्टिंग एपीआई पासकोड ढूंढना

बिडिंग

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

झरना

AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, आपको ऐप्लिकेशन आईडी और रेफ़रंस आईडी के साथ-साथ, Liftoff Monetize रिपोर्टिंग एपीआई पासकोड की भी ज़रूरत होगी. Liftoff Monetize की रिपोर्ट के डैशबोर्ड पर जाएं. इसके बाद, रिपोर्टिंग एपीआई पासकोड बटन पर क्लिक करके, अपना रिपोर्टिंग एपीआई पासकोड देखें.

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

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

Liftoff Monetize के लिए app-ads.txt लागू करने के लिए, Liftoff Monetize की app-ads.txt एंट्री डाउनलोड करें और उन्हें अपनी मौजूदा app-ads.txt फ़ाइल में जोड़ें. ज़्यादा जानकारी के लिए, app-ads.txt देखें.

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

टेस्ट विज्ञापन चालू करने के लिए, Liftoff Monetize डैशबोर्ड पर जाएं और ऐप्लिकेशन पर जाएं.

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

Android

iOS

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

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

Android

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

iOS

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

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

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

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

pub.dev के ज़रिए इंटिग्रेशन

अपने पैकेज की pubspec.yaml फ़ाइल में, Liftoff Monetize SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_liftoffmonetize: ^

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

Liftoff Monetize के लिए, Google Mobile Ads mediation प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को निकालें. अब निकाले गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लगिन का रेफ़रंस दें. इसके लिए, यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

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

Liftoff Monetize में Flutter प्लगिन के वर्शन 1.1.0 से, Liftoff Monetize, जीडीपीआर के तहत ली गई सहमति को अपने-आप पढ़ लेता है. यह सहमति, सहमति मैनेजमेंट प्लैटफ़ॉर्म सेट करते हैं. ये प्लैटफ़ॉर्म, Google के अन्य सहमति मोड की तकनीकी जानकारी के साथ काम करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, Android और iOS के लिए, जीडीपीआर के मुताबिक लागू करने के सुझाए गए निर्देश देखें.

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

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

Liftoff Monetize के लिए Google Mobile Ads मीडिएशन प्लगिन में, GmaMediationLiftoffmonetize.setCCPAStatus() तरीका शामिल है. यहां दिए गए सैंपल कोड में, Vungle SDK को सहमति की जानकारी देने का तरीका बताया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो हमारा सुझाव है कि Google Mobile Ads SDK के ज़रिए विज्ञापनों का अनुरोध करने से पहले, इसका इस्तेमाल करें.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

ज़्यादा जानकारी के लिए, सीसीपीए के तहत Android और iOS के लिए, लागू करने के सुझाए गए निर्देश देखें. साथ ही, इस तरीके में दी जा सकने वाली वैल्यू देखें.

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

अगर अडैप्टर को Liftoff Monetize से विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास में जाकर, विज्ञापन के जवाब से जुड़ी गड़बड़ी की जानकारी देख सकते हैं: ResponseInfo:

Android

फ़ॉर्मैट कक्षा का नाम
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (वॉटरफ़ॉल) com.google.ads.mediation.vungle.VungleMediationAdapter
बैनर (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
बैनर (वॉटरफ़ॉल) com.vungle.mediation.VungleInterstitialAdapter
इंटरस्टीशियल (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
इंटरस्टीशियल (वॉटरफ़ॉल) com.vungle.mediation.VungleInterstitialAdapter
इनाम वाले विज्ञापन (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
इनाम वाले विज्ञापन (वॉटरफ़ॉल) com.vungle.mediation.VungleAdapter
इनाम वाला इंटरस्टीशियल (बिडिंग) com.google.ads.mediation.vungle.VungleMediationAdapter
इनाम वाला इंटरस्टीशियल विज्ञापन (वॉटरफ़ॉल) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

फ़ॉर्मैट कक्षा का नाम
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (बिडिंग) GADMediationAdapterVungle
ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन (वॉटरफ़ॉल) GADMediationAdapterVungle
बैनर (बिडिंग) GADMediationAdapterVungle
बैनर (वॉटरफ़ॉल) GADMAdapterVungleInterstitial
इंटरस्टीशियल (बिडिंग) GADMediationAdapterVungle
इंटरस्टीशियल (वॉटरफ़ॉल) GADMAdapterVungleInterstitial
इनाम वाले विज्ञापन (बिडिंग) GADMediationAdapterVungle
इनाम वाले विज्ञापन (वॉटरफ़ॉल) GADMAdapterVungleRewardBasedVideoAd
इनाम वाला इंटरस्टीशियल (बिडिंग) GADMediationAdapterVungle
इनाम वाला इंटरस्टीशियल विज्ञापन (वॉटरफ़ॉल) GADMediationAdapterVungle

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

Android

गड़बड़ी का कोड कारण
101 सर्वर के अमान्य पैरामीटर (जैसे, ऐप्लिकेशन आईडी या प्लेसमेंट आईडी).
102 अनुरोध किया गया बैनर साइज़, Liftoff Monetize के मान्य विज्ञापन साइज़ से मेल नहीं खाता.
103 Liftoff Monetize को विज्ञापन का अनुरोध करने के लिए, Activity कॉन्टेक्स्ट की ज़रूरत होती है.
104 Vungle SDK टूल, एक ही प्लेसमेंट आईडी के लिए कई विज्ञापन लोड नहीं कर सकता.
105 Vungle SDK टूल शुरू नहीं हो सका.
106 Vungle SDK ने लोड होने की सूचना देने वाला कॉलबैक भेजा है, लेकिन Banners.getBanner() या Vungle.getNativeAd() ने null वैल्यू दिखाई है.
107 Vungle SDK, विज्ञापन चलाने के लिए तैयार नहीं है.
108 Vungle SDK टूल से अमान्य बिडिंग टोकन मिला.

iOS

गड़बड़ी का कोड कारण
101 सर्वर के अमान्य पैरामीटर (जैसे, ऐप्लिकेशन आईडी या प्लेसमेंट आईडी).
102 इस नेटवर्क कॉन्फ़िगरेशन के लिए, एक विज्ञापन पहले से ही लोड है. Vungle SDK टूल, एक ही प्लेसमेंट आईडी के लिए दूसरा विज्ञापन लोड नहीं कर सकता.
103 विज्ञापन के लिए अनुरोध किया गया साइज़, Liftoff Monetize के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
104 Vungle SDK टूल, बैनर विज्ञापन को रेंडर नहीं कर सका.
105 Vungle SDK टूल, एक बार में सिर्फ़ एक बैनर विज्ञापन लोड कर सकता है. भले ही, प्लेसमेंट आईडी कुछ भी हो.
106 Vungle SDK टूल ने एक कॉलबैक भेजा है. इसमें बताया गया है कि विज्ञापन नहीं चलाया जा सकता.
107 Vungle SDK, विज्ञापन चलाने के लिए तैयार नहीं है.

Vungle SDK टूल से जुड़ी गड़बड़ियों के लिए, गड़बड़ी के कोड: iOS और Android के लिए Vungle SDK टूल लेख पढ़ें.

Liftoff Monetize के Flutter Mediation Adapter के बदलावों का लॉग

वर्शन 1.2.3 (जारी है)

वर्शन 1.2.2

वर्शन 1.2.1

वर्शन 1.2.0

वर्शन 1.1.1

वर्शन 1.1.0

वर्शन 1.0.0