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

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

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

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

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

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

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

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

• GMA Next-Gen SDK का नया वर्शन.

• मीडिएशन सेट अप करें.

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

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

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

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

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

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

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

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

स्लॉट के बारे में जानकारी पाने के लिए, फ़ॉर्म भरें. बिडिंग टाइप के लिए, इस स्लॉट को वॉटरफ़ॉल मीडिएशन के लिए कॉन्फ़िगर करने के लिए, स्टैंडर्ड चुनें या इस स्लॉट को बिडिंग के लिए कॉन्फ़िगर करने के लिए, 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 की डिमांड सेट अप करना

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

'कंपनियां' सेक्शन में LY Ads Network को जोड़ना

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

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

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

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

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

तीसरा चरण: LY विज्ञापन नेटवर्क कंपनी SDK और अडैप्टर को इंपोर्ट करना

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

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

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

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.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

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 की Maven रिपॉज़िटरी में, LY Ads Network अडैप्टर आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें, LY Ads Network अडैप्टर की .aar फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.

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

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

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

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

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

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

वर्शन 3.1.1.2

• अडैप्टर की Kotlin डिपेंडेंसी को 1.9.0 पर पिन करें. यह GMA NextGen SDK के साथ काम करने वाला Kotlin का सबसे नया वर्शन है.

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

• Google Mobile Ads SDK का वर्शन 25.4.0.
• Google Mobile Ads Next-Gen SDK का वर्शन 1.4.0.
• FiveAd SDK का वर्शन 3.1.1.1.

वर्शन 3.1.1.1

• Maps AgeRestrictedTreatment से Line के ChildDirectedTreatment API पर.

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

• Google Mobile Ads SDK का वर्शन 25.4.0.
• Google Mobile Ads Next-Gen SDK का वर्शन 1.2.1.
• FiveAd SDK का वर्शन 3.1.1.1.

वर्शन 3.1.1.0

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

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

• Google Mobile Ads SDK का वर्शन 25.2.0.
• Google Mobile Ads Next-Gen SDK का वर्शन 1.2.1.
• FiveAd SDK का वर्शन 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

• Google Mobile Ads SDK के tagForUnderAgeOfConsent पैरामीटर को 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

• FiveAdViewEventListener को हटा दिया गया है. अब FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener, और FiveAdNativeEventListener का इस्तेमाल करें.
• 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.