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


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

इस गाइड में, 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 के वीडियो ट्यूटोरियल

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

अगले चरण