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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

दूसरा चरण: Ad Manager के यूआई में Liftoff Monetize की बिडिंग सेट अप करना

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

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

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

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

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

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

dependencies:
  gma_mediation_liftoffmonetize: ^1.5.5

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

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

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

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

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

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

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

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

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

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

GmaMediationLiftoffmonetize.setCCPAStatus(true);

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

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

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

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

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

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

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

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

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

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

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

Liftoff Monetize Flutter मीडिएशन अडैप्टर के बदलावों का लॉग

वर्शन 1.5.5

• यह Liftoff Monetize के Android अडैप्टर के वर्शन 7.7.8.1 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के 7.7.7.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.5.4

• यह Liftoff Monetize Android अडैप्टर के वर्शन 7.7.8.0 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के वर्शन 7.7.7.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.5.3

• Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ काम करने के लिए अपडेट किया गया.
• Swift Package Manager के लिए सहायता जोड़ी गई.
• Liftoff Monetize Android अडैप्टर के वर्शन 7.7.7.0 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के 7.7.6.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

संस्‍करण 1.5.2

• Liftoff Monetize Android अडैप्टर के वर्शन 7.7.7.0 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के 7.7.6.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 9.0.0 के साथ बनाया और टेस्ट किया गया है.

संस्‍करण 1.5.1

• Google Mobile Ads Flutter प्लगिन के वर्शन 9.0.0 के साथ काम करने के लिए अपडेट किया गया.
• Liftoff Monetize के Android अडैप्टर का वर्शन 7.7.4.2 काम करता है.
• Liftoff Monetize iOS अडैप्टर के वर्शन 7.7.4.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 9.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.5.0

• Flutter के कम से कम वर्शन को 3.38.1 पर अपडेट किया गया.
• Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया.
• इसमें Liftoff Monetize Android अडैप्टर के 7.7.2.0 वर्शन का इस्तेमाल किया जा सकता है.
• Liftoff Monetize के iOS अडैप्टर के वर्शन 7.7.1.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 8.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.3

• Liftoff Monetize Android adapter version 7.6.3.1 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के वर्शन 7.6.3.1 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 7.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.2

• Flutter के कम से कम वर्शन को 3.35.1 पर अपडेट किया गया
• Google Mobile Ads Flutter प्लगिन के वर्शन 7.0.0 के साथ काम करने के लिए अपडेट किया गया

• Liftoff Monetize Android अडैप्टर के वर्शन 7.6.2.0 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के 7.6.3.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 7.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.1

• Liftoff Monetize Android अडैप्टर के वर्शन 7.6.1.0 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के वर्शन 7.6.2.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.0

• Liftoff Monetize Android अडैप्टर के 7.6.0.0 वर्शन के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के 7.6.1.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.3.0

• Liftoff Monetize Android अडैप्टर के वर्शन 7.5.1.1 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के वर्शन 7.6.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.2.3

• Liftoff Monetize Android अडैप्टर के वर्शन 7.5.1.0 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के 7.5.3.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.2.2

• Liftoff Monetize Android अडैप्टर के वर्शन 7.5.0.1 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के 7.5.2.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.2.1

• यह Liftoff Monetize Android अडैप्टर के वर्शन 7.5.0.0 के साथ काम करता है.
• Liftoff Monetize के iOS अडैप्टर के वर्शन 7.5.1.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.2.0

• यह Liftoff Monetize Android अडैप्टर के वर्शन 7.5.0.0 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के वर्शन 7.5.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.1.1

• Liftoff Monetize Android अडैप्टर वर्शन 7.4.3.1 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के वर्शन 7.4.5.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.1.0

• iOS प्लगिन अब एक स्टैटिक फ़्रेमवर्क है.
• Liftoff Monetize Android अडैप्टर के वर्शन 7.4.3.0 के साथ काम करता है.
• Liftoff Monetize iOS अडैप्टर के 7.4.4.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.0.0

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