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

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

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

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

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

बिडिंग

levelPlay > सेटअप > SDK नेटवर्क पर जाएं. इसके बाद, अपना ऐप्लिकेशन चुनें. बिडिंग में जाकर, बिडिंग इंस्टेंस आईडी देखने के लिए, 'बदलाव करें' आइकॉन पर क्लिक करें.

Android

iOS

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

Android

iOS

झरना

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

ज़रूरी जानकारी डालें और सेव करें और बंद करें पर क्लिक करें.

इंस्टेंस बन जाने के बाद, इंस्टेंस आईडी फ़ील्ड में इंस्टेंस आईडी दिखता है.

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

बिडिंग

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

झरना

AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, ऐप्लिकेशन कुंजी और इंस्टेंस आईडी के अलावा आपको अपने ironSource Ads की सीक्रेट कुंजी और रीफ़्रेश टोकन की भी ज़रूरत होगी.

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

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

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

दूसरा चरण: Ad Manager यूज़र इंटरफ़ेस (यूआई) में 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 के लिए 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 के में, 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 का दस्तावेज़ देखें.

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

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 इंटिग्रेशन

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

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

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

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

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

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