नेटिव विज्ञापन

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

जब कोई नेटिव विज्ञापन लोड होता है, तो आपके ऐप्लिकेशन को एक विज्ञापन ऑब्जेक्ट मिलता है. इसमें उसकी एसेट होती हैं. इसके बाद, उन्हें दिखाने की ज़िम्मेदारी Google Mobile Ads SDK टूल के बजाय, ऐप्लिकेशन की होती है.

नेटिव विज्ञापनों को सही तरीके से लागू करने के लिए, दो काम करने होते हैं: SDK टूल का इस्तेमाल करके विज्ञापन लोड करना और फिर अपने ऐप्लिकेशन में विज्ञापन कॉन्टेंट दिखाना.

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

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

हमेशा टेस्ट विज्ञापनों की मदद से जांच करें

अपने ऐप्लिकेशन बनाते और टेस्ट करते समय, लाइव और प्रोडक्शन विज्ञापनों के बजाय, टेस्ट विज्ञापनों का इस्तेमाल करें.

टेस्ट विज्ञापन लोड करने का सबसे आसान तरीका, Android पर नेटिव विज्ञापनों के लिए, खास तौर पर बनाई गई टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करना है:

/21775744923/example/native

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

Google Mobile Ads SDK के टेस्ट विज्ञापनों के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, टेस्ट विज्ञापन लेख पढ़ें.

विज्ञापन लोड करना

नेटिव विज्ञापन, AdLoader क्लास के साथ लोड किए जाते हैं. इस क्लास में, विज्ञापन बनाने के दौरान उसे पसंद के मुताबिक बनाने के लिए, Builder क्लास होती है. AdLoader को बनाते समय, उसमें लिसनर जोड़कर, ऐप्लिकेशन यह तय करता है कि उसे किस तरह के नेटिव विज्ञापन दिखाए जाएं. इसके बाद, AdLoader सिर्फ़ उन टाइप के लिए अनुरोध करता है.

AdLoader बनाना

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

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            // Show the ad.
        }
    })
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .withNativeAdOptions(new NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native}")
    .forNativeAd { ad : NativeAd ->
        // Show the ad.
    }
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // Handle the failure.
        }
    })
    .withNativeAdOptions(NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build()

NativeAd फ़ॉर्मैट के लिए AdLoader को तैयार करने की ज़िम्मेदारी, forNativeAd() तरीके की है. विज्ञापन लोड होने के बाद, listener ऑब्जेक्ट के onNativeAdLoaded() मेथड को कॉल किया जाता है.

AdLoader के साथ AdListener सेट अप करना (ज़रूरी नहीं)

AdLoader बनाते समय, withAdListener फ़ंक्शन, लोडर के लिए AdListener सेट करता है. यह मेथड, AdListener को अपने एकमात्र पैरामीटर के तौर पर इस्तेमाल करता है. विज्ञापन लाइफ़साइकल इवेंट होने पर, इसे AdLoader से कॉलबैक मिलते हैं:

Java

.withAdListener(new AdListener() {
    // AdListener callbacks can be overridden here.
})

Kotlin

.withAdListener(object : AdListener() {
    // AdListener callbacks can be overridden here.
})

विज्ञापन जोड़ने का अनुरोध करें

AdLoader बनाने के बाद, विज्ञापनों का अनुरोध करने के लिए उसका इस्तेमाल किया जा सकता है. loadAd() तरीके का इस्तेमाल करें, जो पहले पैरामीटर के तौर पर AdManagerAdRequest ऑब्जेक्ट लेता है. यह वही AdManagerAdRequest क्लास है जिसका इस्तेमाल बैनर और इंटरस्टीशियल विज्ञापनों में किया जाता है. साथ ही, टारगेटिंग की जानकारी जोड़ने के लिए, AdManagerAdRequest क्लास के तरीकों का इस्तेमाल किया जा सकता है. ठीक उसी तरह जैसे अन्य विज्ञापन फ़ॉर्मैट में किया जाता है.

loadAd()

इस तरीके से, एक विज्ञापन के लिए अनुरोध भेजा जाता है.

Java

adLoader.loadAd(new AdManagerAdRequest.Builder().build());

Kotlin

adLoader.loadAd(AdManagerAdRequest.Builder().build())

कॉलबैक

loadAd() को कॉल करने के बाद, नेटिव विज्ञापन ऑब्जेक्ट डिलीवर करने या गड़बड़ी की शिकायत करने के लिए, पहले से तय किए गए लिसनर तरीकों पर एक बार कॉलबैक किया जाता है.

संसाधन रिलीज़ करना

लोड किए गए नेटिव विज्ञापनों पर destroy() तरीके का इस्तेमाल करना न भूलें. इससे, इस्तेमाल न किए गए रिसॉर्स रिलीज़ हो जाते हैं और मेमोरी लीक होने से रोका जा सकता है.

पक्का करें कि आपकी गतिविधि के onDestroy() तरीके में, सभी NativeAd रेफ़रंस मिटा दिए गए हों.

अपने onNativeAdLoaded कॉलबैक में, उन सभी मौजूदा नेटिव विज्ञापनों को मिटाना न भूलें जिनका रेफ़रंस हटाया जाएगा.

एक और अहम जांच यह है कि गतिविधि बंद हो गई है या नहीं. अगर गतिविधि बंद हो गई है, तो दिखाए गए विज्ञापन पर destroy() को कॉल करें और तुरंत वापस आएं:

Java

final AdLoader adLoader = new AdLoader.Builder(this, "/21775744923/example/native")
        .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed()` is a method on Activity.
        if (isDestroyed()) {
            nativeAd.destroy();
            return;
        }
        ...
    }
}).build();

Kotlin

lateinit var adLoader: AdLoader
...
adLoader = AdLoader.Builder(this, "/21775744923/example/native")
    .forNativeAd { nativeAd ->
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed` is a method on Activity.
        if (isDestroyed) {
            nativeAd.destroy()
            return@forNativeAd
        }
        ...
    }.build()

सबसे सही तरीके

विज्ञापन लोड करते समय इन नियमों का पालन करें.

  • सूची में नेटिव विज्ञापनों का इस्तेमाल करने वाले ऐप्लिकेशन को, विज्ञापनों की सूची को पहले से कैश मेमोरी में सेव कर लेना चाहिए.

  • विज्ञापनों को पहले से कैश मेमोरी में सेव करने के दौरान, अपनी कैश मेमोरी मिटाएं और एक घंटे बाद फिर से लोड करें.

  • जब तक पहला अनुरोध लोड नहीं हो जाता, तब तक AdLoader पर loadAd() को कॉल न करें.

  • नेटिव विज्ञापन को सिर्फ़ ज़रूरत के हिसाब से कैश मेमोरी में सेव करें. उदाहरण के लिए, पहले से कैश मेमोरी में सेव करने के दौरान, सिर्फ़ उन विज्ञापनों को कैश मेमोरी में सेव करें जो स्क्रीन पर तुरंत दिखते हैं. नेटिव विज्ञापनों के लिए ज़्यादा मेमोरी का इस्तेमाल होता है. साथ ही, नेटिव विज्ञापनों को मिटाए बिना उन्हें कैश मेमोरी में सेव करने पर, ज़्यादा मेमोरी का इस्तेमाल होता है.

  • इस्तेमाल में न होने पर नेटिव विज्ञापनों को मिटा दें.

वीडियो विज्ञापनों के लिए हार्डवेयर से तेज़ी लाएं

नेटिव विज्ञापन व्यू में वीडियो विज्ञापन दिखाने के लिए, हार्डवेयर ऐक्सेलरेशन चालू होना ज़रूरी है.

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

हार्डवेयर से तेज़ी लाने की सुविधा चालू करना

अगर आपका ऐप्लिकेशन, हार्डवेयर एक्सेलेरेशन की सुविधा को पूरी तरह से चालू करने पर ठीक से काम नहीं करता है, तो इसे अलग-अलग गतिविधियों के लिए भी कंट्रोल किया जा सकता है. हार्डवेयर से तेज़ी लाने की सुविधा को चालू या बंद करने के लिए, अपने AndroidManifest.xml में <application> और <activity> एलिमेंट के लिए android:hardwareAccelerated एट्रिब्यूट का इस्तेमाल करें. नीचे दिए गए उदाहरण में, पूरे ऐप्लिकेशन के लिए हार्डवेयर ऐक्सेलरेशन चालू किया गया है, लेकिन एक गतिविधि के लिए इसे बंद किया गया है:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

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

आपका विज्ञापन दिखाना

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