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

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

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

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

¹ बिडिंग इंटिग्रेशन, क्लोज़्ड बीटा वर्शन में है. ऐक्सेस का अनुरोध करने के लिए, अपने खाता मैनेजर से संपर्क करें.

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

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

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

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

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

अपने ऐप्लिकेशन को IronSource Ads डैशबोर्ड में जोड़ने के लिए, नया ऐप्लिकेशन बटन पर क्लिक करें.

ऐप्लिकेशन के बारे में जानकारी डालें

लाइव ऐप्लिकेशन चुनें. इसके बाद, अपने ऐप्लिकेशन का ऐप्लिकेशन आईडी डालें और ऐप्लिकेशन की जानकारी इंपोर्ट करें पर क्लिक करें.

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

बाकी जानकारी भरें और ऐप्लिकेशन जोड़ें पर क्लिक करें.

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

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

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

Reporting API पासकोड का पता लगाना

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

ronSource Ads की इंटिग्रेशन टेस्टिंग गाइड में दिए गए निर्देशों का पालन करें.

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

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

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

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

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

pub.dev के ज़रिए इंटिग्रेशन

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

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

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

dependencies:
  gma_mediation_ironsource: ^1.0.0

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

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

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

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

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

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

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

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

@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)
}

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

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

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

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

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

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

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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

अगला वर्शन

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

1.1.0

• इस बात की पुष्टि की गई है कि ironSource Android अडैप्टर के 8.2.1.0 वर्शन के साथ काम करता है या नहीं
• ironSource के iOS अडैप्टर के 8.2.0.0.0 वर्शन के साथ काम करने की पुष्टि की गई है
• Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.

1.0.0

• शुरुआती रिलीज़.
• ironSource के Android अडैप्टर के 8.0.0.0 वर्शन के साथ काम करने की पुष्टि की गई है
• ironSource के iOS अडैप्टर के 8.0.0.0.0 वर्शन के साथ काम करने की पुष्टि की गई है
• Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.