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

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

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

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

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.3.0")
    implementation("com.google.ads.mediation:ironsource:8.2.1.0")
}

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

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

चौथा चरण: ironSource विज्ञापन 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 इस सेटिंग को हर विज्ञापन पर लागू नहीं कर सकता अपनी मीडिएशन चेन में नेटवर्क का इस्तेमाल करें. इसलिए, आपको हर विज्ञापन नेटवर्क की पहचान करनी होगी जो आपकी मध्यस्थता शृंखला में, निजी डेटा की बिक्री में हिस्सा ले सकते हों साथ ही, इन नेटवर्क से मिलने वाले दिशा-निर्देशों का पालन करें और यह पक्का करें कि अनुपालन.

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

Regulation Advanced के बारे में ironSource Ads के दस्तावेज़ देखें सेटिंग का इस्तेमाल करें.

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

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

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

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

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

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

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

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

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

गड़बड़ी कोड

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

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

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

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