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

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

পূর্বশর্ত

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

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

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

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

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

Mobile Ads 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 প্যারেন্ট ভিউ ব্যবহার করে বিজ্ঞাপন ভিউ ইনিশিয়ালাইজ করুন। প্যারেন্ট ভিউ হল 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();

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

Google Mobile Ads C++ SDK এমন একটি AdListener ক্লাস প্রদান করে যা আপনি এক্সটেন্ড করতে পারেন এবং বিজ্ঞাপন ভিউয়ের স্ট্যাটাসে হওয়া পরিবর্তন সম্পর্কে বিজ্ঞপ্তি পেতে AdView::SetListener()-এ পাস করতে পারেন।

AdListener-এ পদ্ধতি এক্সটেন্ড করা ঐচ্ছিক, তাই আপনি শুধুমাত্র সেইসব পদ্ধতি প্রয়োগ করতে পারেন যেগুলি আপনি চান। নিচে এমন একটি ক্লাসের প্রয়োগের উদাহরণ দেওয়া হল যা AdListener methods class-এর সবকটি এক্সটেন্ড করে:

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

নিচের সারণীতে স্ট্যান্ডার্ড ব্যানার সাইজের তালিকা দেওয়া হল।

পয়েন্টে সাইজ (দৈর্ঘ্য x প্রস্থ) বিবরণ উপলভ্যতা firebase::gma::AdSize কনস্ট্যান্ট
৩২০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-এ উদাহরণ

সাফল্যের কাহিনী