Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

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

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

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

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

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

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

जारी रखने से पहले, इनकी पुष्टि करें:

Android का एपीआई लेवल 24 या इसके बाद का वर्शन.

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

GMA Next-Gen SDK का नया वर्शन.
मीडिएशन सेट अप करें.

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

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

एक नया ऐप्लिकेशन जोड़ें

कोई नया ऐप्लिकेशन जोड़ने के लिए, विज्ञापन > ऐप्लिकेशन पर जाएं. इसके बाद, ऐप्लिकेशन जोड़ें पर क्लिक करें.

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

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

कोई इंस्टेंस बनाना

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

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

बिडिंग

फ़ॉर्म भरें और कीमत के लिए बिडिंग को चुनें. सेव करें और बंद करें पर क्लिक करें.

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

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

वॉटरफ़ॉल

फ़ॉर्म भरें और सेव करें और बंद करें पर क्लिक करें.

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

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

अपनी रिपोर्टिंग एपीआई पासकोड ढूंढना

बिडिंग

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

वॉटरफ़ॉल

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

app-ads.txt फ़ाइल को अपडेट करना

ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो Ad Manager के लिए app-ads.txt फ़ाइल बनाएं.

ironSource के लिए app-ads.txt लागू करने के लिए, ironSource के आधिकारिक रीसेलर देखें.

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

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

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

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

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

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

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

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

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

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

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

यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर मोबाइल SDK मीडिएशन, प्लैटफ़ॉर्म के तौर पर 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/")
    }
  }
}

अपने ऐप्लिकेशन-लेवल की gradle फ़ाइल में, लागू करने से जुड़ी ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:ironsource:9.6.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

ग्रूवी

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:ironsource:9.6.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

ironSource SDK के वर्शन 7.7.0 से, ironSource अपने-आप जीडीपीआर के तहत ली गई सहमति को पढ़ता है. यह सहमति, सहमति मैनेजमेंट प्लैटफ़ॉर्म सेट करते हैं. ये प्लैटफ़ॉर्म, Google की अतिरिक्त सहमति से जुड़ी खास जानकारी के साथ काम करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, Google के यूएमपी और Google की अतिरिक्त सहमति के साथ काम करने वाले सीएमपी के लिए सहायता लेख पढ़ें.

अमेरिका के राज्यों के निजता कानून

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

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

Java

LevelPlay.setMetaData("do_not_sell", "true");IronSourceMediationSnippets.java

Kotlin

LevelPlay.setMetaData("do_not_sell", "true")IronSourceMediationSnippets.kt

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

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

गतिविधि के संदर्भ के साथ विज्ञापन लोड करना

बैनर, इंटरस्टीशियल, और इनाम वाले विज्ञापन फ़ॉर्मैट लोड करते समय, Activity कॉन्टेक्स्ट पास करें. गतिविधि के कॉन्टेक्स्ट के बिना, विज्ञापन लोड नहीं होगा.

Proguard के नियम

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

छठा चरण: लागू किए गए बदलावों की जांच करना

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

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

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

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

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

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

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 को शुरू नहीं किया गया है.
107	विज्ञापन पूरी तरह लोड होने से पहले ही, विज्ञापन दिखाने का अनुरोध किया गया था.
501-1056	ironSource Ads SDK टूल से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए, दस्तावेज़ देखें.