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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

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

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

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

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

APP KEY और इंस्टेंस आईडी के अलावा, आपको अपना Ad Manager विज्ञापन यूनिट आईडी सेट अप करने के लिए ironSource Secret Key और Refresh Token की भी ज़रूरत होगी.

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

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

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

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

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

Android

निर्देशों के लिए, Android.

iOS

निर्देशों के लिए, iOS.

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

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

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

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

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

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

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

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

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

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

IronSource.SetConsent(true);

ज़्यादा जानकारी के लिए, Regulation Advanced Settings के बारे में ironSource का दस्तावेज़ देखें.

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

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

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

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

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

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

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

Android

प्रोगार्ड के नियम

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

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

Unity उपयोगकर्ता ProGuard फ़ाइल

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

iOS

SKAdNetwork इंटिग्रेशन

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

छठा चरण: लागू होने की जांच करना

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

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

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

यह पुष्टि करने के लिए कि ironSourceसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, ironSource (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.

गड़बड़ी कोड

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

यहां विज्ञापन लोड न होने पर, ironSource अडैप्टर के ज़रिए थ्रो किए गए कोड और उससे जुड़े मैसेज यहां दिए गए हैं:

Android

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

iOS

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

IronSource Unity मीडिएशन प्लगिन चेंजलॉग

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