इस गाइड में बताया गया है कि Google Mobile Ads Flutter Plugin का इस्तेमाल करके, मीडिएशन की मदद से LY विज्ञापन नेटवर्क कंपनी से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें वॉटरफ़ॉल इंटिग्रेशन शामिल हैं. इसमें विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में LY Ads Network को जोड़ने का तरीका बताया गया है. साथ ही, Flutter ऐप्लिकेशन में LY Ads Network SDK और अडैप्टर को इंटिग्रेट करने का तरीका बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
LY Ads Network के लिए Ad Manager मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | |
| फ़ॉर्मैट | |
| बैनर वाले विज्ञापन | |
| इंटरस्टीशियल विज्ञापन | |
| इनाम वाले विज्ञापन | |
| मूल भाषा वाला | |
ज़रूरी शर्तें
जारी रखने से पहले, इनकी पुष्टि करें:
- 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 सेट अप करना लेख पढ़ें.
पहला चरण: LY Ads Network के यूआई में कॉन्फ़िगरेशन सेट अप करना
अपने LY Ads Network खाते में साइन अप और लॉग इन करें.
नया ऐप्लिकेशन जोड़ना
ऐप्लिकेशन टैब पर जाएं और नया रजिस्ट्रेशन बटन पर क्लिक करें.
फ़ॉर्म भरें और रजिस्ट्रेशन पर क्लिक करें.
ऐप्लिकेशन आईडी को नोट करें.
Android
iOS
विज्ञापन स्लॉट बनाना
ऐप्लिकेशन टैब में जाकर, अपने ऐप्लिकेशन की जानकारी देखने के लिए उसे चुनें. स्लॉट सेक्शन में जाकर, जोड़ें पर क्लिक करें.
स्लॉट के बारे में जानकारी पाने के लिए, फ़ॉर्म भरें. बिडिंग टाइप के लिए, स्टैंडर्ड चुनें, ताकि इस स्लॉट को वॉटरफ़ॉल मीडिएशन के लिए कॉन्फ़िगर किया जा सके या Google SDK से बिडिंग चुनें, ताकि इस स्लॉट को बिडिंग के लिए कॉन्फ़िगर किया जा सके. फ़ॉर्म भरने के बाद, बनाएं पर क्लिक करें.
स्लॉट आईडी को नोट करें.
पहला स्लॉट बनाने के बाद, LY विज्ञापन नेटवर्क कंपनी से मंज़ूरी पाने के लिए, अपने ऐप्लिकेशन की ज़्यादा जानकारी वाले पेज पर जाकर समीक्षा करें पर क्लिक करें. इसमें थोड़ा समय लग सकता है. अगर आपका कोई सवाल है, तो LY Ads Network के प्रतिनिधि से संपर्क करें.
रिपोर्टिंग एपीआई पासकोड बनाना
रिपोर्टिंग एपीआई पासकोड मैनेज करना टैब पर जाएं और एपीआई पासकोड बनाएं बटन पर क्लिक करें.
फ़ॉर्म भरें और सेव करें पर क्लिक करें.
अपने एपीआई पासकोड का आईडी और एपीआई पासकोड का सीक्रेट नोट करें.
app-ads.txt फ़ाइल को अपडेट करना
ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी.
अगर आपने अब तक ऐसा नहीं किया है, तो
Ad Manager के लिए app-ads.txt फ़ाइल बनाएं.
LY Ads Network के लिए app-ads.txt लागू करने के लिए, app-ads.txt के बारे में जानकारी देखें.
दूसरा चरण: Ad Manager के यूआई में LY Ads Network की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android के लिए दी गई गाइड में दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.
तीसरा चरण: LY Ads Network SDK और अडैप्टर को इंपोर्ट करना
pub.dev के ज़रिए इंटिग्रेशन
अपने पैकेज की pubspec.yaml फ़ाइल में, LY विज्ञापन नेटवर्क कंपनी SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_line: ^2.2.1
मैन्युअल इंटिग्रेशन
LY Ads Network के लिए, Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें और एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में यह डिपेंडेंसी जोड़कर, प्लग इन को रेफ़रंस के तौर पर शामिल करें:
dependencies:
gma_mediation_line:
path: path/to/local/package
चौथा चरण: ज़रूरी कोड जोड़ना
Android
LY Ads Network को इंटिग्रेट करने के लिए, किसी और कोड की ज़रूरत नहीं है.
iOS
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, LY Ads Network के दस्तावेज़ पढ़ें.
पांचवां चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको LY Ads Network से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में LY Ads Network विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.
वैकल्पिक चरण
नेटवर्क के हिसाब से पैरामीटर
LY Ads Network Flutter मीडिएशन प्लगिन, अनुरोध के इन अतिरिक्त पैरामीटर के साथ काम करता है. इन्हें LineMediationExtras क्लास की मदद से अडैप्टर को पास किया जा सकता है:
-
enableAdSound: इससे बैनर, इंटरस्टीशियल, और इनाम वाले विज्ञापनों के लिए, डिफ़ॉल्ट रूप से आवाज़ चालू होने की स्थिति के बारे में पता चलता है.
यहां कोड का एक उदाहरण दिया गया है. इसमें बताया गया है कि इन पैरामीटर को सेट करने वाला विज्ञापन दिखाने का अनुरोध कैसे बनाया जाता है:
LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [lineExtras],
);
गड़बड़ी के कोड
अगर अडैप्टर को LY Ads Network से विज्ञापन नहीं मिलता है, तो पब्लिशर, विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से ResponseInfo का इस्तेमाल कर सकते हैं:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
विज्ञापन लोड न होने पर, LY Ads Network अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:
Android
| गड़बड़ी का कोड | डोमेन | कारण |
|---|---|---|
| 1-10 | com.five_corp.ad | LY Ads Network SDK से, एसडीके से जुड़ी गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, LY Ads Network का दस्तावेज़ देखें. |
| 101 | com.google.ads.mediation.line | ऐप्लिकेशन आईडी मौजूद नहीं है या अमान्य है. |
| 102 | com.google.ads.mediation.line | स्लॉट आईडी मौजूद नहीं है या अमान्य है. |
| 103 | com.google.ads.mediation.line | जिस विज्ञापन साइज़ का अनुरोध किया गया है वह LY Ads Network के साथ काम करने वाले बैनर विज्ञापन के साइज़ से मेल नहीं खाता है. |
| 104 | com.google.ads.mediation.line | गतिविधि का कॉन्टेक्स्ट मौजूद न होने की वजह से, पेज पर अचानक दिखने वाला विज्ञापन या इनाम वाला विज्ञापन लोड नहीं हो सका. |
| 105 | com.google.ads.mediation.line | LY Ads Network SDK, पेज पर अचानक दिखने वाला विज्ञापन या इनाम वाला विज्ञापन नहीं दिखा सका. |
| 106 | com.google.ads.mediation.line | ऐसेट मौजूद न होने की वजह से, नेटिव विज्ञापन लोड नहीं किया जा सका. |
| 107 | com.google.ads.mediation.line | FiveAd SDK टूल ने विज्ञापन लोड करने वाला शून्य ऑब्जेक्ट दिखाया. |
iOS
| गड़बड़ी का कोड | डोमेन | कारण |
|---|---|---|
| 1-10 | LY Ads Network SDK से भेजा गया | LY Ads Network SDK से, एसडीके से जुड़ी गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, LY Ads Network का दस्तावेज़ देखें. |
| 101 | com.google.ads.mediation.line | सर्वर के पैरामीटर अमान्य हैं. जैसे, ऐप्लिकेशन आईडी या स्लॉट आईडी मौजूद न होना. |
| 102 | com.google.ads.mediation.line | जिस विज्ञापन साइज़ का अनुरोध किया गया है वह LY Ads Network के साथ काम करने वाले बैनर विज्ञापन के साइज़ से मेल नहीं खाता है. |
| 103 | com.google.ads.mediation.line | नेटिव विज्ञापन में जानकारी के आइकॉन वाली इमेज ऐसेट लोड नहीं की जा सकी. |
| 104 | com.google.ads.mediation.line | बिडिंग के लिए सिग्नल इकट्ठा नहीं किए जा सके. |
| 105 | com.google.ads.mediation.line | LINE Ads SDK के विज्ञापन लोडर को शुरू नहीं किया जा सका. |
Line Flutter मीडिएशन अडैप्टर के बदलावों का लॉग
वर्शन 2.2.2 (डेवलपमेंट में है)
- अब इसके लिए, iOS 15.0 या इसके बाद का वर्शन होना ज़रूरी है.
वर्शन 2.2.1
- Line Android अडैप्टर के वर्शन 3.1.1.2 के साथ काम करता है.
- Line iOS अडैप्टर के वर्शन 3.1.1.0 के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है
वर्शन 2.2.0
- Line Android अडैप्टर के वर्शन 3.1.1.1 के साथ काम करता है.
- Line iOS अडैप्टर के 3.1.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है
वर्शन 2.1.3
- Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ काम करने के लिए अपडेट किया गया.
- Swift Package Manager की सुविधा जोड़ी गई.
- Line Android अडैप्टर के वर्शन 3.1.1.1 के साथ काम करता है.
- Line iOS अडैप्टर के वर्शन 3.0.1.2 के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है
वर्शन 2.1.2
- Line Android अडैप्टर के वर्शन 3.1.1.1 के साथ काम करता है.
- Line iOS अडैप्टर के वर्शन 3.0.1.2 के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के वर्शन 9.0.0 के साथ बनाया और टेस्ट किया गया है
वर्शन 2.1.1
- यह Line Android अडैप्टर के वर्शन 3.1.1.0 के साथ काम करता है.
- Line iOS अडैप्टर के वर्शन 3.0.1.2 के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के वर्शन 9.0.0 के साथ बनाया और टेस्ट किया गया है
वर्शन 2.1.0
- Flutter के कम से कम वर्शन को 3.38.1 पर अपडेट किया गया
- Google Mobile Ads Flutter प्लगिन के वर्शन 8.0.0 के साथ काम करने के लिए अपडेट किया गया
- Line Android अडैप्टर के वर्शन 3.1.0.0 के साथ काम करता है.
- Line iOS अडैप्टर के 3.0.1.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है
वर्शन 2.0.0
- Flutter के कम से कम वर्शन को 3.35.1 पर अपडेट किया गया
- Google Mobile Ads Flutter प्लगिन के वर्शन 7.0.0 के साथ काम करने के लिए अपडेट किया गया
- Line Android अडैप्टर के 3.0.1.0 वर्शन के साथ काम करता है.
- Line iOS अडैप्टर के 3.0.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के वर्शन 7.0.0 के साथ बनाया और टेस्ट किया गया है
वर्शन 1.0.6
- Line Android अडैप्टर के वर्शन 2.9.20251028.0 के साथ काम करता है.
- Line iOS अडैप्टर के वर्शन 2.9.20251119.0 के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है
वर्शन 1.0.5
- यह Line Android अडैप्टर के वर्शन 2.9.20250924.1 के साथ काम करता है.
- यह Line iOS अडैप्टर के 2.9.20250930.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है
वर्शन 1.0.4
- यह Line Android अडैप्टर के 2.9.20250718.0 वर्शन के साथ काम करता है.
- यह Line iOS अडैप्टर के 2.9.20250512.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है
वर्शन 1.0.3
- यह Line Android अडैप्टर के 2.9.20250519.0 वर्शन के साथ काम करता है.
- यह Line iOS अडैप्टर के 2.9.20250512.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है
वर्शन 1.0.2
- Line Android अडैप्टर के 2.9.20250317.1 वर्शन के साथ काम करता है.
- यह Line iOS अडैप्टर के 2.9.20241106.3 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है
वर्शन 1.0.1
- यह Line Android अडैप्टर के वर्शन 2.9.20250110.1 के साथ काम करता है.
- यह Line iOS अडैप्टर के 2.9.20241106.2 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.0.0
- शुरुआती रिलीज़.
- Line Android अडैप्टर के 2.9.20250110.0 वर्शन के साथ काम करता है.
- यह Line iOS अडैप्टर के वर्शन 2.9.20241106.1 के साथ काम करता है.
- इसे Google Mobile Ads Flutter प्लगिन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.