इस गाइड में, Google Mobile Ads SDK टूल का इस्तेमाल करके, मीडिएशन की मदद से Line से विज्ञापन लोड करने और दिखाने का तरीका बताया गया है. इसमें वॉटरफ़ॉल इंटिग्रेशन के बारे में भी बताया गया है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Line को जोड़ने का तरीका बताया गया है. साथ ही, Android ऐप्लिकेशन में Line SDK टूल और अडैप्टर को इंटिग्रेट करने का तरीका भी बताया गया है.
Line के डैशबोर्ड इंटरफ़ेस में, लेबल, बटन, और ब्यौरे के लिए जैपनीज़ टेक्स्ट का इस्तेमाल किया जाता है. इस गाइड में मौजूद स्क्रीनशॉट का अनुवाद नहीं किया गया है. हालांकि, इस गाइड के ब्यौरे और निर्देशों में, लेबल और बटन के अनुवाद के साथ ब्रैकेट में अंग्रेज़ी भाषा के बराबर के शब्द दिए गए हैं.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
Line के लिए मीडिएशन अडैप्टर में ये सुविधाएं हैं:
इंटिग्रेशन | |
---|---|
बिडिंग | |
झरना | 1 |
फ़ॉर्मैट | |
बैनर | |
मध्यवर्ती | |
इनाम दिया गया | |
मूल भाषा वाला |
1 वॉटरफ़ॉल इंटिग्रेशन, क्लोज़्ड बीटा वर्शन में है. ऐक्सेस का अनुरोध करने के लिए, अपने खाता मैनेजर से संपर्क करें.
ज़रूरी शर्तें
- Android एपीआई लेवल 21 या उसके बाद का वर्शन
Google Mobile Ads SDK का सबसे नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड
पहला चरण: Line के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
अपने Line खाते में लॉग इन करें.
नया ऐप्लिकेशन जोड़ना
広告枠管理 (विज्ञापन स्लॉट मैनेजमेंट) > मीडिया (मीडिया) पर क्लिक करें. इसके बाद, 新規作成 (नया बनाएं) पर क्लिक करें.
फ़ॉर्म भरें और 登録 (Register) पर क्लिक करें.
ऐप्लिकेशन आईडी को नोट करें.
विज्ञापन प्लेसमेंट बनाना
उस ऐप्लिकेशन के आईडी पर क्लिक करें जिसमें आपको विज्ञापन प्लेसमेंट जोड़ना है. इसके बाद, 詳細 (जानकारी) को चुनें.
スロット 追加 (Add Slot) पर क्लिक करें.
फ़ॉर्म भरें और इसके बाद, (登録) रजिस्टर करें पर क्लिक करें.
स्लॉट आईडी को नोट करें.
दूसरा चरण: Ad Manager के यूज़र इंटरफ़ेस में लाइन डिमांड सेट अप करना
अपने Ad Manager खाते में साइन इन करें.
कंपनियों में लाइन जोड़ना
बिडिंग
बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.
झरना
एडमिन > कंपनियां पर जाएं. इसके बाद, सभी कंपनियां टैब में नई कंपनी बटन पर क्लिक करें. विज्ञापन नेटवर्क चुनें.
विज्ञापन नेटवर्क के तौर पर लाइन चुनें, कोई यूनीक नाम डालें, और मीडिएशन चालू करें.
आपको उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं है. बदलाव करने के बाद, सेव करें पर क्लिक करें.
सुरक्षित सिग्नल शेयर करने की सुविधा चालू करना
बिडिंग
एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाते की सेटिंग टैब पर जाएं. इसके बाद, सुरक्षित सिग्नल शेयर करने की सुविधा की समीक्षा करें और उसे टॉगल करके चालू करें. सेव करें पर क्लिक करें.
झरना
वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.
लाइन बिडिंग को कॉन्फ़िगर करना
बिडिंग
डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, SDK बिडिंग टैब में जाकर, नया बिडर पर क्लिक करें.
बिडर के तौर पर लाइन चुनें.
बिडिंग में हिस्सा लेने वाले इस व्यक्ति या कंपनी की सिग्नल लाइब्रेरी को, अनुमति वाले सिग्नल की सूची में जोड़ें और बिडिंग में हिस्सा लेने वाले इस व्यक्ति या कंपनी के साथ सिग्नल शेयर करने की अनुमति दें को टॉगल करें. इसके बाद, जारी रखें पर क्लिक करें.
जारी रखें पर क्लिक करें.
हो गया पर क्लिक करें.
झरना
वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.
विज्ञापन यूनिट मैपिंग को कॉन्फ़िगर करना
बिडिंग
डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, SDK बिडिंग टैब में जाकर, लाइन के लिए कंपनी चुनें.
विज्ञापन यूनिट मैपिंग टैब पर जाएं और नई विज्ञापन यूनिट मैपिंग पर क्लिक करें.
कोई विज्ञापन यूनिट चुनें. कोई विज्ञापन यूनिट और फ़ॉर्मैट चुनें. साथ ही, इन्वेंट्री टाइप के तौर पर मोबाइल ऐप्लिकेशन और अपना मोबाइल ऐप्लिकेशन चुनें. इसके बाद, पिछले सेक्शन में मिले ऐप्लिकेशन आईडी और स्लॉट आईडी डालें. आखिर में, सेव करें पर क्लिक करें.
झरना
डिलीवरी > नतीजे के ग्रुप पर जाएं और नया नतीजा ग्रुप बटन पर क्लिक करें. अपना मोबाइल ऐप्लिकेशन चुनें.
नीचे की ओर स्क्रोल करें और नतीजों से जुड़े विज्ञापन दिखाने वाले पार्टनर जोड़ें पर क्लिक करें.
वह कंपनी चुनें जिसे आपने पिछले सेक्शन में, लाइन के लिए बनाया था. इंटिग्रेशन टाइप के तौर पर मोबाइल SDK टूल का मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर चालू है चुनें.
पिछले सेक्शन में मिले ऐप्लिकेशन आईडी और स्लॉट आईडी के साथ-साथ डिफ़ॉल्ट सीपीएम वैल्यू डालें. सेव करें पर क्लिक करें.
तीसरा चरण: 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 इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं होती.
पांचवां चरण: लागू किए गए टूल की जांच करना
टेस्ट विज्ञापन चालू करना
पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.
Line टेस्ट विज्ञापनों को चालू करने के तरीके के बारे में जानने के लिए, Line के दस्तावेज़ में दिए गए निर्देशों का पालन करें.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको Line से टेस्ट विज्ञापन मिल रहे हैं, Line (वॉटरफ़ॉल) विज्ञापन स्रोत का इस्तेमाल करके, Ad Inspector में विज्ञापन के किसी एक स्रोत की जांच की सुविधा चालू करें.
वैकल्पिक चरण
नेटवर्क के हिसाब से पैरामीटर
लाइन अडैप्टर, अनुरोध के लिए एक और पैरामीटर के साथ काम करता है. इसे LineExtras
क्लास का इस्तेमाल करके, अडैप्टर को पास किया जा सकता है. इस क्लास के कंस्ट्रक्टर में ये पैरामीटर शामिल होते हैं:
enableAdSound
- A
boolean
, बैनर, इंटरस्टीशियल, और इनाम वाले विज्ञापनों के लिए, साउंड के शुरू होने की डिफ़ॉल्ट स्थिति तय करने के लिए.
यहां इन पैरामीटर को सेट करने वाला विज्ञापन अनुरोध बनाने का कोड उदाहरण दिया गया है:
Java
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdManagerAdRequest.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.