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

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

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

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

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

ग्राहकों की कुछ सफलता की कहानियां भी देखी जा सकती हैं: केस स्टडी 1, केस स्टडी 2.

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

• शुरुआती निर्देशों की गाइड को पूरा करें.

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

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

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

ca-app-pub-3940256099942544/2247696110

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

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

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

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

AdLoader बनाना

अहम जानकारी: Mobile Ads SDK को सभी कॉल, मुख्य थ्रेड पर करें.

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

Java

AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110")
    .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, "ca-app-pub-3940256099942544/2247696110}")
    .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()

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

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() और loadAds().

अहम जानकारी: फ़िलहाल, loadAds() तरीका सिर्फ़ Google विज्ञापनों के साथ काम करता है. मीडिएशन वाले विज्ञापनों के लिए, इसके बजाय loadAd() का इस्तेमाल करें.

loadAd()

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

Java

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

Kotlin

adLoader.loadAd(AdRequest.Builder().build())

loadAds()

इस तरीके से, एक से ज़्यादा विज्ञापनों (ज़्यादा से ज़्यादा पांच) के लिए अनुरोध भेजा जाता है:

Java

adLoader.loadAds(new AdRequest.Builder().build(), 3);

Kotlin

adLoader.loadAds(AdRequest.Builder().build(), 3)

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

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

loadAds() तरीके में एक और पैरामीटर होता है: अनुरोध के लिए, SDK टूल को जितने विज्ञापन लोड करने चाहिए उनकी संख्या. यह संख्या पांच तक सीमित है. साथ ही, यह गारंटी नहीं है कि SDK टूल, अनुरोध किए गए विज्ञापनों की सटीक संख्या दिखाएगा.

Google से दिखाए गए विज्ञापन, एक-दूसरे से अलग होंगे. हालांकि, यह ज़रूरी नहीं है कि रिज़र्व की गई इन्वेंट्री या तीसरे पक्ष के खरीदारों के विज्ञापन यूनीक हों.

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

कॉलबैक

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

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

यहां एक उदाहरण दिया गया है, जिसमें onNativeAdLoaded() कॉलबैक में isLoading() की जांच करने का तरीका बताया गया है:

Java

final AdLoader adLoader = new AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
        .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
        ...
        // some code that displays the ad.
        ...
        if (adLoader.isLoading()) {
            // The AdLoader is still loading ads.
            // Expect more adLoaded or onAdFailedToLoad callbacks.
        } else {
            // The AdLoader has finished loading ads.
        }
    }
}).build();
adLoader.loadAds(new AdRequest.Builder().build(), 3);

Kotlin

lateinit var adLoader: AdLoader
...
adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
    .forNativeAd {
        ...
        // some code that displays the ad.
        ...
        if (adLoader.isLoading) {
            // The AdLoader is still loading ads.
            // Expect more adLoaded or onAdFailedToLoad callbacks.
        } else {
            // The AdLoader has finished loading ads.
        }
    }.build()
adLoader.loadAds(AdRequest.Builder().build(), 3)

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

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

अहम जानकारी: destroy() को सभी विज्ञापनों पर कॉल किया जाना चाहिए. भले ही, उनका इस्तेमाल न किया गया हो या उनका रेफ़रंस न दिया गया हो.

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

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

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

Java

final AdLoader adLoader = new AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
        .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, "ca-app-pub-3940256099942544/2247696110")
    .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() या loadAds() को कॉल न करें.

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

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

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

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

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

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

अगर आपका ऐप्लिकेशन, हार्डवेयर एक्सेलेरेशन की सुविधा को पूरी तरह से चालू करने पर ठीक से काम नहीं करता है, तो इसे अलग-अलग गतिविधियों के लिए भी कंट्रोल किया जा सकता है. हार्डवेयर से तेज़ी लाने की सुविधा को चालू या बंद करने के लिए, अपने 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>

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

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

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