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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अगर आपके पास IronSource के लिए पहले से कोई यील्ड पार्टनर है, तो उसे चुनें. अगर ऐसा नहीं है, तो नया ईल्ड पार्टनर बनाएं चुनें.

विज्ञापन नेटवर्क के तौर पर IronSource चुनें और यूनीक नाम डालें. साथ ही, मीडिएशन की सुविधा चालू करें.

अपने-आप डेटा इकट्ठा होने की सुविधा को चालू करें और पिछले सेक्शन में मौजूद Secret Key and Refresh Token को डालें.

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

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

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

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

तीसरा चरण: 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.2.0")
    implementation("com.google.ads.mediation:ironsource:8.1.0.0")
}

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

ironSource Ads के Android SDK टूल का सबसे नया वर्शन डाउनलोड करें और इसे अपने प्रोजेक्ट में जोड़ें.
Google की Maven रिपॉज़िटरी में, 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)

ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के बारे में जानने के लिए, Regulation Advanced Settings पर 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 इंटिग्रेशन गाइड देखें.

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

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

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

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

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

गड़बड़ी कोड

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

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

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

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