ব্যানার বিজ্ঞাপন অ্যাপের লেআউটের মধ্যে, ডিভাইসের স্ক্রিনের উপরে বা নিচে জায়গা নেয়। ব্যবহারকারী অ্যাপের সাথে ইন্টার্যাক্ট করার সময় এগুলি স্ক্রিনে থাকে এবং নির্দিষ্ট সময় অন্তর অটোমেটিক রিফ্রেশ হতে পারে। আপনি মোবাইল বিজ্ঞাপনে নতুন হলে, এগুলি শুরু করার জন্য একটি দুর্দান্ত জায়গা। কেস স্টাডি।
পূর্বশর্ত
- শুরু করুন বিকল্পে ক্লিক করুন।
- (শুধুমাত্র Android) JNI
jobjectরেফারেন্সের সাথে কাজ করার অভিজ্ঞতা (Android JNI সংক্রান্ত পরামর্শ দেখুন)।
সবসময় টেস্ট বিজ্ঞাপন দিয়ে পরীক্ষা করুন
আপনার অ্যাপ তৈরি ও পরীক্ষা করার সময়, লাইভ, প্রোডাকশন বিজ্ঞাপনের পরিবর্তে পরীক্ষামূলক বিজ্ঞাপন ব্যবহার করতে ভুলবেন না। এটি না করলে আপনার অ্যাকাউন্ট সাসপেন্ড করা হতে পারে।
টেস্ট বিজ্ঞাপন লোড করার সবচেয়ে সহজ উপায় হল ব্যানারের জন্য আমাদের নির্দিষ্ট টেস্ট বিজ্ঞাপন ইউনিট আইডি ব্যবহার করা, যা ডিভাইস প্ল্যাটফর্ম অনুযায়ী আলাদা হয়:
- Android:
ca-app-pub-3940256099942544/6300978111 - iOS:
ca-app-pub-3940256099942544/2934735716
এই বিজ্ঞাপন ইউনিট আইডিগুলি বিশেষভাবে কনফিগার করা হয়েছে যাতে প্রতিটি অনুরোধের জন্য টেস্ট বিজ্ঞাপন দেখানো যায়। কোডিং, টেস্টিং এবং ডিবাগিং করার সময় আপনি নিজের অ্যাপে এটি ব্যবহার করতে পারেন। আপনার অ্যাপ প্রকাশ করার আগে, আপনার নিজের বিজ্ঞাপন ইউনিট আইডি দিয়ে এটি পরিবর্তন করতে ভুলবেন না।
Mobile Ads SDK-এর টেস্ট বিজ্ঞাপন কীভাবে কাজ করে সেই সম্পর্কে আরও জানতে, টেস্ট বিজ্ঞাপন দেখুন।
প্রয়োগ
AdView কনফিগার করুন
ব্যানার বিজ্ঞাপন AdView অবজেক্টে দেখানো হয়, তাই ব্যানার বিজ্ঞাপন ইন্টিগ্রেট করার প্রথম ধাপ হল
AdView তৈরি করা ও সেটির পজিশন ঠিক করা।
আপনার অ্যাপের C++ কোডে নিম্নলিখিত হেডার যোগ করুন:
#include "firebase/gma/ad_view.h"
একটি
AdViewঅবজেক্ট ডিক্লেয়ার ও ইনস্ট্যান্টিয়েট করুন:firebase::gma::AdView* ad_view; ad_view = new firebase::gma::AdView();
AdSizeতৈরি করুন এবংAdParentপেরেন্ট ভিউ ব্যবহার করে বিজ্ঞাপন ভিউ শুরু করুন। প্যারেন্ট ভিউ হল AndroidActivity-এর JNIjobjectরেফারেন্স অথবা iOSUIView-এর পয়েন্টার যা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); As an alternative to retaining the future as a variable, you can periodically check the status of the initialization operation by invoking
InitializeLastResult()on theAdViewobject. আপনার গ্লোবাল গেম লুপে ইনিশিয়ালাইজেশন প্রসেস ট্র্যাক করার জন্য এটি সহায়ক হতে পারে।// 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. }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 মেথড ক্লাসের সবকটি
মেথডকে এক্সটেন্ড করে:
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 কনস্ট্যান্ট |
|---|---|---|---|
| ৩২০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-এ উদাহরণ
- GitHub-এ আমাদের উদাহরণ কুইকস্টার্ট অ্যাপের সোর্স কোড দেখুন।