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

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

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

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

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

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

• iOS डिप्लॉयमेंट का टारगेट 13.3 या इसके बाद का वर्शन होना चाहिए

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

• Google Mobile Ads 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 और अडैप्टर को इंपोर्ट करना

Swift Package Manager का इस्तेमाल करना

आगे बढ़ने से पहले, आपके पास अडैप्टर का कम से कम 2.9.20251119 वर्शन होना चाहिए.

अपने प्रोजेक्ट में पैकेज डिपेंडेंसी जोड़ने के लिए, यह तरीका अपनाएं:

1. Xcode में, File > Add Package Dependencies... पर जाएं.

2. दिखने वाले प्रॉम्प्ट में, इस पैकेज यूआरएल को खोजें:

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. डिपेंडेंसी का नियम में जाकर, ब्रांच चुनें.

4. टेक्स्ट फ़ील्ड में, main डालें.

CocoaPods का इस्तेमाल करना

अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:

pod 'GoogleMobileAdsMediationLine'

कमांड लाइन से यह निर्देश चलाएं:

pod install --repo-update

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

• LY Ads Network SDK का नया वर्शन डाउनलोड करें और FiveAd.framework को अपने प्रोजेक्ट में लिंक करें.
• बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, LY Ads Network अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, LineAdapter.framework को अपने प्रोजेक्ट में लिंक करें.

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

SKAdNetwork लागू करना

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, LY Ads Network के दस्तावेज़ पढ़ें.

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

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

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

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

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

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

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

वैकल्पिक चरण

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

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

adAudio

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

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

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

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

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

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

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

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

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

GADMediationAdapterLine

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

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

वर्शन 3.0.1.2

• Google Mobile Ads SDK की डिपेंडेंसी को कम करने के लिए, iOS के ज़रूरी वर्शन को अपडेट किया गया है, ताकि माइनर वर्शन को अनुमति दी जा सके.
• उस समस्या को ठीक किया गया है जिसमें नेटिव विज्ञापनों के लिए AdChoices आइकॉन बहुत बड़े दिखते थे.

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

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

वर्शन 3.0.1.1

• अब अडैप्टर, ageRestrictedTreatment Google Mobile Ads SDK फ़्लैग को FiveAd SDK के COPPA API पर फ़ॉरवर्ड करता है.

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

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

वर्शन 3.0.1.0

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

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

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

वर्शन 3.0.0.1

• Google Mobile Ads SDK की डिपेंडेंसी को 13.0.0 वर्शन पर अपडेट किया गया है.

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

• Google Mobile Ads SDK का वर्शन 13.0.0.
• FiveAd SDK का वर्शन 3.0.0.

वर्शन 3.0.0.0

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

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

• Google Mobile Ads SDK का वर्शन 12.14.0.
• FiveAd SDK का वर्शन 3.0.0.

वर्शन 2.9.20251119.1

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

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

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

वर्शन 2.9.20251119.0

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

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

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

वर्शन 2.9.20250930.0

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

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

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

वर्शन 2.9.20250912.0

• अब अडैप्टर, हर विज्ञापन दिखाने के अनुरोध से पहले FiveAd SDK को शुरू करता है.
• FiveAd SDK के 2.9.20250912 वर्शन के साथ काम करने की पुष्टि की गई है.

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

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

वर्शन 2.9.20250512.0

• अब इसके लिए, iOS 13.0 या इसके बाद का वर्शन होना ज़रूरी है.
• FiveAd SDK के 2.9.20250512 वर्शन के साथ काम करने की पुष्टि की गई है.

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

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

वर्शन 2.9.20241106.3

• उस समस्या को ठीक किया गया है जिसमें GADMediationAdapterLine.h एक सार्वजनिक हेडर नहीं था.
• -fobjc-arc और -fstack-protector-all फ़्लैग चालू किए गए हों.
• बैनर विज्ञापन के साइज़ की पुष्टि करने की सुविधा को हटा दिया गया है. यह सुविधा, विज्ञापन के लोड होने के बाद बिडिंग के लिए उपलब्ध होती थी.
  • लोड होने के बाद, वॉटरफ़ॉल बैनर विज्ञापन, बैनर विज्ञापन के साइज़ की जांच करते रहेंगे.

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

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

वर्शन 2.9.20241106.2

• GADMediationAdapterLine.testMode प्रॉपर्टी जोड़ी गई है. इससे यह पता चलेगा कि FiveAd SDK को टेस्ट मोड में शुरू किया जाना चाहिए या नहीं. Google Mobile Ads SDK को शुरू करने से पहले, इस फ़्लैग को सेट करना ज़रूरी है.
• FiveAd SDK को शुरू करने से पहले, FiveAd SDK की शुरू होने की स्थिति की जांच करने की सुविधा हटा दी गई है.
• नेटिव विज्ञापन की ऐसेट डाउनलोड करने से पहले, बंद किए गए नेटिव विज्ञापन की स्थिति की जांच करने की सुविधा हटा दी गई है.
• अब इसके लिए, Google Mobile Ads SDK का 12.0.0 या इसके बाद का वर्शन ज़रूरी है.

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

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

वर्शन 2.9.20241106.1

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

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

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

वर्शन 2.9.20241106.0

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

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

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

वर्शन 2.8.20240827.1

• CFBundleShortVersionString को अपडेट किया गया है. अब इसमें चार के बजाय तीन कॉम्पोनेंट होंगे.

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

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

वर्शन 2.8.20240827.0

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

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

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

वर्शन 2.8.20240612.0

• GADVideoOptions के ज़रिए, नेटिव विज्ञापन के लिए ऑडियो कंट्रोल जोड़ा गया.
• FiveAd SDK के 2.8.20240612 वर्शन के साथ काम करने की पुष्टि की गई है.

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

• Google Mobile Ads SDK का वर्शन 11.5.0.
• FiveAd SDK का वर्शन 2.8.20240612.

वर्शन 2.7.20240411.0

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

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

• Google Mobile Ads SDK का वर्शन 11.3.0.
• FiveAd SDK का वर्शन 2.7.20240411.

वर्शन 2.7.20240318.0

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

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

• Google Mobile Ads SDK का वर्शन 11.2.0.
• FiveAd SDK का वर्शन 2.7.20240318.

वर्शन 2.7.20240214.1

• अब इसके लिए, iOS 12.0 या इसके बाद का वर्शन होना ज़रूरी है.
• अब इसके लिए, Google Mobile Ads SDK का 11.0 या इसके बाद का वर्शन ज़रूरी है.
• LineAdapter.xcframework में मौजूद फ़्रेमवर्क में Info.plist शामिल है.

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

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

वर्शन 2.7.20240214.0

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

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

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

वर्शन 2.7.20240126.0

• FiveAd SDK के 2.7.20240126 वर्शन के साथ काम करने की पुष्टि की गई है.
• FiveAd SDK के नए डेलिगेट प्रोटोकॉल के साथ, अडैप्टर को लागू करने की प्रोसेस को अपडेट किया गया है.

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

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

वर्शन 2.7.20231115.0

• FiveAd SDK के 2.7.20231115 वर्शन के साथ काम करने की पुष्टि की गई है.
• मॉड्यूलमैप में GADMediationAdapterLineExtras हेडर शामिल किया गया है.

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

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

वर्शन 2.6.20230609.1

• बैनर, इंटरस्टीशियल, और इनाम वाले विज्ञापन के पहली बार दिखने पर, उनकी शुरुआती ऑडियो स्थिति को मैनेज करने के लिए GADMediationAdapterLineAudioState जोड़ा गया है.

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

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

वर्शन 2.6.20230609.0

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

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

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