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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

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

बिडिंग

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

Android

iOS

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

Android

iOS

झरना

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

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

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

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

बिडिंग

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

झरना

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

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

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

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

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

OpenUPM की जानकारी

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

Unity रजिस्ट्री

Google Mobile Ads IronSource मीडिएशन पैकेज चुनें और इंस्टॉल करें पर क्लिक करें.

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

Unity पैकेज

Changelog में दिए गए लिंक से IronSource के लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन का सबसे नया वर्शन डाउनलोड करें और ZIP फ़ाइल से GoogleMobileAdsIronSourceMediation.unitypackage एक्सट्रैक्ट करें.

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

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

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

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

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

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

ironSource Ads के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन वर्शन 1.0.0 में 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 के दस्तावेज़ देखें. इनमें, बेहतर तरीके से मैनेज करने की सेटिंग के बारे में बताया गया है.

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

Android

ProGuard के नियम

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

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

Unity User ProGuard फ़ाइल

अपने प्रोजेक्ट के लिए 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 विज्ञापनों से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर ResponseInfo का इस्तेमाल करके, विज्ञापन रिस्पॉन्स में हुई गड़बड़ी की जांच कर सकते हैं. इसके लिए, नीचे दी गई क्लास देखें:

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

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

iOS

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

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

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