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

प्लैटफ़ॉर्म चुनें: Android (बीटा)

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

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

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

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

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

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

iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए
[बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, IronSource अडैप्टर 8.5.0.0.1 या इसके बाद के वर्शन का इस्तेमाल करें (नए वर्शन का इस्तेमाल करने का सुझाव दिया जाता है)

Google Mobile Ads SDK पर अपलोड हुआ नया वीडियो.
मीडिएशन की प्रोसेस पूरी करने के लिए, शुरुआती निर्देश देखें.

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

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

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

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

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

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

कोई इंस्टेंस बनाना

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

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

बिडिंग

फ़ॉर्म भरें और कीमत के लिए बिडिंग को चुनें. सेव करें और बंद करें पर क्लिक करें.

अहम जानकारी: अगर आपको इनाम वाले इंटरस्टीशियल विज्ञापनों का इस्तेमाल करना है, तो इनाम वाला वीडियो फ़ॉर्मैट चुनें. इसके बाद, दूसरे चरण में विज्ञापन सोर्स के तौर पर ironSource Ads को जोड़ते समय, उस इंस्टेंस आईडी का इस्तेमाल करें. इसके अलावा, आपको Mobile-is-support@ironsrc.com पर ironSource Ads की सहायता टीम से संपर्क करना होगा, ताकि इनाम वाले इंटरस्टीशियल विज्ञापन दिखाने की सुविधा के लिए अपना इंस्टेंस सेट अप किया जा सके.

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

झरना

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

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

अपनी रिपोर्टिंग एपीआई पासकोड ढूंढना

बिडिंग

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

झरना

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

app-ads.txt फ़ाइल अपडेट करना

ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो Ad Manager के लिए app-ads.txt फ़ाइल बनाएं.

ironSource के लिए app-ads.txt लागू करने के बारे में जानने के लिए, ironSource के आधिकारिक रीसेलर लेख पढ़ें.

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

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

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

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

अपने Ad Manager खाते में साइन इन करें.

डिलीवरी > यील्ड ग्रुप पर जाएं. इसके बाद, नया यील्ड ग्रुप बटन पर क्लिक करें.

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

इसके बाद, यील्ड पार्टनर जोड़ें बटन पर क्लिक करें.

अगर आपने ironSource Ads के लिए पहले से कोई Yield partner चुना हुआ है, तो उसे चुना जा सकता है. इसके अलावा, नया यील्ड पार्टनर बनाएं को चुनें.

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

डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. इसके बाद, पिछले सेक्शन में मिली सीक्रेट कुंजी और रीफ़्रेश टोकन डालें.

यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर मोबाइल SDK मीडिएशन, प्लैटफ़ॉर्म के तौर पर iOS, और स्थिति के तौर पर चालू है चुनें. पिछले सेक्शन में मिला ऐप्लिकेशन की और इंस्टेंस आईडी डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.

इसके बाद, पेज पर सबसे नीचे सेव करें पर क्लिक करें.

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

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

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

Swift Package Manager का इस्तेमाल करना

जारी रखने से पहले, आपके पास अडैप्टर का कम से कम 8.10.0.0 वर्शन होना चाहिए.

अपने प्रोजेक्ट में पैकेज डिपेंडेंसी जोड़ने के लिए, यह तरीका अपनाएं:

Xcode में, File > Add Package Dependencies... पर जाएं.
दिखने वाले प्रॉम्प्ट में, इस पैकेज यूआरएल को खोजें:
```
https://github.com/googleads/googleads-mobile-ios-mediation-ironsource.git
```
डिपेंडेंसी का नियम में जाकर, ब्रांच चुनें.
टेक्स्ट फ़ील्ड में, main डालें.

CocoaPods का इस्तेमाल करना

अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:
```
pod 'GoogleMobileAdsMediationIronSource'
```
कमांड लाइन से यह निर्देश चलाएं:
```
pod install --repo-update
```

मैन्युअल इंटिग्रेशन

ironSource Ads iOS SDK का नया वर्शन डाउनलोड करें और IronSource.framework को अपने प्रोजेक्ट में लिंक करें.
बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, ironSource Ads अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, IronSourceAdapter.framework को अपने प्रोजेक्ट में लिंक करें.

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

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

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

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

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

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

Swift

// For Swift integration, you need to import the ironSource SDK in your Bridging Header.
// For more details, see https://developers.is.com/ironsource-mobile/ios/ironsource-ios-sdk-integration-swift/
// ...

IronSource.setMetaDataWithKey("do_not_sell", value: "YES")

Objective-C

#import <IronSource/IronSource.h>
// ...

[IronSource setMetaDataWithKey:@"do_not_sell" value:@"YES"];

ज़्यादा जानकारी के लिए, ironSource Ads का Regulation Advanced Settings दस्तावेज़ देखें. साथ ही, यह भी जानें कि इस तरीके में कौनसी वैल्यू दी जा सकती हैं.

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

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

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

GADResponseInfo.adNetworkInfoArray इन क्लास के तहत:

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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

IronSource iOS Mediation Adapter के बदलावों की जानकारी