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

ironSource विज्ञापनों को मीडिएशन के साथ इंटिग्रेट करना

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

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

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

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

¹ बिडिंग इंटिग्रेशन, क्लोज़्ड बीटा वर्शन में है. ऐक्सेस का अनुरोध करने के लिए, अपने खाता मैनेजर से संपर्क करें.

² यह फ़ॉर्मैट सिर्फ़ वॉटरफ़ॉल इंटिग्रेशन में काम करता है.

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

Android एपीआई लेवल 21 या उसके बाद का वर्शन
[बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, IronSource अडैप्टर 8.0.0.0 या इसके बाद के वर्शन का इस्तेमाल करें (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)

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

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

अपने ironSource Ads खाते में साइन अप करें और साइन इन करें.

ironSource Ads डैशबोर्ड में अपना ऐप्लिकेशन जोड़ने के लिए, नया ऐप्लिकेशन बटन पर क्लिक करें.

ऐप्लिकेशन की जानकारी डालना

लाइव ऐप्लिकेशन चुनें. इसके बाद, अपने ऐप्लिकेशन का Google Play यूआरएल डालें और ऐप्लिकेशन की जानकारी इंपोर्ट करें पर क्लिक करें.

अगर आपका ऐप्लिकेशन उपलब्ध नहीं है, तो ऐप्लिकेशन स्टोर में ऐप्लिकेशन लाइव नहीं है चुनें और अपने ऐप्लिकेशन के लिए कुछ समय के लिए इस्तेमाल किया जाने वाला नाम डालें. इसके बाद, अपना प्लैटफ़ॉर्म चुनें.

बाकी जानकारी भरें और ऐप्लिकेशन जोड़ें पर क्लिक करें.

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

इंस्टेंस बनाएं

इसके बाद, जोड़े गए ऐप्लिकेशन के लिए नेटवर्क इंस्टेंस कॉन्फ़िगर करें.

बिडिंग

LevelPlay > सेटअप > SDK नेटवर्क पर जाएं. इसके बाद, अपना ऐप्लिकेशन चुनें. बिडिंग में जाकर, बिडिंग इंस्टेंस आईडी देखने के लिए, बदलाव करें आइकॉन पर क्लिक करें.

इंस्टेंस आईडी को नोट करें.

झरना

विज्ञापन > सेटअप > इंस्टेंस पर जाएं. ऐप्लिकेशन चुनें और इंस्टेंस बनाएं पर क्लिक करें.

ज़रूरी जानकारी डालें और सेव करें और बंद करें पर क्लिक करें.

अहम जानकारी: अगर आपको इनाम वाले इंटरस्टीशियल विज्ञापन दिखाने हैं, तो इनाम वाला वीडियो फ़ॉर्मैट चुनें. साथ ही, दूसरे चरण में विज्ञापन स्रोत के तौर पर IronSource Ads जोड़ने के लिए, उस इंस्टेंस आईडी का इस्तेमाल करें. इसके अलावा, इनाम वाले इंटरस्टीशियल विज्ञापनों के लिए अपना इंस्टेंस आईडी सेट अप करने के लिए, आपको Mobile-is-support@ironsrc.com पर जाकर, ironSource Ads की सहायता टीम से संपर्क करना होगा.

इंस्टेंस बन जाने के बाद, इंस्टेंस आईडी फ़ील्ड में इंस्टेंस आईडी दिखता है.

अपना Reporting API पासकोड ढूंढना

बिडिंग

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

झरना

AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, आपके पास ऐप्लिकेशन पासकोड और इंस्टेंस आईडी के साथ-साथ, ironSource Ads का सीक्रेट पासकोड और रीफ़्रेश टोकन भी होना चाहिए.

अपने ironSource Ads पब्लिशर डैशबोर्ड में, मेरा खाता पर जाएं. इसके बाद, एपीआई टैब पर क्लिक करें. अपनी सीक्रेट कुंजी और रीफ़्रेश टोकन नोट करें.

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

ironSource Ads के टेस्ट विज्ञापनों को चालू करने के लिए, ironSource Ads की इंटिग्रेशन टेस्टिंग गाइड में दिए गए निर्देशों का पालन करें.

दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में, ironSource Ads की मांग सेट अप करना

अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में ironSource Ads जोड़ने होंगे.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपके पास कोई मौजूदा मीडिएशन ग्रुप है जिसमें आपको बदलाव करना है, तो उसमें बदलाव करने के लिए, मीडिएशन ग्रुप के नाम पर क्लिक करें. इसके बाद, ironSource Ads को विज्ञापन स्रोत के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म डालें. इसके बाद, जारी रखें पर क्लिक करें.

अपने मीडिएशन ग्रुप को कोई नाम दें और टारगेट करने के लिए जगहें चुनें. इसके बाद, मीडिएशन ग्रुप का स्टेटस चालू है पर सेट करें. इसके बाद, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

इस मीडिएशन ग्रुप को अपनी एक या उससे ज़्यादा मौजूदा AdMob विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट कार्ड दिखेगा, जिसमें आपने जो विज्ञापन यूनिट चुनी हैं वे दिखेंगी:

ironSource Ads को विज्ञापन स्रोत के तौर पर जोड़ना

बिडिंग

विज्ञापन स्रोत सेक्शन में, बिडिंग कार्ड में जाकर, विज्ञापन स्रोत जोड़ें को चुनें. इसके बाद, ironSource Ads चुनें .
पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें. इसके बाद, ironSource Ads के साथ बिडिंग पार्टनरशिप सेट अप करें.

स्वीकार करें और सहमत हों पर क्लिक करें. इसके बाद, जारी रखें पर क्लिक करें.

अगर आपके पास पहले से ही ironSource Ads के लिए मैपिंग है, तो आपके पास उसे चुनने का विकल्प है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिले ऐप्लिकेशन पासकोड और इंस्टेंस आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

झरना

विज्ञापन स्रोत सेक्शन में, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन स्रोत जोड़ें को चुनें. इसके बाद, ironSource Ads चुनें.

ironSource Ads चुनें और ऑप्टिमाइज़ करें स्विच को चालू करें. ironSource Ads के लिए विज्ञापन स्रोत का ऑप्टिमाइज़ेशन सेट अप करने के लिए, पिछले सेक्शन में मिला सीक्रेट पासकोड और रीफ़्रेश टोकन डालें. इसके बाद, ironSource Ads के लिए eCPM वैल्यू डालें और जारी रखें पर क्लिक करें.

अगर आपके पास पहले से ही ironSource Ads के लिए मैपिंग है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

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

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

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

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

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

प्रोजेक्ट-लेवल की settings.gradle.kts फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://android-sdk.is.com/")
    }
  }
}

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:ironsource:8.5.0.0")
}

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

ironSource Ads Android SDK टूल का नया वर्शन डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.
Google के मेवन रिपॉज़िटरी पर, ironSource Ads अडैप्टर आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें, IronSource अडैप्टर की .aar फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.

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

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

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

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

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setConsent(true);

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setConsent(true)

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

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

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

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

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setMetaData("do_not_sell", "true");

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setMetaData("do_not_sell", "true")

ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, ironSource Ads का कानूनी समझौते की बेहतर सेटिंग वाला दस्तावेज़ देखें.

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

ऐप्लिकेशन का लाइफ़साइकल

अपनी हर गतिविधि में onPause() और onResume() तरीकों को बदलें, ताकि आप उनसे जुड़े ironSource Ads तरीकों को इस तरह से कॉल कर सकें:

Java

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

Kotlin

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

ProGuard के नियम

अगर आपने अपने ऐप्लिकेशन को छोटा, उलझाने वाला, और ऑप्टिमाइज़ किया है, तो ironSource Ads को आपके प्रोजेक्ट के लिए ProGuard के अन्य नियमों की ज़रूरत होगी. ज़्यादा जानकारी के लिए, ironSource Ads के Android SDK इंटिग्रेशन की गाइड देखें.

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

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

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, ironSource Ads के यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो.

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

यह पुष्टि करने के लिए कि आपको ironSource Ads से टेस्ट विज्ञापन मिल रहे हैं या नहीं, विज्ञापन जांचने वाले टूल में ironSource Ads (बिडिंग) और ironSource Ads (वॉटरफ़ॉल) विज्ञापन स्रोत का इस्तेमाल करके, विज्ञापन के किसी एक स्रोत की जांच करने की सुविधा चालू करें.

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

अगर अडैप्टर को ironSource Ads से कोई विज्ञापन नहीं मिलता है, तो इन क्लास में ResponseInfo.getAdapterResponses() का इस्तेमाल करके, विज्ञापन के जवाब से जुड़ी गड़बड़ी देखी जा सकती है:

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

जब कोई विज्ञापन लोड नहीं होता, तो ironSource Ads एडेप्टर से मिलने वाले कोड और मैसेज यहां दिए गए हैं:

गड़बड़ी का कोड	कारण
101	AdMob यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए, ironSource Ads सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102	ironSource Ads को SDK टूल को शुरू करने के लिए, गतिविधि के संदर्भ की ज़रूरत होती है.
103	ironSource Ads, हर ironSource Ads इंस्टेंस आईडी के लिए सिर्फ़ एक विज्ञापन लोड कर सकता है.
105	अनुरोध किए गए बैनर विज्ञापन का साइज़, ironSource Ads के साथ काम नहीं करता.
106	ironSource Ads SDK टूल को शुरू नहीं किया गया है.
501-1056	ironSource Ads SDK टूल से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए, दस्तावेज़ देखें.

IronSource के Android मीडिएशन अडैप्टर में हुए बदलावों का लॉग