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

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

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

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

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

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

जारी रखने से पहले, इनकी पुष्टि करें:

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

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

अपने 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 की डिमांड सेट अप करना

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

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

Ad Manager के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में 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 Ads SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_ironsource: ^2.7.0

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

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

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

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

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

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

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

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

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

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

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

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

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

पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, 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 Mediation Adapter के बदलावों का लॉग

वर्शन 2.7.0

• ironSource Android अडैप्टर के वर्शन 9.6.0.1 के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 9.6.0.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.6.0

• ironSource Android अडैप्टर के वर्शन 9.6.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 9.5.0.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.5.1

• Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ काम करने के लिए अपडेट किया गया है.
• Swift Package Manager की सुविधा जोड़ें.
• ironSource Android अडैप्टर के वर्शन 9.5.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 9.5.0.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.5.0

• Google Mobile Ads Flutter प्लगिन के वर्शन 9.0.0 के साथ काम करने के लिए अपडेट किया गया.
• ironSource Android अडैप्टर के वर्शन 9.5.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 9.5.0.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 9.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.4.3

• ironSource Android अडैप्टर के वर्शन 9.4.4.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के 9.4.2.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.4.2

• ironSource Android अडैप्टर के वर्शन 9.4.2.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 9.4.1.0.1 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.4.1

• ironSource Android अडैप्टर के 9.4.2.0 वर्शन के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 9.4.1.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.4.0

• Flutter के कम से कम वर्शन को 3.38.1 पर अपडेट किया गया
• Google Mobile Ads Flutter प्लगिन के वर्शन 8.0.0 के साथ काम करने के लिए अपडेट किया गया
• ironSource Android अडैप्टर के 9.4.0.0 वर्शन के साथ काम करता है.
• ironSource iOS अडैप्टर के 9.4.0.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.3.0

• ironSource Android अडैप्टर के वर्शन 9.3.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के 9.2.0.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.2.0

• ironSource Android अडैप्टर के वर्शन 9.1.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 9.2.0.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.1.0

• ironSource Android अडैप्टर के वर्शन 9.1.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 9.1.0.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.0.1

• नए एपीआई के साथ iOS बिल्ड को ठीक किया गया
• ironSource Android अडैप्टर के वर्शन 9.0.0.0 के साथ काम करता है.
• ironSource iOS adapter के 9.0.0.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.0.0

• ironSource Android अडैप्टर के वर्शन 9.0.0.0 के साथ काम करता है.
• ironSource iOS adapter के 9.0.0.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.5.0

• ironSource Android अडैप्टर के वर्शन 8.10.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 8.10.0.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.1

• ironSource Android अडैप्टर के वर्शन 8.9.1.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के 8.9.1.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.0

• ironSource Android अडैप्टर के वर्शन 8.9.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के 8.9.1.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.3.1

• ironSource Android अडैप्टर के वर्शन 8.8.0.1 के साथ काम करता है.
• ironSource iOS अडैप्टर के 8.8.0.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.3.0

• ironSource Android अडैप्टर के वर्शन 8.8.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के वर्शन 8.8.0.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.2.0

• ironSource Android अडैप्टर के वर्शन 8.7.0.0 के साथ काम करता है.
• ironSource iOS अडैप्टर के 8.6.1.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.

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