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

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

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

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

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

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

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

Android API का लेवल 19 या उसके बाद वाला वर्शन

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

APP KEY और इंस्टेंस आईडी के अलावा, आपको अपना Ad Manager विज्ञापन यूनिट आईडी सेट अप करने के लिए ironSource Secret Key और Refresh Token की भी ज़रूरत होगी.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

SDK टूल के वर्शन 6.7.9 में, ironSource के वर्शन में सहमति वाला एपीआई जोड़ा गया है. यहां दिया गया सैंपल कोड दिखाता है कि इस सहमति की जानकारी को ironSource 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 का दस्तावेज़ देखें.

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

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

SDK टूल के वर्शन 6.14.0 में, ironSource ने सीसीपीए के नियमों के मुताबिक काम करने के लिए एक एपीआई जोड़ा है. नीचे दिए गए सैंपल कोड में, इस सहमति की जानकारी कोironSource SDK टूल में भेजने का तरीका बताया गया है. Google Mobile Ads SDK टूल को शुरू करने से पहले, इन विकल्पों को सेट करना ज़रूरी है. इससे यह पक्का किया जा सकेगा कि उन्हें ironSource 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")

ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, Regulation Advanced Settings पर ironSource का दस्तावेज़ देखें.

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

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

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

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)
}

प्रोगार्ड के नियम

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

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

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

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

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

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

गड़बड़ी कोड

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

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

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

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