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

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

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

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

• शुरू करें को पूरा करें.
• (सिर्फ़ Android के लिए) JNI jobject रेफ़रंस के साथ काम करने की जानकारी (Android JNI से जुड़ी सलाह देखें).

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

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

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

• 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. AdParent टाइप में कास्ट किए गए पैरंट व्यू का इस्तेमाल करके, InterstitialAd इंस्टेंस को शुरू करें. पैरंट व्यू, 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 के साथ काम करने के बारे में ज़्यादा जानकारी के लिए, मेथड कॉल के पूरा होने की स्थिति को मॉनिटर करने के लिए, Futures का इस्तेमाल करना लेख पढ़ें.

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

विज्ञापन लोड करने के लिए, 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 पर उदाहरण

• GitHub में, हमारे उदाहरण के तौर पर दिए गए क्विकस्टार्ट ऐप्लिकेशन का सोर्स कोड देखें.

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

• इंटरस्टीशियल विज्ञापन दिखाने के सबसे सही तरीके

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

• इस्तेमाल के उदाहरण का सैंपल

अगले चरण

• अगर आपने अब तक AdMob के यूज़र इंटरफ़ेस (यूआई) में अपनी इंटरस्टीशियल विज्ञापन यूनिट नहीं बनाई है, तो उसे बनाएं.
• विज्ञापन टारगेटिंग और इंटरस्टीशियल विज्ञापन के दिशा-निर्देशों के बारे में जानें.