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

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

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

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

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

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

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

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

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

  • 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 खाते में साइन अप करें और साइन इन करें.

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

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

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

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

    Android

    iOS

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

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

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

    बिडिंग

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

    Android

    iOS

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

    Android

    iOS

    वॉटरफ़ॉल

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

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

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

    बिडिंग

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

    वॉटरफ़ॉल

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

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

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

    Android

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

    iOS

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

    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 का दस्तावेज़ देखें. साथ ही, यह भी जानें कि इस तरीके में कौनसी वैल्यू दी जा सकती हैं.

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

    Android

    Proguard के नियम

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

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

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

    अपनी हर गतिविधि में 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)
}

    iOS

    SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

    Android

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

    iOS

    GADMAdapterIronSource
GADMAdapterIronSourceRewarded

    विज्ञापन लोड न होने पर, ironSource Ads अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:

    Android

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

    iOS

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

    ironSource Flutter Mediation Adapter के बदलावों का लॉग

    वर्शन 2.7.0

    वर्शन 2.6.0

    वर्शन 2.5.1

    वर्शन 2.5.0

    वर्शन 2.4.3

    वर्शन 2.4.2

    वर्शन 2.4.1

    वर्शन 2.4.0

    वर्शन 2.3.0

    वर्शन 2.2.0

    वर्शन 2.1.0

    वर्शन 2.0.1

    वर्शन 2.0.0

    वर्शन 1.5.0

    वर्शन 1.4.1

    वर्शन 1.4.0

    वर्शन 1.3.1

    वर्शन 1.3.0

    वर्शन 1.2.0

    वर्शन 1.1.0

    वर्शन 1.0.0