मध्यवर्ती विज्ञापन


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

इस गाइड में, Google Mobile Ads C++ SDK का इस्तेमाल करके, Android और iOS ऐप्लिकेशन में इंटरस्टीशियल विज्ञापन इंटिग्रेट करने का तरीका बताया गया है.

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

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

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

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

  • Android: ca-app-pub-3940256099942544/1033173712
  • iOS: ca-app-pub-3940256099942544/4411468910

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

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

लागू करना

इंटरस्टीशियल विज्ञापन इंटिग्रेट करने के लिए, ये मुख्य चरण पूरे करें:

  1. विज्ञापन लोड करना.
  2. कॉलबैक के लिए रजिस्टर करना.
  3. विज्ञापन दिखाना और उसके लाइफ़साइकल इवेंट मैनेज करना.

InterstitialAd कॉन्फ़िगर करना

इंटरस्टीशियल विज्ञापन, InterstitialAd ऑब्जेक्ट में दिखाए जाते हैं. इसलिए, अपने ऐप्लिकेशन में इंटरस्टीशियल विज्ञापन इंटिग्रेट करने के लिए, पहला चरण InterstitialAd ऑब्जेक्ट बनाना और उसे शुरू करना है.

  1. अपने ऐप्लिकेशन के C++ कोड में, यह हेडर जोड़ें: 

     #include "firebase/gma/interstial_ad.h"

  2. InterstitialAd ऑब्जेक्ट का एलान करें और उसे इंस्टैंशिएट करें: 

     firebase::gma::InterstitialAd* interstitial_ad;
 interstitial_ad = new firebase::gma::InterstitialAd();

  3. InterstitialAd इंस्टेंस को शुरू करने के लिए, AdParent टाइप में कास्ट किए गए अपने पैरंट व्यू का इस्तेमाल करें. पैरंट व्यू, Android Activity के लिए JNI jobject रेफ़रंस या iOS UIView के लिए पॉइंटर होता है.

    // my_ad_parent is a jobject reference to an Android Activity or
// a pointer to an iOS UIView.
firebase::gma::AdParent ad_parent =
  static_cast<firebase::gma::AdParent>(my_ad_parent);
firebase::Future<void> result = interstitial_ad->Initialize(ad_parent);

  4. फ़्यूचर को वैरिएबल के तौर पर बनाए रखने के बजाय, InterstitialAd ऑब्जेक्ट पर InitializeLastResult() को लागू करके, समय-समय पर शुरू करने की कार्रवाई की स्थिति देखी जा सकती है. यह आपके ग्लोबल गेम लूप में, शुरू करने की प्रोसेस पर नज़र रखने में मददगार हो सकता है.

    // Monitor the status of the future in your game loop:
firebase::Future<void> result = interstitial_ad->InitializeLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  // Initialization completed.
  if(future.error() == firebase::gma::kAdErrorCodeNone) {
    // Initialization successful.
  } else {
    // An error has occurred.
  }
} else {
  // Initialization on-going.
}

firebase::Future के साथ काम करने के बारे में ज़्यादा जानने के लिए, मेथड कॉल की पूरी होने की स्थिति पर नज़र रखने के लिए, फ़्यूचर का इस्तेमाल करना लेख पढ़ें.

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

विज्ञापन लोड करने के लिए, InterstitialAd ऑब्जेक्ट पर LoadAd() तरीके का इस्तेमाल किया जाता है. लोड करने के तरीके के लिए, यह ज़रूरी है कि आपने InterstitialAd ऑब्जेक्ट को शुरू किया हो. साथ ही, आपके पास अपना विज्ञापन यूनिट का आईडी और AdRequest ऑब्जेक्ट हो. firebase::Future वापस किया जाता है. इसका इस्तेमाल, लोड करने की कार्रवाई की स्थिति और नतीजे पर नज़र रखने के लिए किया जा सकता है.

नीचे दिया गया कोड दिखाता है कि InterstitialAd के सही तरीके से शुरू होने के बाद, विज्ञापन को कैसे लोड किया जाता है:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = interstitial_ad->LoadAd(interstitial_ad_unit_id, ad_request);

कॉलबैक के लिए रजिस्टर करना

इंटरस्टीशियल विज्ञापन दिखाने और उसके लाइफ़साइकल इवेंट की सूचनाएं पाने के लिए, आपको FullScreenContentListener क्लास को बढ़ाना होगा. आपके कस्टम FullScreenContentListener सबक्लास को InterstitialAd::SetFullScreenContentListener() तरीके से रजिस्टर किया जा सकता है. साथ ही, विज्ञापन के सही तरीके से या सही तरीके से नहीं दिखने पर, साथ ही उसे खारिज किए जाने पर, इसे कॉलबैक मिलेंगे.

नीचे दिया गया कोड दिखाता है कि क्लास को कैसे बढ़ाया जाता है और उसे विज्ञापन के लिए कैसे असाइन किया जाता है:

  class ExampleFullScreenContentListener
      : public firebase::gma::FullScreenContentListener {

   public:
    ExampleFullScreenContentListener() {}

    void OnAdClicked() override {
      // This method is invoked when the user clicks the ad.
    }

    void OnAdDismissedFullScreenContent() override {
     // This method is invoked when the ad dismisses full screen content.
    }

    void OnAdFailedToShowFullScreenContent(const AdError& error) override {
      // This method is invoked when the ad failed to show full screen content.
      // Details about the error are contained within the AdError parameter.
    }

    void OnAdImpression() override {
      // This method is invoked when an impression is recorded for an ad.
    }

    void OnAdShowedFullScreenContent() override {
      // This method is invoked when the ad showed its full screen content.
    }
  };

  ExampleFullScreenContentListener* full_screen_content_listener =
    new ExampleFullScreenContentListener();
  interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);

InterstitialAd, एक बार इस्तेमाल किया जाने वाला ऑब्जेक्ट है. इसका मतलब है कि इंटरस्टीशियल विज्ञापन दिखाए जाने के बाद, उसे फिर से नहीं दिखाया जा सकता. सबसे सही तरीका यह है कि अपने FullScreenContentListener के OnAdDismissedFullScreenContent() तरीके में, दूसरा इंटरस्टीशियल विज्ञापन लोड किया जाए. इससे, पिछला इंटरस्टीशियल विज्ञापन खारिज होने के तुरंत बाद, अगला इंटरस्टीशियल विज्ञापन लोड होना शुरू हो जाएगा.

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

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

  firebase::Future<void> result = interstitial_ad->Show();

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

इस बारे में सोचें कि इंटरस्टीशियल विज्ञापन, आपके ऐप्लिकेशन के लिए सही तरह के विज्ञापन हैं या नहीं.
इंटरस्टीशियल विज्ञापन, उन ऐप्लिकेशन में सबसे अच्छा काम करते हैं जिनमें नैचुरल ट्रांज़िशन पॉइंट होते हैं. किसी ऐप्लिकेशन में किसी टास्क के पूरा होने पर, जैसे कि कोई इमेज शेयर करने या गेम का कोई लेवल पूरा करने पर, ऐसा पॉइंट बनता है. उपयोगकर्ता को कार्रवाई में ब्रेक मिलने की उम्मीद होती है. इसलिए, उसके अनुभव में रुकावट डाले बिना, इंटरस्टीशियल विज्ञापन दिखाना आसान होता है. पक्का करें कि आपने इस बारे में सोचा हो कि अपने ऐप्लिकेशन के वर्कफ़्लो में किन पॉइंट पर इंटरस्टीशियल विज्ञापन दिखाए जाएंगे और उपयोगकर्ता की प्रतिक्रिया कैसी होगी.
इंटरस्टीशियल विज्ञापन दिखाते समय, कार्रवाई को रोकना न भूलें.
इंटरस्टीशियल विज्ञापन कई तरह के होते हैं: टेक्स्ट, इमेज, वीडियो वगैरह. यह पक्का करना ज़रूरी है कि जब आपका ऐप्लिकेशन इंटरस्टीशियल विज्ञापन दिखाए, तो वह कुछ संसाधनों का इस्तेमाल भी बंद कर दे, ताकि विज्ञापन उनका फ़ायदा उठा सके. उदाहरण के लिए, इंटरस्टीशियल विज्ञापन दिखाने के लिए कॉल करते समय, पक्का करें कि आपके ऐप्लिकेशन से जनरेट होने वाले किसी भी ऑडियो आउटपुट को रोक दिया जाए. इंस्टॉल किए गए FullScreenContentListener के OnAdDismissedFullScreenContent तरीके में, आवाज़ें फिर से चलाई जा सकती हैं. यह तरीका तब लागू होगा, जब उपयोगकर्ता विज्ञापन के साथ इंटरैक्ट कर चुका होगा. इसके अलावा, विज्ञापन दिखाए जाने के दौरान, ज़्यादा कंप्यूटेशन वाले किसी भी टास्क (जैसे, गेम लूप) को अस्थायी तौर पर रोकने पर विचार करें. इससे यह पक्का होगा कि उपयोगकर्ता को धीमी या रिस्पॉन्स न देने वाली ग्राफ़िक्स या रुक-रुक कर चलने वाले वीडियो का अनुभव न मिले.
लोड होने में लगने वाले समय के लिए, ज़रूरत के मुताबिक समय दें.
यह पक्का करना जितना ज़रूरी है कि इंटरस्टीशियल विज्ञापन सही समय पर दिखाए जाएं, उतना ही यह पक्का करना भी ज़रूरी है कि उपयोगकर्ता को उनके लोड होने का इंतज़ार न करना पड़े. विज्ञापन दिखाने से पहले उसे लोड करने से यह पक्का किया जा सकता है कि जब विज्ञापन दिखाने का समय आए, तो आपका ऐप्लिकेशन पूरी तरह से लोड किए गए इंटरस्टीशियल विज्ञापन को दिखाने के लिए तैयार हो.
उपयोगकर्ता को बहुत ज़्यादा विज्ञापन न दिखाएं.
आपके ऐप्लिकेशन में इंटरस्टीशियल विज्ञापनों की फ़्रीक्वेंसी बढ़ाने से, रेवेन्यू में बढ़ोतरी हो सकती है. हालांकि, इससे उपयोगकर्ता अनुभव खराब हो सकता है और क्लिक थ्रू रेट कम हो सकते हैं. पक्का करें कि उपयोगकर्ताओं को इतनी बार रुकावट न हो कि वे आपके ऐप्लिकेशन का इस्तेमाल न कर पाएं.
इंटरस्टीशियल विज्ञापन दिखाने के लिए, लोड पूरा होने के फ़्यूचर का इस्तेमाल न करें.
इससे उपयोगकर्ता अनुभव खराब हो सकता है. इसके बजाय, विज्ञापन दिखाने से पहले उसे प्री-लोड करें.

अन्य संसाधन

GitHub में उदाहरण

Mobile Ads Garage के वीडियो ट्यूटोरियल

सफलता की कहानियां

अगले चरण