ব্যানার বিজ্ঞাপন

ব্যানার বিজ্ঞাপনগুলি একটি অ্যাপের লেআউটের মধ্যে, ডিভাইস স্ক্রিনের উপরে বা নীচে একটি স্থান দখল করে। ব্যবহারকারীরা অ্যাপের সাথে ইন্টারঅ্যাক্ট করার সময় এগুলি স্ক্রিনে থাকে এবং একটি নির্দিষ্ট সময়ের পরে স্বয়ংক্রিয়ভাবে রিফ্রেশ হতে পারে। আপনি যদি মোবাইল বিজ্ঞাপনে নতুন হন, তাহলে এগুলি শুরু করার জন্য একটি দুর্দান্ত জায়গা। কেস স্টাডি

পূর্বশর্ত

  • সম্পূর্ণ শুরু করুন
  • (শুধুমাত্র অ্যান্ড্রয়েড) JNI jobject রেফারেন্সের সাথে কাজ করার অভিজ্ঞতা ( Android JNI টিপস দেখুন)।

সর্বদা পরীক্ষামূলক বিজ্ঞাপন দিয়ে পরীক্ষা করুন

আপনার অ্যাপ তৈরি এবং পরীক্ষা করার সময়, লাইভ, প্রোডাকশন বিজ্ঞাপনের পরিবর্তে পরীক্ষামূলক বিজ্ঞাপন ব্যবহার করুন। এটি না করলে আপনার অ্যাকাউন্ট সাসপেন্ড হতে পারে।

পরীক্ষামূলক বিজ্ঞাপন লোড করার সবচেয়ে সহজ উপায় হল ব্যানারের জন্য আমাদের ডেডিকেটেড পরীক্ষামূলক বিজ্ঞাপন ইউনিট আইডি ব্যবহার করা, যা ডিভাইস প্ল্যাটফর্ম অনুসারে পরিবর্তিত হয়:

  • অ্যান্ড্রয়েড: 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. AdParent প্যারেন্ট ভিউ ব্যবহার করে একটি AdSize তৈরি করুন এবং বিজ্ঞাপন ভিউ ইনিশিয়ালাইজ করুন। প্যারেন্ট ভিউ হল একটি JNI jobject রেফারেন্স যা একটি Android Activity অথবা একটি 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<firebase::gma::AdParent>(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 এর সাথে কাজ করার বিষয়ে আরও তথ্যের জন্য, পদ্ধতি কলের সমাপ্তির অবস্থা পর্যবেক্ষণ করতে Futures ব্যবহার করুন দেখুন।

বিজ্ঞাপনের অবস্থান নির্ধারণ করুন

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();

বিজ্ঞাপন ইভেন্ট

গুগল মোবাইল বিজ্ঞাপন 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) বিবরণ উপস্থিতি ফায়ারবেস::জিএমএ::অ্যাডসাইজ ধ্রুবক
৩২০x৫০ ব্যানার ফোন এবং ট্যাবলেট kBanner
৩২০x১০০ বড় ব্যানার ফোন এবং ট্যাবলেট kLargeBanner
৩০০x২৫০ IAB মাঝারি আয়তক্ষেত্র ফোন এবং ট্যাবলেট kMediumRectangle
৪৬৮x৬০ IAB পূর্ণ-আকারের ব্যানার ট্যাবলেট kFullBanner
৭২৮x৯০ IAB লিডারবোর্ড ট্যাবলেট kLeaderboard
প্রদত্ত প্রস্থ x অভিযোজিত উচ্চতা অ্যাডাপ্টিভ ব্যানার ফোন এবং ট্যাবলেট নিষিদ্ধ

কাস্টম বিজ্ঞাপনের আকার

একটি কাস্টম ব্যানারের আকার নির্ধারণ করতে, firebase::gma::AdSize কনস্ট্রাক্টর ব্যবহার করে প্রস্থ এবং উচ্চতার প্যারামিটার ব্যবহার করে আপনার পছন্দসই মাত্রা সেট করুন, যেমনটি এখানে দেখানো হয়েছে:

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

অতিরিক্ত সম্পদ

GitHub-এ উদাহরণ

সাফল্যের গল্প