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

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

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

  • शुरू करें को पूरा करें.
  • (सिर्फ़ Android के लिए) जेएनआई 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 का JNI 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 में उदाहरण

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