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

आयरन के सोर्स को मीडिएशन के साथ इंटिग्रेट करना

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

डिलीवरी > Yiel ग्रुप पर जाएं और नया Yiel ग्रुप बटन पर क्लिक करें.

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

इसके बाद, नतीजों के लिए पार्टनर जोड़ें बटन पर क्लिक करें.

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

विज्ञापन नेटवर्क के तौर पर ironSource Ads चुनें. इसके बाद, कोई यूनीक नाम डालें और मीडिएशन चालू करें.

डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. इसके बाद, पिछले सेक्शन में मिली सीक्रेट कुंजी और रीफ़्रेश टोकन डालें.

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

इसके बाद, पेज पर सबसे नीचे सेव करें पर क्लिक करें.

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

Ad Manager के यूज़र इंटरफ़ेस (यूआई) में, जीडीपीआर और अमेरिका के कानूनों के पालन के लिए, विज्ञापन पार्टनर की सूची में 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 Ads SDK टूल और अडैप्टर के सबसे नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:ironsource:8.4.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 इंटिग्रेशन की गाइड देखें.

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

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

पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, 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	Ad Manager यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए ironSource Ads सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102	ironSource Ads को SDK टूल को शुरू करने के लिए, गतिविधि के संदर्भ की ज़रूरत होती है.
103	ironSource Ads, हर ironSource Ads इंस्टेंस आईडी के लिए सिर्फ़ एक विज्ञापन लोड कर सकता है.
105	अनुरोध किए गए बैनर विज्ञापन का साइज़, ironSource Ads के साथ काम नहीं करता.
106	ironSource Ads SDK टूल को शुरू नहीं किया गया है.
501-1056	ironSource Ads SDK टूल से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए, दस्तावेज़ देखें.