आरंभ करें

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

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

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

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

बिडिंग के लिए: Google Mobile Ads SDK 18.3.0 या उससे ज़्यादा.

Mobile Ads SDK शुरू करें

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

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

Java

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        new Thread(
                () ->
                    // Initialize the Google Mobile Ads SDK on a background thread.
                    MobileAds.initialize(
                        this,
                        initializationStatus -> {
                          Map<String, AdapterStatus> statusMap =
                              initializationStatus.getAdapterStatusMap();
                          for (String adapterClass : statusMap.keySet()) {
                            AdapterStatus status = statusMap.get(adapterClass);
                            Log.d(
                                "MyApp",
                                String.format(
                                    "Adapter name: %s, Description: %s, Latency: %d",
                                    adapterClass, status.getDescription(), status.getLatency()));
                          }
                          // Start loading ads here...
                        }))
            .start();
    }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) { initializationStatus ->
        val statusMap =
          initializationStatus.adapterStatusMap
        for (adapterClass in statusMap.keys) {
          val status = statusMap[adapterClass]
          Log.d(
            "MyApp", String.format(
              "Adapter name: %s, Description: %s, Latency: %d",
              adapterClass, status!!.description, status.latency
            )
          )
        }
        // Start loading ads here...
      }
    }
  }
}

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

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

Java

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

Kotlin

override fun onAdLoaded() {
  Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}

इस तरीके के बारे में ज़्यादा जानने के लिए, getMediationAdapterClassName() पर ResponseInfo दस्तावेज़ देखें.

अपने विज्ञापन ऑब्जेक्ट को ऐक्टिविटी इंस्टेंस से शुरू करें

किसी नए विज्ञापन ऑब्जेक्ट (उदाहरण के लिए, AdManagerAdView) के कंस्ट्रक्टर में, आपको टाइप Context का ऑब्जेक्ट पास करना होगा. मीडिएशन का इस्तेमाल करते समय, यह Context दूसरे विज्ञापन नेटवर्क को भेजा जाता है. कुछ सूचनाएं मिल रही हैं विज्ञापन नेटवर्क कंपनियों के लिए, ज़्यादा पाबंदी वाले Context की ज़रूरत होती है. यह पाबंदी टाइप अलग-अलग होती है Activity और Activity इंस्टेंस के बिना विज्ञापन नहीं दिखाए जा सकते. इसलिए, हमारा सुझाव है कि विज्ञापन ऑब्जेक्ट को शुरू करते समय, Activity इंस्टेंस को पास करें. इससे, मीडिएशन वाले विज्ञापन नेटवर्क के साथ एक जैसा अनुभव मिलता रहेगा.

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

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

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

नेटिव विज्ञापनों का इस्तेमाल करते समय, इन सबसे सही तरीकों को अपनाएं मध्यस्थता.

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

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

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

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