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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

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

बिडिंग

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

Android

iOS

इंस्टेंस आईडी पर ध्यान दें.

Android

iOS

वॉटरफ़ॉल

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

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

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

अपनी Reporting API Key का पता लगाना

बिडिंग

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

वॉटरफ़ॉल

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

इसके बाद, ऐसेट > Play Services रिज़ॉल्वर > Android रिज़ॉल्वर > फ़ोर्स रिज़ॉल्व चुनें. Unity Play Services रिज़ॉल्वर लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन को नए सिरे से तैयार करेगी. साथ ही, तय की गई डिपेंडेंसी को आपके 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);

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

अमेरिकी राज्य के निजता कानून

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

ironSource Ads के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन वर्शन 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 को प्लैटफ़ॉर्म के तौर पर चुनें. इसके बाद, Player Settings खोलें और पब्लिश करने की सेटिंग टैब में, User ProGuard फ़ाइल को चुनें. Unity पर यह दिखना चाहिए कि बदलाव करने के लिए, कस्टम proguard-user.txt फ़ाइल कहां बनाई गई है.

Unity User ProGuard फ़ाइल

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

गड़बड़ी कोड

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

यहां किसी विज्ञापन के लोड न होने पर आयरनसोर्स विज्ञापन अडैप्टर के ज़रिए फेंके गए कोड और साथ में दिखाए जाने वाले मैसेज दिए गए हैं:

Android

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

iOS

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

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

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