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

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

इस गाइड में बताया गया है कि GMA Next-Gen SDK का इस्तेमाल करके, मीडिएशन की मदद से LY Ads Network से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें वॉटरफ़ॉल इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में LY Ads Network को कैसे जोड़ा जाता है. साथ ही, किसी Android ऐप्लिकेशन में LY Ads Network SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.

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

LY Ads Network के लिए मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:

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

• Android का एपीआई लेवल 24 या इसके बाद का वर्शन

• [बिडिंग के लिए]: बिडिंग में विज्ञापन के सभी फ़ॉर्मैट इंटिग्रेट करने के लिए, LY Ads Network adapter 2.9.20241129.0 या इसके बाद के वर्शन का इस्तेमाल करें (सबसे नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)

• GMA Next-Gen SDK पर अपलोड हुआ नया वीडियो

• मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश

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

अपने LY Ads Network खाते के लिए साइन अप करें और उसमें लॉग इन करें.

नया ऐप्लिकेशन जोड़ना

ऐप्लिकेशन टैब पर जाएं और नया रजिस्ट्रेशन बटन पर क्लिक करें.

फ़ॉर्म भरें और रजिस्ट्रेशन पर क्लिक करें.

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

विज्ञापन स्लॉट बनाना

ऐप्लिकेशन टैब पर, अपने ऐप्लिकेशन की जानकारी देखने के लिए उसे चुनें. स्लॉट सेक्शन में जाकर, जोड़ें पर क्लिक करें.

स्लॉट के बारे में जानकारी पाने के लिए, फ़ॉर्म भरें. बिडिंग टाइप के लिए, वॉटरफ़ॉल मीडिएशन के लिए इस स्लॉट को कॉन्फ़िगर करने के लिए स्टैंडर्ड चुनें. इसके अलावा, बिडिंग के लिए इस स्लॉट को कॉन्फ़िगर करने के लिए Google एसडीके से बिडिंग चुनें. फ़ॉर्म भरने के बाद, बनाएं पर क्लिक करें.

स्लॉट आईडी को नोट करें.

पहला स्लॉट बनाने के बाद, LY Ads Network से मंज़ूरी पाने के लिए, अपने ऐप्लिकेशन की ज़्यादा जानकारी वाले पेज पर समीक्षा करें पर क्लिक करें. इसमें थोड़ा समय लग सकता है. अगर आपका कोई सवाल है, तो LY Ads Network के प्रतिनिधि से संपर्क करें.

Reporting API पासकोड बनाना

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

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

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

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 की डिमांड सेट अप करना

अपने Ad Manager खाते में साइन इन करें.

कंपनियों में LY Ads Network जोड़ें

सुरक्षित तरीके से सिग्नल शेयर करने की सुविधा चालू करना

बिड रिक्वेस्ट पर सुरक्षित तरीके से सिग्नल शेयर करना

एसडीके से बिडिंग के लिए सुरक्षित सिग्नल शेयरिंग की अनुमति देना

LY Ads Network की बिडिंग कॉन्फ़िगर करना

विज्ञापन यूनिट को मैप करने की सुविधा कॉन्फ़िगर करना

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

Android Studio इंटिग्रेशन (सुझाया गया)

ऐप्लिकेशन-लेवल की gradle फ़ाइल में, ये implementation dependencies और कॉन्फ़िगरेशन जोड़ें:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
    implementation("com.google.ads.mediation:line:3.1.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1'
    implementation 'com.google.ads.mediation:line:3.1.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

1. LY Ads Network SDK की .aar फ़ाइल का नया वर्शन डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

2. Google के मेवन डेटाबेस पर, LY Ads Network adapter artifacts पर जाएं. नया वर्शन चुनें. इसके बाद, LY Ads Network अडैप्टर की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

चौथा चरण: ज़रूरी कोड जोड़ना

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

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

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

पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.

LY Ads Network अडैप्टर में, LY Ads Network के लिए टेस्ट मोड चालू करने का एक हेल्पर तरीका होता है. आपको इस विकल्प को सेट करना होगा. इसके बाद ही, शुरू करें GMA Next-Gen SDK, ताकि यह विकल्प LY Ads Network SDK को सही तरीके से फ़ॉरवर्ड किया जा सके.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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

यह पुष्टि करने के लिए कि आपको LY Ads Network से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में LY Ads Network विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.

वैकल्पिक चरण

नेटवर्क के हिसाब से पैरामीटर

LY Ads Network अडैप्टर, अनुरोध के एक अतिरिक्त पैरामीटर के साथ काम करता है. इसे LineExtras क्लास का इस्तेमाल करके, अडैप्टर को पास किया जा सकता है. इस क्लास कंस्ट्रक्टर में ये पैरामीटर शामिल हैं:

enableAdSound

बैनर, इंटरस्टीशियल, और इनाम वाले विज्ञापनों के लिए, आवाज़ के चालू होने की डिफ़ॉल्ट स्थिति तय करने वाला boolean.

यहां एक कोड का उदाहरण दिया गया है. इससे पता चलता है कि इन पैरामीटर को सेट करने वाला विज्ञापन दिखाने का अनुरोध कैसे बनाया जाता है:

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

नेटिव विज्ञापनों का इस्तेमाल करना

विज्ञापन रेंडरिंग

LY Ads Network अडैप्टर, NativeAd के लिए इन फ़ील्ड में डेटा भरता है.

¹ नेटिव विज्ञापनों के लिए, LY Ads Network SDK, ऐप्लिकेशन का आइकॉन ऐसेट उपलब्ध नहीं कराता है. इसके बजाय, LY Ads Network अडैप्टर, ऐप्लिकेशन के आइकॉन को पारदर्शी इमेज से भरता है.

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

अगर अडैप्टर को LY Ads Network से विज्ञापन नहीं मिलता है, तो विज्ञापन रिस्पॉन्स में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से ResponseInfo.getAdSourceResponses() का इस्तेमाल करें:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

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

LINE Android Mediation Adapter के बदलावों की जानकारी

अगला वर्शन

• Maps AgeRestrictedTreatment को Line के ChildDirectedTreatment API पर मैप करता है.

वर्शन 3.1.1.0 (डेवलपमेंट में है)

वर्शन 3.1.0.0

• GMA Next-Gen SDK की डिपेंडेंसी के साथ अडैप्टर बनाने के लिए प्रॉपर्टी जोड़ी गई.
• FiveAd SDK के 3.1.0.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 25.1.0.
• Google Mobile Ads Next-Gen SDK का वर्शन 0.25.0-beta01.
• FiveAd SDK का वर्शन 3.1.0.0.

वर्शन 3.0.1.2

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 25.1.0.
• FiveAd SDK का वर्शन 3.0.1.2.

वर्शन 3.0.1.1

• Google Mobile Ads SDK v24.4.0 या इसके बाद के वर्शन का इस्तेमाल करने पर, नेटिव विज्ञापन इंप्रेशन को अब FiveAd SDK बदल देता है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.9.0.
• FiveAd SDK का वर्शन 3.0.1.1.

वर्शन 3.0.1.0

• tagForUnderAgeOfConsent Google Mobile Ads SDK पैरामीटर को FiveAd SDK पर फ़ॉरवर्ड करने की सुविधा जोड़ी गई.
• FiveAd SDK के 3.0.1.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.9.0.
• FiveAd SDK का वर्शन 3.0.1.0.

वर्शन 3.0.0.0

• FiveAd SDK के 3.0.0.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.9.0.
• FiveAd SDK का वर्शन 3.0.0.0.

वर्शन 2.9.20251028.0

• FiveAd SDK के 2.9.20251028 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.7.0.
• FiveAd SDK टूल का वर्शन 2.9.20251028.0

वर्शन 2.9.20250924.1

• कॉन्टेक्स्ट के क्लास-लेवल के रेफ़रंस हटा दिए गए हैं. इससे मेमोरी लीक की समस्याओं को कम करने में मदद मिल सकती है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.7.0.
• FiveAd SDK टूल का वर्शन 2.9.20250924.1.

वर्शन 2.9.20250924.0

• FiveAd SDK के 2.9.20250924 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.6.0.
• FiveAd SDK टूल का वर्शन 2.9.20250924.0

वर्शन 2.9.20250718.0

• FiveAd SDK के 2.9.20250718 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.3.0.
• FiveAd SDK टूल का वर्शन 2.9.20250718.0.

वर्शन 2.9.20250519.0

• FiveAd SDK के 2.9.20250519 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.3.0.
• FiveAd SDK टूल का वर्शन 2.9.20250519.0.

वर्शन 2.9.20250317.1

• यह अपडेट, FiveAd API के नए वर्शन की मदद से बिडिंग वाले विज्ञापनों के लिए, बैनर लोड करने के डाइमेंशन से जुड़ी समस्याओं को ठीक करता है

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.1.0.
• FiveAd SDK टूल का वर्शन 2.9.20250317.0

वर्शन 2.9.20250317.0

• FiveAd SDK के 2.9.20250317 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.1.0.
• FiveAd SDK टूल का वर्शन 2.9.20250317.0

वर्शन 2.9.20250110.1

• Android के ज़रूरी एपीआई लेवल को 23 पर अपडेट किया गया है.
• Google Mobile Ads SDK के ज़रूरी वर्शन को 24.0.0 पर अपडेट किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.0.0.
• FiveAd SDK टूल का वर्शन 2.9.20250110.0

वर्शन 2.9.20250110.0

• बंद की जा चुकी UnifiedNativeAdMapper क्लास को हटाकर NativeAdMapper क्लास को जोड़ा गया
• सिग्नल इकट्ठा करने की प्रोसेस तय की गई है.
• वॉटरफ़ॉल इंटरस्टीशियल और इनाम वाले विज्ञापन फ़ॉर्मैट के लिए, विज्ञापन दिखाने की प्रोसेस ठीक की गई.
• FiveAd SDK के 2.9.20250110 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 23.6.0.
• FiveAd SDK टूल का वर्शन 2.9.20250110.0

वर्शन 2.9.20241129.0

• बैनर, इंटरस्टीशियल, इनाम वाले, और नेटिव विज्ञापन फ़ॉर्मैट के लिए बिडिंग की सुविधा जोड़ी गई.
• FiveAd SDK के 2.9.20241129 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 23.5.0.
• FiveAd SDK का वर्शन 2.9.20241129.0

वर्शन 2.8.20240827.0

• FiveAd SDK के 2.8.20240827 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 23.3.0.
• FiveAd SDK का वर्शन 2.8.20240827.0

वर्शन 2.8.20240808.0

• FiveAd SDK के 2.8.20240808 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 23.2.0.
• FiveAd SDK टूल का वर्शन 2.8.20240808.0

वर्शन 2.8.20240722.0

• FiveAd SDK के 2.8.20240722 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 23.2.0.
• FiveAd SDK का वर्शन 2.8.20240722.0

वर्शन 2.7.20240515.0

• FiveAd SDK के 2.7.20240515 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 23.1.0.
• FiveAd SDK टूल का वर्शन 2.7.20240515.0

वर्शन 2.7.20240214.1

• Google Mobile Ads SDK के ज़रूरी वर्शन को 23.0.0 पर अपडेट किया गया है.
• FiveAd SDK के 2.7.20240214 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 23.0.0.
• FiveAd SDK टूल का वर्शन 2.7.20240214.0.

वर्शन 2.7.20240214.0

• FiveAd SDK के 2.7.20240214 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 22.6.0.
• FiveAd SDK टूल का वर्शन 2.7.20240214.0.

वर्शन 2.7.20240126.0

• FiveAd SDK के 2.7.20240126 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 22.6.0.
• FiveAd SDK टूल का वर्शन 2.7.20240126.0.

वर्शन 2.7.20240112.0

• FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener, और FiveAdNativeEventListener के लिए, इस्तेमाल नहीं किए जा सकने वाले FiveAdViewEventListener को हटा दिया गया है.
• FiveAd SDK के 2.7.20240112 वर्शन के साथ काम करने की पुष्टि की गई है.
• Google Mobile Ads SDK के ज़रूरी वर्शन को 22.6.0 पर अपडेट किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 22.6.0.
• FiveAd SDK टूल का वर्शन 2.7.20240112.

वर्शन 2.6.20230607.1

• पब्लिशर के लिए LineExtras क्लास जोड़ी गई है, ताकि वे बैनर, इंटरस्टीशियल, और इनाम वाले विज्ञापन फ़ॉर्मैट के लिए, आवाज़ की डिफ़ॉल्ट सेटिंग तय कर सकें.
• Google Mobile Ads SDK के ज़रूरी वर्शन को 22.4.0 पर अपडेट किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 22.4.0.
• FiveAd SDK टूल का वर्शन 2.6.20230607.

वर्शन 2.6.20230607.0

• शुरुआती रिलीज़.
• बैनर, इंटरस्टीशियल, इनाम वाले, और नेटिव विज्ञापन फ़ॉर्मैट के लिए सहायता जोड़ी गई है.
• FiveAd SDK के 2.6.20230607 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 22.1.0.
• FiveAd SDK टूल का वर्शन 2.6.20230607.