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

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

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

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

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

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

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

बिडिंग

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

Android

iOS

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

Android

iOS

झरना

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

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

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

बिडिंग

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

झरना

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

app-ads.txt फ़ाइल अपडेट करना

Authorized Sellers for Apps app-ads.txt, IAB Tech Lab की एक पहल है. इसकी मदद से, यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे ही चैनल बेचते हैं जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.

ironSource के लिए app-ads.txt लागू करने के बारे में जानने के लिए, ironSource के आधिकारिक रीसेलर लेख पढ़ें.

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

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

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

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

Android

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

iOS

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

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 Ads SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_ironsource: ^

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

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

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

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

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

ironSource Ads के लिए Google Mobile Ads mediation प्लगिन में, 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 Mobile Ads mediation प्लगिन में, GmaMediationIronsource().setDoNotSell तरीका शामिल है. यहां दिए गए सैंपल कोड में बताया गया है कि ironSource Ads SDK को सहमति की जानकारी कैसे भेजी जाती है. इन विकल्पों को Google Mobile Ads SDK को शुरू करने से पहले सेट किया जाना चाहिए, ताकि यह पक्का किया जा सके कि इन्हें ironSource Ads SDK को सही तरीके से फ़ॉरवर्ड किया गया है.

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(true);

ज़्यादा जानकारी के लिए, ironSource Ads के दस्तावेज़ में, Android और iOS, दोनों के लिए रेगुलेशन से जुड़ी ऐडवांस सेटिंग देखें. साथ ही, इस तरीके में दी जा सकने वाली वैल्यू देखें.

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

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 के दस्तावेज़ पढ़ें.

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

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

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

iOS

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

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

वर्शन 1.5.0 (जारी है)

वर्शन 1.4.1

वर्शन 1.4.0

वर्शन 1.3.1

वर्शन 1.3.0

वर्शन 1.2.0

वर्शन 1.1.0

वर्शन 1.0.0