LY Ads Network को मीडिएशन के साथ इंटिग्रेट करना

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

इस गाइड में बताया गया है कि Google Mobile Ads Flutter Plugin का इस्तेमाल करके, मीडिएशन की मदद से LY Ads Network से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें वॉटरफ़ॉल इंटिग्रेशन शामिल हैं. इसमें विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में 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 Ads Network से मंज़ूरी पाने के लिए, अपने ऐप्लिकेशन की ज़्यादा जानकारी वाले पेज पर जाकर, समीक्षा करें पर क्लिक करें. इसमें थोड़ा समय लग सकता है. अगर आपका कोई सवाल है, तो LY Ads Network के प्रतिनिधि से संपर्क करें.

    प्रोफ़ाइल की समीक्षा का अनुरोध करें

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

    रिपोर्टिंग एपीआई पासकोड मैनेज करना टैब पर जाएं और एपीआई पासकोड बनाएं बटन पर क्लिक करें.

    Reporting API Key टैब

    फ़ॉर्म भरें और सेव करें पर क्लिक करें.

    Reporting API Key Form

    अपने एपीआई पासकोड का आईडी और एपीआई पासकोड का सीक्रेट नोट करें.

    Reporting API Key Form

    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 विज्ञापन नेटवर्क कंपनी 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 विज्ञापन नेटवर्क कंपनी एसडीके से भेजा गया 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

    वर्शन 2.2.0

    वर्शन 2.1.3

    • Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ काम करने के लिए अपडेट किया गया.
    • Swift Package Manager की सुविधा जोड़ी गई.
    • Line Android adapter version 3.1.1.1 के साथ काम करता है.
    • Line iOS adapter version 3.0.1.2 के साथ काम करता है.
    • इसे Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है

    वर्शन 2.1.2

    वर्शन 2.1.1

    वर्शन 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 adapter के 3.0.0.0 वर्शन के साथ काम करता है.
    • इसे Google Mobile Ads Flutter प्लगिन के 7.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है

    वर्शन 1.0.6

    वर्शन 1.0.5

    वर्शन 1.0.4

    वर्शन 1.0.3

    वर्शन 1.0.2

    वर्शन 1.0.1

    वर्शन 1.0.0