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

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप का खुलना
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन  1
मूल भाषा वाला

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

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

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

  • Google Mobile Ads SDK for React Native का नया वर्शन.
  • React Native फ़्रेमवर्क का वर्शन 0.85.0 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads SDK for React Native के साथ कॉन्फ़िगर किया गया ऐसा React Native प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads SDK for React Native सेट अप करना लेख पढ़ें.
    • पक्का करें कि आपने gma-sdk-react-native फ़ोल्डर से adapters फ़ोल्डर को डाउनलोड और एक्सट्रैक्ट कर लिया हो. अगर आपके पास adapters फ़ोल्डर नहीं है, तो Google Mobile Ads SDK for React Native इंस्टॉल करें में जाकर, पहला, दूसरा, और तीसरा चरण अपनाएं.
  • AdMob मीडिएशन सेट अप करें.

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

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

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

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

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

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

Android

iOS

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

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

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

बिडिंग

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

Android

iOS

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

Android

iOS

वॉटरफ़ॉल

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

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

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

बिडिंग

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

वॉटरफ़ॉल

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

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

ऐप्लिकेशन के लिए, अनुमति वाले सेलर (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 और अडैप्टर को इंपोर्ट करना

अपने प्रोजेक्ट की रूट डायरेक्ट्री में, ironSource Ads के लिए Google Mobile Ads SDK for React Native मीडिएशन अडैप्टर इंस्टॉल करें. नीचे दिए गए कदमों को पूरा करें:

  1. Google Mobile Ads SDK for React Native अडैप्टर की tar फ़ाइल को gma-sdk-react-native/adapters/ironsource/ डायरेक्ट्री से अपने प्रोजेक्ट की local_packages/ डायरेक्ट्री में कॉपी करें. अगर आपके पास adapters फ़ोल्डर नहीं है, तो ज़रूरी शर्तें देखें.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/ironsource/gma-mediation-ironsource-0.1.0.tgz local_packages/

    EXTRACT_DIR को उस डायरेक्ट्री के पाथ से बदलें जहां आपने संग्रह को एक्सट्रैक्ट किया है.

  2. अपने पसंदीदा पैकेज मैनेजर का इस्तेमाल करके, अडैप्टर पैकेज इंस्टॉल करें:

    npm

    npm install ./local_packages/gma-mediation-ironsource-0.1.0.tgz

    ऊन

    yarn add ./local_packages/gma-mediation-ironsource-0.1.0.tgz

  3. अगर Android के लिए ऐप्लिकेशन बनाया जा रहा है, तो अपने प्रोजेक्ट की android डायरेक्ट्री में मौजूद build.gradle फ़ाइल में यह रिपॉज़िटरी जोड़ें:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://android-sdk.is.com/")
    }
}

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

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

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

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

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

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

import { IronSourceMediation } from '@google/gma-mediation-ironsource';
// ...
IronSourceMediation.setDoNotSell(true);

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

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

Android

Proguard के नियम

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

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

पक्का करें कि आपने 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 को शुरू नहीं किया गया है.
107 विज्ञापन लोड होने से पहले ही, उसे दिखाने का अनुरोध किया गया.
108 ironSource Ads SDK ने खाली बिडिंग सिग्नल दिखाए या कोई सिग्नल नहीं दिखाया.
501-1056 ironSource Ads SDK टूल से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए, दस्तावेज़ देखें.

iOS

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

वर्शन 0.1.0

  • शुरुआती रिलीज़.