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 की सहायता टीम से संपर्क करना होगा, ताकि इनाम वाले इंटरस्टीशियल विज्ञापन दिखाने की सुविधा के लिए अपना इंस्टेंस सेट अप किया जा सके.

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

वॉटरफ़ॉल

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

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

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

बिडिंग

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

वॉटरफ़ॉल

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

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 के लिए पहले से कोई Yield partner चुना हुआ है, तो उसे चुना जा सकता है. इसके अलावा, नया यील्ड पार्टनर बनाएं को चुनें.

विज्ञापन नेटवर्क कंपनी के तौर पर 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.4.0")
    implementation("com.google.ads.mediation:ironsource:9.6.0.1")
}

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.4.0'
    implementation 'com.google.ads.mediation:ironsource:9.6.0.1'
}

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 adapter artifacts पर जाएं. सबसे नया वर्शन चुनें, IronSource अडैप्टर की .aar फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.

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

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

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

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

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

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

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

Java

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

Kotlin

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

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

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

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

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

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

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

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

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

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