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

प्लैटफ़ॉर्म चुनें: Android (बीटा वर्शन) नई सुविधा Android iOS Unity Flutter

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

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

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

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

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

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

  • Google Mobile Ads Unity Plugin पर अपलोड हुआ नया वीडियो
  • Unity 4 या इसके बाद वाला वर्शन
  • [बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, IronSource 3.5.1 या इसके बाद के वर्शन के लिए Google Mobile Ads मीडिएशन प्लगिन का इस्तेमाल करें (नए वर्शन का इस्तेमाल करने का सुझाव दिया जाता है)
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 23 या इसके बाद का वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 12.0 या इसके बाद का वर्शन होना चाहिए
  • Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
  • मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश

पहला चरण: 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 और अडैप्टर को इंपोर्ट करना

OpenUPM-CLI

अगर आपने OpenUPM-CLI इंस्टॉल किया है, तो Google Mobile Ads ironSource Ads Mediation Plugin for Unity को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है. इसके लिए, अपने प्रोजेक्ट की रूट डायरेक्ट्री में जाकर यह कमांड चलाएं:

openupm add com.google.ads.mobile.mediation.ironsource

OpenUPM

अपने यूनिटी प्रोजेक्ट एडिटर में, बदलाव करें > प्रोजेक्ट सेटिंग > Package Manager को चुनें. इससे Unity Package Manager की सेटिंग खुल जाएंगी.

स्कोप की गई रजिस्ट्री टैब में जाकर, OpenUPM को स्कोप की गई रजिस्ट्री के तौर पर जोड़ें. इसके लिए, यह जानकारी दें:

  • नाम: OpenUPM
  • URL: https://package.openupm.com
  • स्कोप: com.google

OpenUPM की जानकारी

इसके बाद, विंडो > पैकेज मैनेजर पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.

Unity Registries

Google Mobile Ads IronSource Mediation पैकेज को चुनें और इंस्टॉल करें पर क्लिक करें.

OpenUPM से इंस्टॉल करना

Unity पैकेज

बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, ironSource Ads के लिए Google Mobile Ads mediation plugin का नया वर्शन डाउनलोड करें. इसके बाद, zip फ़ाइल से GoogleMobileAdsIronSourceMediation.unitypackage को निकालें.

अपने यूनिटी प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज चुनें. इसके बाद, डाउनलोड की गई GoogleMobileAdsIronSourceMediation.unitypackage फ़ाइल ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.

Unity से इंपोर्ट करना

इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve को चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को शुरू से हल करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

ज़बरदस्ती हल करें

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

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

ironSource अडैप्टर Unity प्लगिन के वर्शन 2.6.0 से, ironSource उन सहमति मैनेजमेंट प्लैटफ़ॉर्म से जीडीपीआर के तहत ली गई सहमति को अपने-आप पढ़ लेता है जो Google की अतिरिक्त सहमति से जुड़ी खास जानकारी के साथ काम करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, Google UMP और Google के अतिरिक्त सहमति मोड के साथ काम करने वाले सीएमपी के लिए सहायता लेख पढ़ें.

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

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

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

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

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

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

Android

Proguard के नियम

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

प्रोजेक्ट बनाते समय, प्लैटफ़ॉर्म के तौर पर Android को चुनें. इसके बाद, प्लेयर सेटिंग खोलें और पब्लिशिंग सेटिंग टैब में जाकर, User Proguard File को चुनें. Unity को यह दिखाना चाहिए कि आपके लिए कस्टम proguard-user.txt फ़ाइल कहां बनाई गई है, ताकि आप उसमें बदलाव कर सकें.

Unity User Proguard File

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

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 Unity मीडिएशन प्लगिन के बदलावों की जानकारी

वर्शन 4.2.0

वर्शन 4.1.0

वर्शन 4.0.0

वर्शन 3.11.1

वर्शन 3.11.0

वर्शन 3.10.0

वर्शन 3.9.1

वर्शन 3.9.0

वर्शन 3.8.1

वर्शन 3.8.0

वर्शन 3.7.0

वर्शन 3.6.1

वर्शन 3.6.0

वर्शन 3.5.2

वर्शन 3.5.1

वर्शन 3.5.0

वर्शन 3.4.0

वर्शन 3.3.1

वर्शन 3.3.0

वर्शन 3.2.1

वर्शन 3.2.0

वर्शन 3.1.1

वर्शन 3.1.0

वर्शन 3.0.1

वर्शन 3.0.0

वर्शन 2.6.1

वर्शन 2.6.0

वर्शन 2.5.0

वर्शन 2.4.0

वर्शन 2.3.1

वर्शन 2.3.0

  • अडैप्टर के कॉन्टेंट को GoogleMobileAds/Mediation/IronSource/ में ले जाया गया.
  • GoogleMobileAds.Mediation.IronSource का इस्तेमाल करने के लिए, अडैप्टर नेमस्पेस को फिर से फ़ैक्टर किया गया.
  • IronSource Android अडैप्टर वर्शन 7.3.0.1.0 के साथ काम करता है.
  • IronSource iOS अडैप्टर वर्शन 7.3.0.0.0 के साथ काम करता है.
  • इसे Google Mobile Ads Unity प्लगिन के वर्शन 8.1.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.2.7

वर्शन 2.2.6

वर्शन 2.2.5

वर्शन 2.2.4

वर्शन 2.2.3

वर्शन 2.2.2

वर्शन 2.2.1

वर्शन 2.2.0

वर्शन 2.1.5

वर्शन 2.1.4

वर्शन 2.1.3

वर्शन 2.1.2

वर्शन 2.1.1

वर्शन 2.1.0

वर्शन 2.0.3

वर्शन 2.0.2

वर्शन 2.0.1

वर्शन 2.0.0

वर्शन 1.10.0

वर्शन 1.9.1

वर्शन 1.9.0

वर्शन 1.8.2

वर्शन 1.8.1

वर्शन 1.8.0

वर्शन 1.7.0

वर्शन 1.6.0

वर्शन 1.5.0

वर्शन 1.4.0

वर्शन 1.3.2

वर्शन 1.3.1

  • IronSource Android अडैप्टर के 6.10.0.0 वर्शन के साथ काम करता है
  • IronSource iOS अडैप्टर के 6.8.6.0 वर्शन के साथ काम करता है

वर्शन 1.3.0

  • IronSource Android अडैप्टर के 6.10.0.0 वर्शन के साथ काम करता है
  • यह IronSource iOS अडैप्टर के 6.8.4.1.0 वर्शन के साथ काम करता है

वर्शन 1.2.0

  • IronSource Android अडैप्टर के वर्शन 6.9.0.1 के साथ काम करता है
  • यह IronSource iOS अडैप्टर के 6.8.4.1.0 वर्शन के साथ काम करता है

वर्शन 1.1.2

  • IronSource Android अडैप्टर के वर्शन 6.8.4.1 के साथ काम करता है
  • IronSource iOS अडैप्टर के 6.8.4.1 वर्शन के साथ काम करता है

वर्शन 1.1.1

  • IronSource Android अडैप्टर के वर्शन 6.8.4.1 के साथ काम करता है
  • IronSource iOS अडैप्टर के 6.8.3.0 वर्शन के साथ काम करता है

वर्शन 1.1.0

  • नए ओपन-बीटा Rewarded API के साथ काम करने के लिए, प्लगिन को अपडेट किया गया है.
  • IronSource Android अडैप्टर के 6.8.1.2 वर्शन के साथ काम करता है
  • IronSource iOS अडैप्टर के 6.8.0.1 वर्शन के साथ काम करता है

वर्शन 1.0.4

  • IronSource Android अडैप्टर के 6.7.11.0 वर्शन के साथ काम करता है
  • IronSource iOS अडैप्टर के वर्शन 6.7.11.0 के साथ काम करता है

वर्शन 1.0.3

  • IronSource Android अडैप्टर के वर्शन 6.7.10.0 के साथ काम करता है
  • IronSource iOS अडैप्टर के वर्शन 6.7.10.0 के साथ काम करता है

वर्शन 1.0.2

  • IronSource Android अडैप्टर के वर्शन 6.7.9.1.1 के साथ काम करता है
  • IronSource iOS अडैप्टर के वर्शन 6.7.10.0 के साथ काम करता है
  • Chartboost Unity mediation प्लगिन के साथ होने वाले विवाद को ठीक किया गया है.

वर्शन 1.0.1

  • IronSource Android अडैप्टर के वर्शन 6.7.9.0 के साथ काम करता है.
  • IronSource iOS अडैप्टर के वर्शन 6.7.9.2.0 के साथ काम करता है.

वर्शन 1.0.0

  • पहली रिलीज़!
  • IronSource Android अडैप्टर के वर्शन 6.7.9.0 के साथ काम करता है.
  • IronSource iOS अडैप्टर के 6.7.9.1.0 वर्शन के साथ काम करता है.