बैनर विज्ञापन

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

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

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

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

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

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

  • Android: ca-app-pub-3940256099942544/6300978111
  • iOS: ca-app-pub-3940256099942544/2934735716

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

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

कार्यान्वयन

AdView को कॉन्फ़िगर करना

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

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

     #include "firebase/gma/ad_view.h"

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

      firebase::gma::AdView* ad_view;
  ad_view = new firebase::gma::AdView();

  3. AdSize बनाएं और AdParent पैरंट व्यू का इस्तेमाल करके, विज्ञापन व्यू शुरू करें. पैरंट व्यू, Android Activity का जेएनआई jobject रेफ़रंस है या iOS UIView के लिए, AdParent टाइप के कास्ट का पॉइंटर है:

     // 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(my_ad_parent);
 firebase::Future result =
   ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);

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

      // Monitor the status of the future in your game loop:
  firebase::Future<void> result = ad_view->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.
  }

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

विज्ञापन की पोज़िशन सेट करना

शुरू करने के बाद, कभी भी AdView की जगह सेट की जा सकती है:

firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);

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

AdView शुरू होने के बाद, कोई विज्ञापन लोड किया जा सकता है:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);

AdRequest ऑब्जेक्ट सिर्फ़ एक विज्ञापन अनुरोध को दिखाते हैं. इनमें टारगेटिंग जैसी जानकारी देने के लिए, प्रॉपर्टी शामिल होती हैं.

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

आखिर में, Show() को कॉल करके स्क्रीन पर विज्ञापन दिखाएं. विज्ञापन शुरू होने के बाद किसी भी समय इस तरीके का इस्तेमाल किया जा सकता है:

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

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

Google Mobile Ads C++ SDK टूल एक AdListener क्लास देता है. इसे बढ़ाया जा सकता है और विज्ञापन व्यू की स्थिति में होने वाले बदलावों की सूचना पाने के लिए, AdView::SetListener() को पास किया जा सकता है.

AdListener में अलग-अलग तरीकों का इस्तेमाल करना ज़रूरी नहीं है. इसलिए, आपको सिर्फ़ अपने हिसाब से तरीके लागू करने होंगे. नीचे एक क्लास को लागू करने का उदाहरण दिया गया है, जो AdListener के सभी मेथड क्लास को बढ़ाता है:

class ExampleAdListener
    : public firebase::gma::AdListener {
 public:
  ExampleAdListener() {}
  void OnAdClicked() override {
    // This method is invoked when the user clicks the ad.
  }

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

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

  void OnAdOpened() override {
    // This method is invoked when an ad opens an overlay that covers the screen.
  }
};

ExampleAdListener* ad_listener = new ExampleAdListener();
ad_view->SetAdListener(ad_listener);

नीचे दी गई टेबल में, बैनर के स्टैंडर्ड साइज़ दिए गए हैं.

पॉइंट में साइज़ (WxH) कंपनी का ब्यौरा उपलब्धता firebase::gma::AdSize कॉन्सटेंट
320x50 बैनर फ़ोन और टेबलेट kBanner
320x100 बड़ा बैनर फ़ोन और टेबलेट kLargeBanner
300x250 IAB मीडियम रेक्टैंगल फ़ोन और टेबलेट kMediumRectangle
468x60 IAB के फ़ुल-साइज़ बैनर टैबलेट kFullBanner
728x90 IAB लीडरबोर्ड टैबलेट kLeaderboard
दी गई चौड़ाई x ज़रूरत के हिसाब से ऊंचाई अडैप्टिव बैनर फ़ोन और टेबलेट लागू नहीं

कस्टम विज्ञापन आकार

कस्टम बैनर का साइज़ तय करने के लिए, firebase::gma::AdSize कंस्ट्रक्टर के साथ चौड़ाई और ऊंचाई पैरामीटर का इस्तेमाल करके, अपने हिसाब से डाइमेंशन सेट करें, जैसा कि यहां दिखाया गया है:

firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);

अन्य संसाधन

GitHub में उदाहरण

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