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

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

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

ironSource Ads के AdMob मीडिएशन अडैप्टर में ये काम करते हैं:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ironSource Ads के टेस्ट विज्ञापनों को चालू करने के लिए, ironSource 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

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

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

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

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

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

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

ironSource Ads के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन में 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)
}

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

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

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

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

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

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

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

यहां किसी विज्ञापन के लोड न होने पर आयरनसोर्स विज्ञापन अडैप्टर के ज़रिए फेंके गए कोड और साथ में दिखाए जाने वाले मैसेज दिए गए हैं:

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 की मदद से बनाया और टेस्ट किया गया है.