हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google विज्ञापन और मेज़रमेंट कम्यूनिटी सर्वर में Ad Manager के आधिकारिक Discord चैनल से जुड़ें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

नया ऐप्लिकेशन जोड़ने के लिए, विज्ञापन > ऐप्लिकेशन पर जाएं और ऐप्लिकेशन जोड़ें पर क्लिक करें.

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

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

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

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

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

बिडिंग

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

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

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

झरना

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

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

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

बिडिंग

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

झरना

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

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

Authorized Sellers for Apps 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/")
    }
  }
}

इसके बाद, अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, ये लागू करने से जुड़ी डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. ironSource Ads SDK और अडैप्टर के नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:ironsource:8.11.0.0")
}

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

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

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

ईयू में रहने वाले उपयोगकर्ताओं की सहमति और जीडीपीआर

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

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

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

अमेरिका के राज्यों में निजता से जुड़े कानूनों के मुताबिक, उपयोगकर्ताओं को उनकी "निजी जानकारी" (जैसा कि कानूनी तौर पर उन शब्दों को परिभाषित किया गया है) की "बिक्री" से ऑप्ट आउट करने का अधिकार देना ज़रूरी है. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर, "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से देना होगा. अमेरिका के राज्यों में निजता कानूनों का पालन करने से जुड़ी गाइड में, 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 के Regulation Advanced Settings दस्तावेज़ देखें.

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

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

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

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

अपनी हर गतिविधि में 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 इंटिग्रेशन की गाइड देखें.

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

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

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

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

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

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

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

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