इस गाइड में, AdMob मीडिएशन का इस्तेमाल करके, Line से विज्ञापन लोड करने और दिखाने के लिए, Google Mobile Ads SDK टूल का इस्तेमाल करने का तरीका बताया गया है. इसमें वॉटरफ़ॉल इंटिग्रेशन के बारे में भी बताया गया है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Line को जोड़ने का तरीका बताया गया है. साथ ही, Android ऐप्लिकेशन में Line SDK टूल और अडैप्टर को इंटिग्रेट करने का तरीका भी बताया गया है.
Line के डैशबोर्ड इंटरफ़ेस में, लेबल, बटन, और ब्यौरे के लिए जैपनीज़ टेक्स्ट का इस्तेमाल किया जाता है. इस गाइड में मौजूद स्क्रीनशॉट का अनुवाद नहीं किया गया है. हालांकि, इस गाइड के ब्यौरे और निर्देशों में, लेबल और बटन के अनुवाद के साथ ब्रैकेट में अंग्रेज़ी भाषा के बराबर के शब्द दिए गए हैं.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
Line के लिए मीडिएशन अडैप्टर में ये सुविधाएं हैं:
इंटिग्रेशन | |
---|---|
बिडिंग | |
झरना | 1 |
फ़ॉर्मैट | |
बैनर | |
मध्यवर्ती | |
इनाम दिया गया | |
मूल भाषा वाला |
1 वॉटरफ़ॉल इंटिग्रेशन, ओपन बीटा वर्शन में उपलब्ध है.
ज़रूरी शर्तें
- Android एपीआई लेवल 21 या उसके बाद का वर्शन
Google Mobile Ads SDK का सबसे नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड
पहला चरण: Line के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
अपने Line खाते में लॉग इन करें.
नया ऐप्लिकेशन जोड़ना
広告枠管理 (विज्ञापन स्लॉट मैनेजमेंट) > मीडिया (मीडिया) पर क्लिक करें. इसके बाद, 新規作成 (नया बनाएं) पर क्लिक करें.
फ़ॉर्म भरें और 登録 (Register) पर क्लिक करें.
ऐप्लिकेशन आईडी को नोट करें.
विज्ञापन प्लेसमेंट बनाना
उस ऐप्लिकेशन के आईडी पर क्लिक करें जिसमें आपको विज्ञापन प्लेसमेंट जोड़ना है. इसके बाद, 詳細 (जानकारी) को चुनें.
スロット 追加 (Add Slot) पर क्लिक करें.
फ़ॉर्म भरें और इसके बाद, (登録) रजिस्टर करें पर क्लिक करें.
स्लॉट आईडी को नोट करें.
दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में लाइन डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में लाइन जोड़नी होगी.
सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपके पास कोई मौजूदा मीडिएशन ग्रुप है जिसमें आपको बदलाव करना है, तो उसमें बदलाव करने के लिए, मीडिएशन ग्रुप के नाम पर क्लिक करें. इसके बाद, विज्ञापन स्रोत के तौर पर Line जोड़ें पर जाएं.
नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.
विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म डालें. इसके बाद, जारी रखें पर क्लिक करें.
अपने मीडिएशन ग्रुप को कोई नाम दें और टारगेट करने के लिए जगहें चुनें. इसके बाद, मीडिएशन ग्रुप का स्टेटस चालू है पर सेट करें. इसके बाद, विज्ञापन यूनिट जोड़ें पर क्लिक करें.
इस मीडिएशन ग्रुप को अपनी एक या उससे ज़्यादा मौजूदा AdMob विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.
अब आपको विज्ञापन यूनिट कार्ड दिखेगा, जिसमें आपने जो विज्ञापन यूनिट चुनी हैं वे दिखेंगी:
Line को विज्ञापन स्रोत के तौर पर जोड़ना
बिडिंग
विज्ञापन स्रोत सेक्शन में, बिडिंग कार्ड में जाकर, विज्ञापन स्रोत जोड़ें को चुनें. इसके बाद, लाइन चुनें .
पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें. इसके बाद, Line के साथ बिडिंग पार्टनरशिप सेट अप करें.
स्वीकार करें और सहमत हों पर क्लिक करें. इसके बाद, जारी रखें पर क्लिक करें.
अगर आपके पास पहले से ही Line के लिए मैपिंग है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.
इसके बाद, पिछले सेक्शन में मिले ऐप्लिकेशन आईडी और स्लॉट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.
झरना
विज्ञापन स्रोत सेक्शन में, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन स्रोत जोड़ें को चुनें. इसके बाद, लाइन चुनें.
लाइन चुनें. इसके बाद, लाइन के लिए eCPM वैल्यू डालें और जारी रखें पर क्लिक करें.
अगर आपके पास पहले से ही लाइन के लिए मैपिंग है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.
इसके बाद, पिछले सेक्शन में मिले ऐप्लिकेशन आईडी और स्लॉट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.
तीसरा चरण: Line SDK और अडैप्टर इंपोर्ट करना
Android Studio इंटिग्रेशन (सुझाया गया)
अपने ऐप्लिकेशन-लेवल की build.gradle.kts
फ़ाइल में, लागू करने के लिए ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. Line SDK टूल और अडैप्टर के सबसे नए वर्शन का इस्तेमाल करें:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:line:2.8.20240827.0")
}
मैन्युअल इंटिग्रेशन
Line SDK की
.aar
फ़ाइल का नया वर्शन डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.Google के Maven Repository पर, लाइन अडैप्टर आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें, Line ऐडैप्टर की
.aar
फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.
चौथा चरण: ज़रूरी कोड जोड़ना
Line इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं होती.
पांचवां चरण: लागू किए गए टूल की जांच करना
टेस्ट विज्ञापन चालू करना
पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.
Line टेस्ट विज्ञापनों को चालू करने के तरीके के बारे में जानने के लिए, Line के दस्तावेज़ में दिए गए निर्देशों का पालन करें.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको Line से टेस्ट विज्ञापन मिल रहे हैं, Line (वॉटरफ़ॉल) विज्ञापन स्रोत का इस्तेमाल करके, Ad Inspector में विज्ञापन के किसी एक स्रोत की जांच की सुविधा चालू करें.
वैकल्पिक चरण
नेटवर्क के हिसाब से पैरामीटर
लाइन अडैप्टर, अनुरोध के लिए एक और पैरामीटर के साथ काम करता है. इसे LineExtras
क्लास का इस्तेमाल करके, अडैप्टर को पास किया जा सकता है. इस क्लास के कंस्ट्रक्टर में ये पैरामीटर शामिल होते हैं:
enableAdSound
- A
boolean
, बैनर, इंटरस्टीशियल, और इनाम वाले विज्ञापनों के लिए, साउंड के शुरू होने की डिफ़ॉल्ट स्थिति तय करने के लिए.
यहां इन पैरामीटर को सेट करने वाला विज्ञापन अनुरोध बनाने का कोड उदाहरण दिया गया है:
Java
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
.build()
नेटिव विज्ञापनों का इस्तेमाल करना
विज्ञापन रेंडर करना
लाइन अडैप्टर, NativeAd
के लिए, इन नेटिव विज्ञापनों के बेहतर फ़ील्ड के ब्यौरे को भरता है.
फ़ील्ड | लाइन अडैप्टर की मदद से हमेशा शामिल होने वाली ऐसेट |
---|---|
हेडलाइन | |
इमेज | |
मुख्य भाग | |
ऐप्लिकेशन का आइकॉन | 1 |
कॉल-टू-ऐक्शन | |
स्टार रेटिंग | |
स्टोर | |
कीमत |
1 नेटिव विज्ञापनों के लिए, Line SDK टूल, ऐप्लिकेशन आइकॉन एसेट उपलब्ध नहीं कराता. इसके बजाय, Line अडैप्टर ऐप्लिकेशन के आइकॉन में पारदर्शी इमेज भरता है.
गड़बड़ी के कोड
अगर अडैप्टर को Line से कोई विज्ञापन नहीं मिलता है, तो इन क्लास में ResponseInfo.getAdapterResponses()
का इस्तेमाल करके, विज्ञापन के जवाब से जुड़ी गड़बड़ी देखी जा सकती है:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
जब कोई विज्ञापन लोड नहीं होता है, तो Line अडैप्टर से ये कोड और मैसेज मिलते हैं:
गड़बड़ी का कोड | डोमेन | कारण |
---|---|---|
1-10 | com.five_corp.ad | Line SDK टूल से, SDK टूल से जुड़ी कोई गड़बड़ी मिली. ज़्यादा जानकारी के लिए, Line का दस्तावेज़ देखें. |
101 | com.google.ads.mediation.line | ऐप्लिकेशन आईडी मौजूद नहीं है या अमान्य है. |
102 | com.google.ads.mediation.line | स्लॉट आईडी मौजूद नहीं है या अमान्य है. |
103 | com.google.ads.mediation.line | अनुरोध किया गया विज्ञापन साइज़, Line के साथ काम करने वाले बैनर विज्ञापन के साइज़ से मेल नहीं खाता. |
104 | com.google.ads.mediation.line | गतिविधि के संदर्भ मौजूद न होने की वजह से, इंटरस्टीशियल या इनाम वाला विज्ञापन लोड नहीं हो सका. |
105 | com.google.ads.mediation.line | Line SDK टूल, अचानक दिखने वाला विज्ञापन या इनाम वाला विज्ञापन नहीं दिखा सका. |
106 | com.google.ads.mediation.line | ऐसेट मौजूद न होने की वजह से, नेटिव विज्ञापन लोड नहीं हो सका. |
LINE Android Mediation Adapter के बदलावों का लॉग
अगला वर्शन
- बैनर विज्ञापनों के लिए आरटीबी को चालू करने के लिए, AdLoader लागू किया गया.
- इंटरस्टीशियल विज्ञापनों के लिए आरटीबी को चालू करने के लिए, AdLoader लागू किया गया.
- इनाम वाले विज्ञापनों के लिए आरटीबी को चालू करने के लिए, AdLoader लागू किया गया.
- नेटिव विज्ञापनों के लिए आरटीबी को चालू करने के लिए, AdLoader लागू किया गया.
वर्शन 2.8.20240827.0
- FiveAd SDK टूल के 2.8.20240827.0 वर्शन के साथ काम करने की पुष्टि की गई
इनके साथ बनाया और टेस्ट किया गया:
- Google Mobile Ads SDK टूल का 23.3.0 वर्शन.
- FiveAd SDK टूल का वर्शन 2.8.20240827.0
वर्शन 2.8.20240808.0
- FiveAd SDK टूल के 2.8.20240808.0 वर्शन के साथ काम करने की पुष्टि की गई
इनके साथ बनाया और टेस्ट किया गया:
- Google Mobile Ads SDK टूल का 23.2.0 वर्शन.
- FiveAd SDK टूल का वर्शन 2.8.20240808.0
वर्शन 2.8.20240722.0
- FiveAd SDK टूल के 2.8.20240722.0 वर्शन के साथ काम करने की पुष्टि की गई
इनके साथ बनाया और टेस्ट किया गया:
- Google Mobile Ads SDK टूल का 23.2.0 वर्शन.
- FiveAd SDK टूल का वर्शन 2.8.20240722.0
वर्शन 2.7.20240515.0
- FiveAd SDK टूल के 2.7.20240515.0 वर्शन के साथ काम करने की पुष्टि की गई
इनके साथ बनाया और टेस्ट किया गया:
- 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.0 वर्शन के साथ काम करने की पुष्टि की गई है.
इनके साथ बनाया और टेस्ट किया गया:
- Google Mobile Ads SDK टूल का 23.0.0 वर्शन.
- FiveAd SDK टूल का वर्शन 2.7.20240214.0.
वर्शन 2.7.20240214.0
- FiveAd SDK टूल के 2.7.20240214.0 वर्शन के साथ काम करने की पुष्टि की गई है.
इनके साथ बनाया और टेस्ट किया गया:
- Google Mobile Ads SDK टूल का 22.6.0 वर्शन.
- FiveAd SDK टूल का वर्शन 2.7.20240214.0.
वर्शन 2.7.20240126.0
- FiveAd SDK टूल के वर्शन 2.7.20240126.0 के साथ काम करने की पुष्टि की गई है.
इनके साथ बनाया और टेस्ट किया गया:
- 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.