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

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

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

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

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

¹ बिडिंग इंटिग्रेशन, ओपन बीटा वर्शन में है.

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

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

• Google Mobile Ads SDK का सबसे नया वर्शन
• Flutter 3.7.0 या इसके बाद का वर्शन
• Android पर डिप्लॉय करने के लिए
  • Android एपीआई लेवल 21 या उसके बाद का वर्शन
• iOS पर डिप्लॉय करने के लिए
  • iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
• Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया, काम करने वाला Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
• मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

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

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

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

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

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

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

AndroidiOS

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

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

बिडिंगझरना

LevelPlay > सेटअप > इंस्टेंस पर जाएं. इसके बाद, अपना ऐप्लिकेशन चुनें. बिडिंग में जाकर, ironSource पर क्लिक करें.

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

AndroidiOS

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

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

ध्यान दें: ironSource Ads, इंस्टेंस बनाने की संख्या को सीमित करता है. अगर आपको गड़बड़ी का कोई मैसेज मिलता है, जिसमें बताया गया हो कि आपके पास ज़्यादा इंस्टेंस बनाने का विकल्प नहीं है, तो मदद पाने के लिए ironSource Ads की सहायता टीम से संपर्क करें.

अहम जानकारी: अगर आपको इन्टरस्टीशियल रीवार्ड वाले विज्ञापन दिखाने हैं, तो इंटरस्टीशियल रीवार्ड वाले वीडियो फ़ॉर्मैट चुनें. साथ ही, दूसरे चरण में विज्ञापन स्रोत के तौर पर ironSource Ads को जोड़ते समय, उस इंस्टेंस आईडी का इस्तेमाल करें. इसके अलावा, आपको इनाम वाले इंटरस्टीशियल के लिए अपने इंस्टेंस को सेट अप करने के लिए, [e-mail] पर जाकर ironSource Ads की सहायता टीम से संपर्क करना होगा.

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

अपना Reporting API पासकोड ढूंढना

बिडिंगझरना

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

ध्यान दें: सिर्फ़ ऐसे उपयोगकर्ता ही एपीआई पासकोड ऐक्सेस कर सकते हैं जिनके पास योगदान देने वाले या एडमिन के तौर पर अनुमतियां हों.

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

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

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

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

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

AndroidiOS

निर्देशों के लिए, Android के लिए बनी गाइड में दूसरा चरण देखें.

निर्देशों के लिए, iOS के लिए बनी गाइड में दूसरा चरण देखें.

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

अहम जानकारी: पुष्टि करें कि आपके पास खाता मैनेजमेंट की अनुमति है, ताकि ईयू की सहमति और जीडीपीआर, सीपीआरए, और उपयोगकर्ता मैसेजिंग प्लैटफ़ॉर्म के लिए कॉन्फ़िगरेशन पूरा किया जा सके. ज़्यादा जानकारी के लिए, अपने खाते में उपयोगकर्ता के ऐक्सेस को मैनेज करना लेख पढ़ें.

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

तीसरा चरण: ironSource Ads SDK टूल और अडैप्टर इंपोर्ट करना

ध्यान दें: काम करने वाले ironSource Ads और Google Mobile Ads SDK टूल के वर्शन को इंटिग्रेट न करने पर, बिल्ड से जुड़ी समस्याएं आ सकती हैं.

pub.dev की मदद से इंटिग्रेशन करना

(सिर्फ़ Android के लिए) अपने प्रोजेक्ट की android डायरेक्ट्री में मौजूद build.gradle फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

अपने पैकेज की pubspec.yaml फ़ाइल में, ironSource Ads SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_ironsource: ^1.1.0

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

ironSource Ads के लिए, Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को निकालें और निकाले गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लग इन का रेफ़रंस दें. इसके लिए, यहां दी गई डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

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

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

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

ironSource Ads के लिए Google Mobile Ads मीडिएशन प्लग इन में, GmaMediationIronsource().SetConsent() तरीका शामिल है. यहां दिए गए सैंपल कोड में, ironSource Ads SDK को सहमति की जानकारी पास करने का तरीका बताया गया है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK की मदद से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setConsent(true);

ज़्यादा जानकारी के लिए, कानूनी समझौते की बेहतर सेटिंग पर ironSource Ads का दस्तावेज़ देखें.

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

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

ironSource Ads के लिए Google Mobile Ads मीडिएशन प्लग इन में, GmaMediationIronsource().setDoNotSell तरीका शामिल है. यहां दिए गए सैंपल कोड में, ironSource Ads SDK को सहमति की जानकारी पास करने का तरीका बताया गया है. Google Mobile Ads SDK टूल को शुरू करने से पहले, ये विकल्प सेट करने ज़रूरी हैं. इससे यह पक्का किया जा सकेगा कि ये विकल्प, ironSource Ads SDK टूल को सही तरीके से फ़ॉरवर्ड किए जाएं.

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(true);

ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, Android और iOS, दोनों के लिए, रेगुलेशन की बेहतर सेटिंग के बारे में ironSource Ads का दस्तावेज़ देखें.

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

AndroidiOS

ProGuard के नियम

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

अपने प्रोजेक्ट के लिए ProGuard के कौनसे नियम ज़रूरी हैं, इस बारे में ज़्यादा जानकारी के लिए, IronSource Ads की Android SDK इंटिग्रेशन गाइड देखें. साथ ही, उन नियमों को अपनी proguard-user.txt फ़ाइल में जोड़ें.

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

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

JavaKotlin

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, ironSource Ads के दस्तावेज़ में दिया गया तरीका अपनाएं.

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

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

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

अहम जानकारी: ऐप्लिकेशन को रिलीज़ करने से पहले, AdMob और ironSource Ads के लिए टेस्ट मोड बंद करें.

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

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

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

अगर अडैप्टर को ironSource Ads से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास में ResponseInfo का इस्तेमाल करके, विज्ञापन के जवाब से जुड़ी गड़बड़ी की जांच कर सकते हैं:

AndroidiOS

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

जब कोई विज्ञापन लोड नहीं होता, तो ironSource Ads ऐडैप्टर से मिलने वाले कोड और मैसेज यहां दिए गए हैं:

AndroidiOS

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

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

ironSource Flutter मीडिएशन अडैप्टर में हुए बदलावों का लॉग

1.1.0

• iOS प्लगिन अब एक स्टैटिक फ़्रेमवर्क है.

• ironSource Android अडैप्टर के 8.6.1.0 वर्शन के साथ काम करता है.
• ironSource iOS अडैप्टर के 8.6.0.0.0 वर्शन के साथ काम करता है.

• Google Mobile Ads Flutter प्लग इन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया.

1.0.0

• शुरुआती रिलीज़.

• ironSource के Android अडैप्टर के 8.0.0.0 वर्शन के साथ काम करता है.
• ironSource iOS अडैप्टर के 8.0.0.0.0 वर्शन के साथ काम करता है.

• Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.