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

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

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

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

1 बिडिंग इंटिग्रेशन, ओपन बीटा वर्शन में उपलब्ध है.

इस फ़ॉर्मैट के लिए, 2 वॉटरफ़ॉल इंटिग्रेशन का ओपन बीटा वर्शन उपलब्ध है.

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

  • Google Mobile Ads SDK का सबसे नया वर्शन
  • Flutter 3.7.0 या इसके बाद का वर्शन
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 21 या उसके बाद का वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
  • Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया Flutter ऐसा प्रोजेक्ट जो काम कर रहा हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
  • मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

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

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

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

ऐप का खुलना

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

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

300x250 बैनर

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

मध्यवर्ती

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

इनाम दिया गया

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

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

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

मूल भाषा वाला

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

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

ऐप का खुलना

300x250 बैनर

मध्यवर्ती

इनाम दिया गया

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

मूल भाषा वाला

अपना Reporting API पासकोड ढूंढना

बिडिंग

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

झरना

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

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

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

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

Android

iOS

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

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

Android

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

iOS

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

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

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

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

pub.dev की मदद से इंटिग्रेशन

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

dependencies:
  gma_mediation_liftoffmonetize: ^1.0.0

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

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

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

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

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

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

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

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, जीडीपीआर के सुझाए गए 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 मीडिएशन अडैप्टर में हुए बदलावों का लॉग

अगला वर्शन

  • Google Mobile Ads Flutter प्लग इन के 5.2.0 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 1.1.0

  • Liftoff Monetize के Android अडैप्टर के 7.4.0.1 वर्शन के साथ काम करने की पुष्टि की गई
  • LiftoffMonetize के iOS अडैप्टर के 7.4.0.1 वर्शन के साथ काम करने की पुष्टि की गई
  • Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 1.0.0

  • शुरुआती रिलीज़.
  • Liftoff Monetize के Android अडैप्टर के 7.3.1.0 वर्शन के साथ काम करने की पुष्टि की गई है
  • LiftoffMonetize के iOS अडैप्टर के 7.3.2.0 वर्शन के साथ काम करने की पुष्टि की गई
  • Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.