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

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

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

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

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

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

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

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

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

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

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

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

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

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

AndroidiOS

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

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

बिडिंगझरना

LevelPlay > सेटअप > इंस्टेंस पर जाएं. इसके बाद, अपना ऐप्लिकेशन चुनें. बिडिंग में जाकर, ironSource पर क्लिक करें.

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

AndroidiOS

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

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

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

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

बिडिंगझरना

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

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

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

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

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

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

AndroidiOS

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

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

जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में ironSource Mobile को जोड़ना

AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के कानूनों के तहत विज्ञापन दिखाने वाले पार्टनर की सूची में ironSource Mobile को जोड़ने के लिए, यूरोपीय कानूनों से जुड़ी सेटिंग और अमेरिका के कानूनों से जुड़ी सेटिंग में दिया गया तरीका अपनाएं.

तीसरा चरण: ironSource Ads SDK टूल और अडैप्टर इंपोर्ट करना

OpenUPM-CLIOpenUPMUnity पैकेज

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

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

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

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

  • नाम: OpenUPM
  • URL: https://package.openupm.com
  • दायरा: com.google

OpenUPM की जानकारी

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

Unity रजिस्ट्री

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

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

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

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

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

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

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

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

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

ironSource Ads के वर्शन 1.0.0 के लिए, Google Mobile Ads मीडिएशन प्लग इन में IronSource.SetConsent() तरीका शामिल है. यहां दिए गए सैंपल कोड में, ironSource Ads SDK को सहमति की जानकारी पास करने का तरीका बताया गया है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK की मदद से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

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

IronSource.SetConsent(true);

ज़्यादा जानकारी के लिए, कानूनी समझौते की बेहतर सेटिंग पर ironSource Ads का दस्तावेज़ देखें.

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

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

ironSource Ads के वर्शन 2.2.4 के लिए, Google Mobile Ads मीडिएशन प्लग इन में 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 का दस्तावेज़ देखें.

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

AndroidiOS

ProGuard के नियम

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

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

Unity User Proguard File

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

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

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

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

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

जब कोई विज्ञापन लोड नहीं होता, तो ironSource Ads ऐडैप्टर से मिलने वाले कोड और मैसेज यहां दिए गए हैं:

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

IronSource Unity मीडिएशन प्लगिन में हुए बदलावों का लॉग

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 मीडिएशन प्लगिन से जुड़ी समस्या को ठीक किया गया.

वर्शन 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 वर्शन के साथ काम करता है.