मध्‍यस्‍थता

इस गाइड में, अपने Flutter ऐप्लिकेशन के साथ मीडिएशन अडैप्टर को इंटिग्रेट करने का तरीका बताया गया है.

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

किसी विज्ञापन फ़ॉर्मैट के लिए मीडिएशन को इंटिग्रेट करने से पहले, आपको उस विज्ञापन फ़ॉर्मैट को अपने ऐप्लिकेशन में इंटिग्रेट करना होगा:

क्या आपने पहले कभी मीडिएशन का इस्तेमाल नहीं किया है? मीडिएशन के बारे में जानकारी पढ़ें.

Mobile Ads SDK को शुरू करना

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

यहां दिए गए सैंपल कोड में बताया गया है कि विज्ञापन का अनुरोध करने से पहले, हर अडैप्टर के शुरू होने का स्टेटस कैसे देखा जा सकता है.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Gradle की सेटिंग अपडेट करना (सिर्फ़ Android के लिए)

अपनी settings.gradle फ़ाइल में ये लाइनें जोड़ें, ताकि आप प्लग इन के Android एपीआई का इस्तेमाल कर सकें:

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

पार्टनर नेटवर्क के लिए डिपेंडेंसी जोड़ना

मीडिएशन अडैप्टर और उनकी डिपेंडेंसी को आपके Android और iOS प्रोजेक्ट में जोड़ना ज़रूरी है. इन्हें जोड़ने के लिए, Android पर ऐप्लिकेशन लेवल की build.gradle फ़ाइल और iOS पर Podfile को अपडेट करें. Google के पास GitHub में, Android और iOS, दोनों के लिए ओपन सोर्स अडैप्टर हैं.

अपने ऐप्लिकेशन में पार्टनर नेटवर्क का अडैप्टर जोड़ने का तरीका जानने के लिए, हर पार्टनर नेटवर्क के लिए Android और iOS के दस्तावेज़ देखें.

देखें कि विज्ञापन किस विज्ञापन नेटवर्क अडैप्टर क्लास ने लोड किया

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

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

मीडिएशन के साथ बैनर विज्ञापनों का इस्तेमाल करना

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

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

नेटिव मीडिएशन लागू करते समय, इन सबसे सही तरीकों का ध्यान रखें.

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

अमेरिका के निजता कानून और जीडीपीआर

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

Google User Messaging Platform (UMP) SDK टूल की मदद से, सीमित डेटा प्रोसेसिंग (आरडीपी) को चालू करने और जीडीपीआर की सहमति पाने के बारे में ज़्यादा जानें.