इस गाइड में, Google Mobile Ads SDK का इस्तेमाल करके, प्रॉडक्ट को लोड करने और दिखाने का तरीका बताया गया है इसका इस्तेमाल करने वाले ironSource विज्ञापनों के विज्ञापन मीडिएशन, वॉटरफ़ॉल को कवर करती है इंटिग्रेशन. इसमें किसी विज्ञापन यूनिट की मीडिएशन कॉन्फ़िगरेशन और ironSource Ads SDK और अडैप्टर को इंटिग्रेट करने का तरीका किसी Flutter ऐप्लिकेशन में.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
ironSource Ads के AdMob मीडिएशन अडैप्टर में ये सुविधाएं मिलती हैं:
इंटिग्रेशन | |
---|---|
बिडिंग | को दबाकर रखें 1 |
झरना | |
फ़ॉर्मैट | |
बैनर | को दबाकर रखें 2 |
मध्यवर्ती | |
इनाम दिया गया | |
इनाम वाले इंटरस्टीशियल विज्ञापन | को दबाकर रखें 2 |
1 बिडिंग इंटिग्रेशन चुनिंदा उपयोगकर्ताओं के लिए बीटा वर्शन उपलब्ध है, तो ऐक्सेस का अनुरोध करने के लिए अपने खाता मैनेजर से संपर्क करें.
2 यह फ़ॉर्मैट सिर्फ़ वॉटरफ़ॉल इंटिग्रेशन के साथ काम करता है.
ज़रूरी शर्तें
- Google Mobile Ads SDK का नया वर्शन अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
- Flutter 3.7.0 या इसके बाद का वर्शन अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
- Android पर डिप्लॉय करने के लिए
- Android का एपीआई लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS 12.0 या इसके बाद का डिप्लॉयमेंट टारगेट
- Google के साथ कॉन्फ़िगर किया गया Flutter काम कर रहा प्रोजेक्ट मोबाइल विज्ञापन SDK टूल. यहां जाएं: ज़्यादा जानकारी के लिए, शुरू करें.
- मध्यस्थता की प्रक्रिया पूरी करें शुरुआती निर्देश
पहला चरण: 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 टूल और अडैप्टर इंपोर्ट करना
pub.dev के ज़रिए इंटिग्रेशन
(सिर्फ़ Android के लिए) अंदर की build.gradle
फ़ाइल में ये डेटा स्टोर करने की जगहें जोड़ें
आपके प्रोजेक्ट की android
डायरेक्ट्री:
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
इस डिपेंडेंसी को इसके सबसे नए वर्शन के साथ जोड़ें
IronSource
आपके पैकेज के SDK टूल और अडैप्टर
pubspec.yaml
फ़ाइल:
dependencies:
gma_mediation_ironsource: ^1.0.0
मैन्युअल इंटिग्रेशन
इसके लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन का सबसे नया वर्शन डाउनलोड करें
IronSource
डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें और एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर को जोड़ें
(और इसकी सामग्री) को आपके Flutter प्रोजेक्ट में शामिल करना होगा. फिर, अपने
pubspec.yaml
फ़ाइल में यह डिपेंडेंसी जोड़कर:
dependencies:
gma_mediation_ironsource:
path: path/to/local/package
चौथा चरण: ironSource विज्ञापन SDK टूल पर निजता सेटिंग लागू करना
ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर
Google ईयू उपयोगकर्ता की सहमति के तहत नीति के तहत, आपको यह पक्का करना होगा कि यूरोपियन इकनॉमिक एरिया (ईईए) के उपयोगकर्ताओं से मिली सहमति डिवाइस के आइडेंटिफ़ायर और निजी डेटा का इस्तेमाल नहीं किया जा सकता. यह नीति ईयू के ई-निजता निर्देश और सामान्य डेटा की सुरक्षा के लिए ज़रूरी शर्तें कानून (जीडीपीआर). सहमति लेते समय, आपको हर विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी डेटा इकट्ठा कर सकती है, पा सकती है या उसका इस्तेमाल कर सकती है. हम हर नेटवर्क के इस्तेमाल के बारे में जानकारी देते हैं. Google, फ़िलहाल ये काम नहीं कर पाएगा ऐसे नेटवर्क को अपने-आप उपयोगकर्ता की सहमति की सेटिंग भेजें.
ironSource विज्ञापनों के लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन
इसमें यह शामिल है
GmaMediationIronsource().SetConsent()
तरीका. नीचे दिया गया सैंपल कोड, पास करने का तरीका बताता है
IronSource Ads SDK टूल के लिए सहमति की जानकारी. अगर आपने इसे कॉल करने का विकल्प चुना है
तरीका है, तो यह सुझाव दिया जाता है कि आप
Google मोबाइल विज्ञापन SDK टूल.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setConsent(true);
यहां ironSource Ads के दस्तावेज़ देखें नियम के लिए ऐडवांस सेटिंग देखें.
अमेरिकी राज्य के निजता कानून
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है अमेरिका राज्यों के निजता कानून यह ज़रूरी है कि उपयोगकर्ता "बिक्री" से ऑप्ट आउट करने के लिए उनकी "निजी जानकारी" (जैसा कि कानून में उन शर्तों से ऑप्ट-आउट किया जा सकता है. जानकारी" "बिक्री" लिंक पार्टी का होम पेज. कॉन्टेंट बनाने अमेरिका राज्यों की निजता कानूनों का पालन करने से जुड़ी गाइड की मदद से, सीमित डेटा प्रोसेसिंग के लिए खोज रहे हैं, लेकिन Google इस सेटिंग को हर विज्ञापन पर लागू नहीं कर सकता अपनी मीडिएशन चेन में नेटवर्क का इस्तेमाल करें. इसलिए, आपको हर विज्ञापन नेटवर्क की पहचान करनी होगी जो आपकी मध्यस्थता शृंखला में, निजी डेटा की बिक्री में हिस्सा ले सकते हों साथ ही, इन नेटवर्क से मिलने वाले दिशा-निर्देशों का पालन करें और यह पक्का करें कि अनुपालन.
ironSource विज्ञापनों के लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन
इसमें यह शामिल है
GmaMediationIronsource().setDoNotSell
तरीका. नीचे दिया गया सैंपल कोड, पास करने का तरीका बताता है
IronSource Ads SDK टूल के लिए सहमति की जानकारी. ये विकल्प इससे पहले सेट होने चाहिए
आपने Google मोबाइल विज्ञापन शुरू करने के लिए
एसडीके टूल
ताकि यह पक्का किया जा सके कि वे IronSource Ads SDK पर सही तरीके से फ़ॉरवर्ड किए जाएं.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(true);
दोनों के लिए, रेगुलेशन की ऐडवांस सेटिंग के बारे में ironSource Ads के दस्तावेज़ देखें Android और iOS का इस्तेमाल करें.
पांचवां चरण: ज़रूरी कोड जोड़ना
Android
ProGuard नियम
अगर आपके ऐप्लिकेशन को छोटा किया जाता है, छिपाया जाता है, और उसे ऑप्टिमाइज़ किया जाता है, IronSource विज्ञापनों के लिए आपके प्रोजेक्ट के लिए, ProGuard के अतिरिक्त नियमों की ज़रूरत होती है.
सलाह लें
IronSource Ads की Android SDK इंटिग्रेशन गाइड
ताकि आपको इस बारे में ज़्यादा जानकारी मिल सके कि प्रोजेक्ट के लिए ProGuard के क्या नियम ज़रूरी हैं,
और उन नियमों को अपनी proguard-user.txt
फ़ाइल में जोड़ें.
ऐप्लिकेशन लाइफ़साइकल
इनमें से हर एक वैल्यू में, onPause()
और onResume()
के तरीके को बदलें
आपकी गतिविधियों से जुड़े ironSource विज्ञापन के तरीकों का इस्तेमाल इस तरह करना होगा:
Java
@Override
public void onResume() {
super.onResume();
IronSource.onResume(this);
}
@Override
public void onPause() {
super.onPause();
IronSource.onPause(this);
}
Kotlin
public override fun onResume() {
super.onResume()
IronSource.onResume(this)
}
public override fun onPause() {
super.onPause()
IronSource.onPause(this)
}
iOS
SKAdNetwork इंटिग्रेशन
अपने विज्ञापनों में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, ironSource Ads के दस्तावेज़ फ़ॉलो करें
प्रोजेक्ट की Info.plist
फ़ाइल.
छठा चरण: लागू होने की जांच करना
टेस्ट विज्ञापनों को चालू करें
पक्का करें कि आपनेके लिए अपना टेस्ट डिवाइस रजिस्टर किया हो और IronSource यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो. AdMob
टेस्ट विज्ञापनों की पुष्टि करें
यह पुष्टि करने के लिए कि IronSource से आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, ironSource Ads (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.
गड़बड़ी कोड
अगर अडैप्टर को ironSource विज्ञापनों से विज्ञापन नहीं मिलता है, तो पब्लिशर इसकी जांच कर सकते हैं
इसका इस्तेमाल करके, विज्ञापन रिस्पॉन्स में मौजूद गड़बड़ी को
ResponseInfo
ये क्लास:
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
यहां ironSource विज्ञापनों के ज़रिए दिखाए गए कोड और साथ वाले मैसेज दिए गए हैं अडैप्टर, जब कोई विज्ञापन लोड होने में असफल रहता है:
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 Flutter मीडिएशन अडैप्टर बदलाव लॉग
1.0.0
- शुरुआती रिलीज़.
- इस बात की पुष्टि की गई है कि ironSource Android अडैप्टर के 8.0.0.0 वर्शन के साथ काम करता है या नहीं
- इस बात की पुष्टि की गई है कि ironSource iOS अडैप्टर के 8.0.0.0.0 वर्शन के साथ काम करता है या नहीं
- इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.1.0 की मदद से बनाया और टेस्ट किया गया है.