इस पेज का अनुवाद Cloud Translation API से किया गया है.

मीडिएशन के साथ लिफ़्टऑफ़ से कमाई करने की सुविधा को इंटिग्रेट करें

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

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

Liftoff Monetize के लिए मीडिएशन अडैप्टर में ये काम किए जा सकते हैं:

इंटिग्रेशन
बिडिंग	¹
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप का खुलना
बैनर
मध्यवर्ती
इनाम दिया गया
इनाम वाले इंटरस्टीशियल विज्ञापन	³
मूल भाषा वाला	²

¹ बिडिंग इंटिग्रेशन ओपन बीटा वर्शन में है.

² इस फ़ॉर्मैट के लिए बिडिंग इंटिग्रेशन की सुविधा, क्लोज़्ड बीटा वर्शन में है.

³ इनाम वाले इंटरस्टीशियल विज्ञापन को सेट अप करने में मदद चाहिए. Liftoff Monetize या monetize@liftoff.io पर, अपने खाता मैनेजर से संपर्क करें.

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

Android का एपीआई लेवल 21 या उसके बाद का वर्शन

Google Mobile Ads SDK का नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश

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

अपने LiftoffMonetize खाते में साइन अप करें या लॉग इन करें.

ऐप्लिकेशन जोड़ें बटन पर क्लिक करके, अपने ऐप्लिकेशन को Liftoff Monetize डैशबोर्ड में जोड़ें.

सभी ज़रूरी जानकारी डालकर फ़ॉर्म भरें.

अपना ऐप्लिकेशन बन जाने के बाद, Liftoff Monetize ऐप्लिकेशन डैशबोर्ड से अपना ऐप्लिकेशन चुनें.

ऐप्लिकेशन आईडी को ध्यान में रखें.

नए प्लेसमेंट जोड़ें

मीडिएशन के साथ इस्तेमाल करने के लिए Ad Manager नया प्लेसमेंट बनाने के लिए, Liftoff Monetize प्लेसमेंट डैशबोर्ड पर जाएं. इसके बाद, प्लेसमेंट जोड़ें बटन पर क्लिक करें और ड्रॉप-डाउन सूची से अपना ऐप्लिकेशन चुनें.

नए प्लेसमेंट जोड़ने के विवरण नीचे दिए गए हैं:

बैनर

बैनर चुनें और प्लेसमेंट का नाम डालें और फ़ॉर्म का बाकी हिस्सा भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

300x250 बैनर

MREC चुनें, प्लेसमेंट का नाम डालें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

मध्यवर्ती

अचानक दिखने वाला (इंटरस्टीशियल) विज्ञापन चुनें, प्लेसमेंट का नाम डालें और फ़ॉर्म का बाकी हिस्सा भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे जारी रखें बटन पर क्लिक करें.

इनाम दिया गया

इनाम वाले विज्ञापन चुनें और प्लेसमेंट का नाम डालें और फ़ॉर्म का बाकी हिस्सा भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

इनाम वाले इंटरस्टीशियल विज्ञापन

इनाम वाले विज्ञापन चुनें. प्लेसमेंट का नाम डालें, स्किप किया जा सकने वाला चालू करें और बाकी फ़ॉर्म भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग की सुविधा को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए, पेज पर सबसे नीचे जारी रखें बटन पर क्लिक करें.

नेटिव लेआउट

नेटिव चुनें और प्लेसमेंट का नाम डालें और फ़ॉर्म का बाकी हिस्सा भरें. [सिर्फ़ बिडिंग] कमाई करना में जाकर, इन-ऐप्लिकेशन बिडिंग स्विच को चालू है पर टॉगल करें. प्लेसमेंट बनाने के लिए पेज के सबसे नीचे मौजूद जारी रखें बटन पर क्लिक करें.

रेफ़रंस आईडी नोट करें और अच्छा लग रहा है पर क्लिक करें.

बैनर

300x250 बैनर

मध्यवर्ती

इनाम दिया गया

इनाम वाले इंटरस्टीशियल विज्ञापन

नेटिव लेआउट

अपनी Reporting API Key का पता लगाना

बिडिंग

बिडिंग इंटिग्रेशन के लिए यह चरण ज़रूरी नहीं है.

वॉटरफ़ॉल

ऐप्लिकेशन आईडी और रेफ़रंस आईडी के अलावा, आपको अपनी Ad Manager विज्ञापन यूनिट का आईडी सेट अप करने के लिए, Liftoff Monetize Reporting API की भी ज़रूरत होगी. Liftoff Monetize Report डैशबोर्ड पर जाएं और Reporting API Key को देखने के लिए, Reporting API कुंजी पर क्लिक करें.

टेस्ट मोड चालू करें

टेस्ट विज्ञापनों को चालू करने के लिए, अपने Liftoff Monetize डैशबोर्ड पर जाएं और Applications पर जाएं.

अपना ऐप्लिकेशन चुनें जिसके लिए आप अपने ऐप्लिकेशन के प्लेसमेंट रेफ़रंस आईडी सेक्शन में जाकर, टेस्ट विज्ञापन चालू करना चाहते हैं. टेस्ट विज्ञापनों को चालू करने के लिए, स्टेटस सेक्शन में सिर्फ़ टेस्ट विज्ञापन दिखाएं में टेस्ट मोड चुनें.

दूसरा चरण: यूज़र इंटरफ़ेस (यूआई) में लिफ़्टऑफ़ 'कमाई करें' सुविधा की मांग Ad Manager सेट अप करना

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

कंपनियों में Liftoff Monetize जोड़ें

बिडिंग

बिडिंग इंटिग्रेशन के लिए यह चरण ज़रूरी नहीं है.

झरना

एडमिन > कंपनी पर जाएं. इसके बाद, सभी कंपनियां टैब में नई कंपनी बटन पर क्लिक करें. विज्ञापन नेटवर्क कंपनी चुनें.

विज्ञापन नेटवर्क के तौर पर Liftoff Monetize चुनें. कोई यूनीक नाम डालें और मीडिएशन की सुविधा चालू करें. डेटा अपने-आप इकट्ठा होने की सुविधा को चालू करें और पिछले सेक्शन में मौजूद Reporting API Key डालें.

आपको उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं है. पूरा होने के बाद, सेव करें पर क्लिक करें.

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

बिडिंग

एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाता सेटिंग टैब पर जाएं और सुरक्षित सिग्नल शेयरिंग की समीक्षा करें और उसे चालू करें. Save पर क्लिक करें.

झरना

वॉटरफ़ॉल इंटिग्रेशन के लिए यह चरण ज़रूरी नहीं है.

बिडिंग कॉन्फ़िगर करें Liftoff Monetize

बिडिंग

डिलीवरी > बिड करने वाले पर जाएं और SDK बिडिंग टैब में जाकर, नया बिडर पर क्लिक करें.

बिड करने वाले के तौर पर Liftoff Monetize को चुनें.

बिड करने वाले इस व्यक्ति की सिग्नल लाइब्रेरी को, अनुमति वाले सिग्नल की सूची में जोड़ें और इस बिडर के साथ सिग्नल शेयर करने की अनुमति दें पर टॉगल करें. इसके बाद, जारी रखें पर क्लिक करें.

जारी रखें पर क्लिक करें.

हो गया पर क्लिक करें.

झरना

वॉटरफ़ॉल इंटिग्रेशन के लिए यह चरण ज़रूरी नहीं है.

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

बिडिंग

डिलीवरी > बिड करने वाले पर जाएं और SDK बिडिंग टैब में,Liftoff Monetize के लिए कंपनी चुनें.

विज्ञापन यूनिट की मैपिंग टैब पर जाएं और विज्ञापन यूनिट की नई मैपिंग पर क्लिक करें.

खास विज्ञापन यूनिट चुनें. इन्वेंट्री टाइप के तौर पर मोबाइल ऐप्लिकेशन और विज्ञापन यूनिट का फ़ॉर्मैट चुनें और मोबाइल ऐप्लिकेशन चुनें. इसके बाद, पिछले सेक्शन में मौजूद Application ID and Placement Reference ID पोस्ट डालें. आखिर में, सेव करें पर क्लिक करें.

के तौर पर जुड़ा होना चाहिए.

झरना

डिलीवरी > यील्ड ग्रुप पर जाएं और नया यील्ड ग्रुप बटन पर क्लिक करें. अपना मोबाइल ऐप्लिकेशन चुनें.

नीचे की ओर स्क्रोल करें और ईल्ड पार्टनर जोड़ें पर क्लिक करें.

पिछले सेक्शन में, उस कंपनी को चुनें जिसे आपने Liftoff Monetize के लिए बनाया था. मोबाइल SDK टूल मीडिएशन को इंटिग्रेशन टाइप के तौर पर, Android को प्लैटफ़ॉर्म के तौर पर, और स्टेटस के तौर पर ऐक्टिव चुनें.

पिछले सेक्शन में दिया गया Application ID and Placement Reference IDऔर डिफ़ॉल्ट सीपीएम वैल्यू डालें. सेव करें पर क्लिक करें.

में बताया गया है.

ध्यान दें: किसी मीडिएशन नेटवर्क के लिए, डाइनैमिक सीपीएम वैल्यू का सटीक हिसाब लगाने से पहले, अपने-आप डेटा इकट्ठा होने में कुछ दिन लगते हैं. eCPM का हिसाब लगाने के बाद, यह आपकी तरफ़ से अपने-आप अपडेट हो जाता है.

जीडीपीआर और अमेरिका के कानूनों के तहत आने वाले विज्ञापन पार्टनर की सूची में Liftoff जोड़ें

जीडीपीआर सेटिंग और अमेरिका के कानूनों के बारे में सेटिंग में दिया गया तरीका अपनाएं, ताकि Liftoff को जीडीपीआर और अमेरिका के कानूनों के बारे में बताने वाली विज्ञापन पार्टनर सूची में Ad Manager यूज़र इंटरफ़ेस (यूआई) जोड़ा जा सके.

तीसरा चरण: Vungle SDK टूल और अडैप्टर इंपोर्ट करना

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

अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, लागू करने की इन निर्भरता और कॉन्फ़िगरेशन जोड़ें. Vungle SDK टूल और अडैप्टर के नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:vungle:7.3.2.0")
}

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

नया Vungle Android SDK डाउनलोड करें और libs फ़ोल्डर में मौजूद .jar फ़ाइलें एक्सट्रैक्ट करें और अपने प्रोजेक्ट में जोड़ें.
Google की Maven रिपॉज़िटरी पर Liftoff Monetize अडैप्टर आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें, Vungle अडैप्टर की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

चौथा चरण: Liftoff Monetize SDK टूल पर, निजता सेटिंग लागू करें

ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर

Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति के तहत, आपको यह पक्का करना होगा कि डिवाइस आइडेंटिफ़ायर और निजी डेटा के इस्तेमाल के बारे में, यूरोपियन इकनॉमिक एरिया (ईईए) के उपयोगकर्ताओं को कुछ जानकारी दी गई है और उनसे सहमति ली गई है. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. सहमति लेते समय, आपको अपनी मीडिएशन चेन में हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी डेटा को इकट्ठा, हासिल या इस्तेमाल कर सकता है. साथ ही, आपको हर नेटवर्क के इस्तेमाल के बारे में जानकारी देनी होगी. फ़िलहाल, Google ऐसे नेटवर्क के लिए उपयोगकर्ता की सहमति के विकल्प को अपने-आप पास नहीं कर सकता.

Liftoff Monetize में एक ऐसा एपीआई शामिल है जो आपको Vungle SDK टूल को सहमति देने की सुविधा देता है. नीचे दिया गया सैंपल कोड, सहमति की इस जानकारी को Vungle SDK में भेजने का तरीका बताता है. अगर आपको इस तरीके को कॉल करना है, तो हमारा सुझाव है कि Google Mobile Ads SDK से विज्ञापनों का अनुरोध करने से पहले ऐसा कर लें.

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

ज़्यादा जानकारी और इस तरीके में दी गई वैल्यू के लिए, जीडीपीआर के लागू होने के सुझाव देखें.

अमेरिका के निजता कानून

अमेरिका के राज्यों के निजता कानून लोगों को यह अधिकार देना ज़रूरी है कि वे अपनी "निजी जानकारी" (जैसा कि कानून में बताया गया है) को "बिक्री" से ऑप्ट आउट करने का विकल्प दें. साथ ही, "बिक्री" करने वाली पार्टी के होम पेज पर मौजूद, "मेरी निजी जानकारी न बेचें" लिंक से ऑप्ट-आउट करें. अमेरिका के निजता कानूनों के पालन से जुड़ी गाइड, Google विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग को चालू करने की सुविधा देती है. हालांकि, Google आपकी मीडिएशन चेन के हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको अपनी मीडिएशन चेन में हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकता है. साथ ही, यह पक्का करने के लिए कि उस नेटवर्क से मिले निर्देशों का पालन किया गया हो.

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

ज़्यादा जानकारी और तरीके में दी गई वैल्यू के लिए, सीसीपीए को लागू करना देखें.

पांचवां चरण: ज़रूरी कोड जोड़ना

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

छठा चरण: लागू होने की जांच करना

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

पक्का करें कि आपनेके लिए अपना टेस्ट डिवाइस रजिस्टर किया हो और Liftoff Monetize यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो. Ad Manager

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

यह पुष्टि करने के लिए कि Liftoff Monetizeसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.

वैकल्पिक चरण

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

Liftoff Monetize अडैप्टर, इन अतिरिक्त अनुरोध पैरामीटर के साथ काम करता है जिन्हें अडैप्टर को भेजा जा सकता है:

userId: Liftoff Monetize के इन्सेंटिव यूज़र आईडी को दिखाने वाली स्ट्रिंग.
adOrientation: फ़ुल-स्क्रीन वाले विज्ञापनों के लिए प्रज़ेंटेशन ओरिएंटेशन बताने वाला पूर्णांक.

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

Java

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

Kotlin

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

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

Liftoff Monetize अडैप्टर अपने नेटिव विज्ञापनों को NativeAd ऑब्जेक्ट के तौर पर दिखाता है. यह NativeAd के लिए, यहां दिए गए फ़ील्ड को इकट्ठा करता है.

फ़ील्ड	ऐसेट को हमेशा Liftoff Monetize अडैप्टर के ज़रिए शामिल किया जाता है
हेडलाइन
Image	1
मीडिया व्यू
मुख्य हिस्सा
ऐप्लिकेशन आइकॉन
कॉल-टू-ऐक्शन
स्टार रेटिंग
स्टोर
कीमत

¹ Liftoff Monetize अडैप्टर, अपने नेटिव विज्ञापनों के लिए, मुख्य इमेज ऐसेट का सीधे तौर पर ऐक्सेस नहीं देता है. इसके बजाय, अडैप्टर MediaView को वीडियो या इमेज से भर देता है.

गड़बड़ी कोड

अगर अडैप्टर को Liftoff Monetize से विज्ञापन नहीं मिल रहा है, तो वे ResponseInfo.getAdapterResponses() का इस्तेमाल करके, विज्ञापन रिस्पॉन्स में हुई गड़बड़ी की जांच कर सकते हैं. यह गड़बड़ी इन कैटगरी में आती है:

फ़ॉर्मैट	कक्षा का नाम
बैनर	com.vungle.mediation.VungleInterstitialAdapter
मध्यवर्ती	com.vungle.mediation.VungleInterstitialAdapter
इनाम दिया गया	com.vungle.mediation.VungleAdapter

यहां पर एक विज्ञापन के लोड न होने पर, Liftoff Monetize अडैप्टर के ज़रिए गड़बड़ी के साथ-साथ दिखने वाले मैसेज और कोड दिए गए हैं:

गड़बड़ी का कोड	डोमेन	वजह
0-100	com.vungle.warren	Vungle SDK टूल में कोई गड़बड़ी मिली. ज़्यादा जानकारी के लिए, दस्तावेज़ देखें.
101	com.google.ads.mediation.vungle	अमान्य सर्वर पैरामीटर (जैसे कि ऐप्लिकेशन आईडी या प्लेसमेंट आईडी).
102	com.google.ads.mediation.vungle	बैनर का अनुरोध किया गया साइज़, Liftoff Monetize विज्ञापन के मान्य साइज़ से मैप नहीं करता है.
103	com.google.ads.mediation.vungle	Liftoff Monetize के लिए, विज्ञापन का अनुरोध करने के लिए `Activity` कॉन्टेक्स्ट की ज़रूरत है.
104	com.google.ads.mediation.vungle	Vungle SDK, एक ही प्लेसमेंट आईडी के लिए कई विज्ञापन लोड नहीं कर सकता.
105	com.google.ads.mediation.vungle	Vungle SDK टूल शुरू नहीं हो सका.
106	com.google.ads.mediation.vungle	Vungle SDK ने सही तरीके से लोड होने वाला कॉलबैक लौटाया है, लेकिन Banners.getBanner() या Vungle.getNativeAd() से कोई वैल्यू नहीं मिली.
107	com.google.ads.mediation.vungle	Vungle SDK टूल, विज्ञापन चलाने के लिए तैयार नहीं है.
1-100	Vungle SDK टूल की ओर से भेजा गया	Vungle SDK टूल में कोई गड़बड़ी मिली. ज़्यादा जानकारी के लिए कोड देखें.
101	com.google.mediation.vungle	Ad Manager यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए Liftoff Monetize सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102	com.google.mediation.vungle	इस नेटवर्क कॉन्फ़िगरेशन के लिए एक विज्ञापन पहले ही लोड किया जा चुका है. Vungle SDK, एक ही प्लेसमेंट आईडी के लिए दूसरा विज्ञापन लोड नहीं कर सकता.
103	com.google.mediation.vungle	विज्ञापन का अनुरोध किया गया साइज़, Liftoff Monetize के साथ काम करने वाले बैनर साइज़ से मैच नहीं करता है.
104	com.google.mediation.vungle	Vungle SDK, बैनर विज्ञापन को रेंडर नहीं कर सका.
105	com.google.mediation.vungle	Vungle SDK एक बार में सिर्फ़ एक बैनर विज्ञापन लोड करने की सुविधा देता है, चाहे प्लेसमेंट आईडी कुछ भी हो.
106	com.google.mediation.vungle	Vungle SDK ने एक कॉलबैक भेजा है, जिसमें बताया गया है कि विज्ञापन चलाने लायक नहीं है.

Liftoff Monetize Android मीडिएशन अडैप्टर चेंजलॉग