এই নির্দেশিকায় একটি iOS অ্যাপে অ্যাঙ্করড অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপন লোড করার পদ্ধতি আলোচনা করা হয়েছে।
পূর্বশর্ত
চালিয়ে যাওয়ার আগে, Google Mobile Ads SDK সেট আপ করুন ।
সর্বদা টেস্ট অ্যাড দিয়ে পরীক্ষা করুন
আপনার অ্যাপ তৈরি ও পরীক্ষা করার সময়, লাইভ বা প্রোডাকশন অ্যাডের পরিবর্তে টেস্ট অ্যাড ব্যবহার করুন। এটি করতে ব্যর্থ হলে আপনার অ্যাকাউন্ট সাসপেন্ড হতে পারে।
টেস্ট অ্যাড লোড করার সবচেয়ে সহজ উপায় হলো iOS ব্যানারের জন্য আমাদের নির্দিষ্ট টেস্ট অ্যাড ইউনিট আইডি ব্যবহার করা:
/21775744923/example/adaptive-banner
প্রতিটি অনুরোধের জন্য পরীক্ষামূলক বিজ্ঞাপন দেখানোর জন্য এটি বিশেষভাবে কনফিগার করা হয়েছে, এবং কোডিং, টেস্টিং ও ডিবাগিং করার সময় আপনি আপনার নিজের অ্যাপে এটি নির্দ্বিধায় ব্যবহার করতে পারেন। শুধু আপনার অ্যাপটি প্রকাশ করার আগে নিশ্চিত হয়ে নেবেন যে আপনি এটিকে আপনার নিজের অ্যাড ইউনিট আইডি দিয়ে প্রতিস্থাপন করেছেন।
Google Mobile Ads SDK টেস্ট অ্যাডগুলো কীভাবে কাজ করে সে সম্পর্কে আরও তথ্যের জন্য, টেস্ট অ্যাডস দেখুন।
একটি GAMBannerView তৈরি করুন
ব্যানার বিজ্ঞাপন GAMBannerView অবজেক্টে প্রদর্শিত হয়, তাই ব্যানার বিজ্ঞাপন সংহত করার প্রথম ধাপ হলো আপনার ভিউ হায়ারার্কিতে একটি GAMBannerView অন্তর্ভুক্ত করা। এটি সাধারণত প্রোগ্রাম্যাটিকভাবে অথবা ইন্টারফেস বিল্ডারের মাধ্যমে করা হয়ে থাকে।
প্রোগ্রামগতভাবে
একটি GAMBannerView সরাসরি ইনস্ট্যানশিয়েটও করা যায়। নিচের উদাহরণটি একটি GAMBannerView তৈরি করে:
সুইফট
// Initialize the banner view.
bannerView = AdManagerBannerView()
bannerView.delegate = self
bannerView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(bannerView)
// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
NSLayoutConstraint.activate([
// Align the banner's bottom edge with the safe area's bottom edge
bannerView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
// Center the banner horizontally in the view
bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
])
SwiftUI
AdManagerBannerView ব্যবহার করতে, একটি UIViewRepresentable তৈরি করুন:
private struct BannerViewContainer: UIViewRepresentable {
typealias UIViewType = BannerView
let adSize: AdSize
init(_ adSize: AdSize) {
self.adSize = adSize
}
func makeUIView(context: Context) -> BannerView {
let banner = BannerView(adSize: adSize)
banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())
banner.delegate = context.coordinator
return banner
}
func updateUIView(_ uiView: BannerView, context: Context) {}
func makeCoordinator() -> BannerCoordinator {
return BannerCoordinator(self)
}
আপনার UIViewRepresentable ভিউ হায়ারার্কিতে যুক্ত করুন এবং height ও width মান নির্দিষ্ট করে দিন:
var body: some View {
Spacer()
// Request an anchored adaptive banner with a width of 375.
let adSize = largeAnchoredAdaptiveBanner(width: 375)
BannerViewContainer(adSize)
.frame(width: adSize.size.width, height: adSize.size.height)
}
উদ্দেশ্য-সি
// Initialize the banner view.
GAMBannerView *bannerView = [[GAMBannerView alloc] init];
bannerView.delegate = self;
UIView *view = self.view;
bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[view addSubview:bannerView];
// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
[NSLayoutConstraint activateConstraints:@[
// Align the banner's bottom edge with the safe area's bottom edge
[bannerView.bottomAnchor
constraintEqualToAnchor:view.safeAreaLayoutGuide.bottomAnchor],
// Center the banner horizontally in the view
[bannerView.centerXAnchor constraintEqualToAnchor:view.centerXAnchor],
]];
self.bannerView = bannerView;
ইন্টারফেস বিল্ডার
আপনি একটি স্টোরিবোর্ড বা xib ফাইলে একটি GAMBannerView যোগ করতে পারেন। এই পদ্ধতি ব্যবহার করার সময়, খেয়াল রাখবেন যেন শুধুমাত্র ব্যানারের উপরেই পজিশন কনস্ট্রেইন্ট যোগ করা হয়। উদাহরণস্বরূপ, স্ক্রিনের নীচে একটি অ্যাডাপ্টিভ ব্যানার প্রদর্শন করার সময়, ব্যানার ভিউ-এর বটম-কে বটম লেআউট গাইডের টপ-এর সমান সেট করুন এবং centerX কনস্ট্রেইন্টটিকে সুপারভিউ-এর centerX এর সমান সেট করুন।
বিজ্ঞাপনের আকার নির্ধারণ করুন
নিম্নলিখিত উদাহরণটি একটি বড় অ্যাঙ্করযুক্ত অভিযোজিত ব্যানারের আকার পায়:
সুইফট
// Request a large anchored adaptive banner with a width of 375.
bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)
উদ্দেশ্য-সি
// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);
একটি বিজ্ঞাপন লোড করুন
GAMBannerView যথাস্থানে বসানো হয়ে গেলে এবং adUnitID এর মতো এর প্রোপার্টিগুলো কনফিগার করা হয়ে গেলে, একটি বিজ্ঞাপন লোড করার পালা আসে। এটি করার জন্য একটি GAMRequest অবজেক্টের উপর loadRequest: কল করতে হয়।
সুইফট
func loadBannerAd(bannerView: AdManagerBannerView) {
// Request a large anchored adaptive banner with a width of 375.
bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)
bannerView.load(AdManagerRequest())
}
SwiftUI
banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())
উদ্দেশ্য-সি
// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);
[self.bannerView loadRequest:[GAMRequest request]];
GAMRequest অবজেক্টগুলো একটি একক বিজ্ঞাপন অনুরোধের প্রতিনিধিত্ব করে এবং এতে টার্গেটিং তথ্যের মতো বিষয়গুলোর জন্য প্রোপার্টি থাকে।
একটি বিজ্ঞাপন রিফ্রেশ করুন
আপনি যদি আপনার অ্যাড ইউনিট রিফ্রেশ করার জন্য কনফিগার করে থাকেন, তাহলে বিজ্ঞাপনটি লোড হতে ব্যর্থ হলে আপনাকে অন্য কোনো বিজ্ঞাপনের জন্য অনুরোধ করতে হবে না। Google Mobile Ads SDK Ad Manager UI-তে আপনার নির্দিষ্ট করা যেকোনো রিফ্রেশ রেট মেনে চলে। আপনি যদি রিফ্রেশ চালু না করে থাকেন, তাহলে একটি নতুন অনুরোধ পাঠান। অ্যাড ইউনিট রিফ্রেশ সম্পর্কে আরও বিস্তারিত জানতে, যেমন রিফ্রেশ রেট সেট করার বিষয়ে, “মোবাইল অ্যাপে বিজ্ঞাপনের জন্য রিফ্রেশ রেট” দেখুন।
অভিমুখ পরিবর্তন পরিচালনা করুন
যখন আপনার অ্যাপের স্ক্রিন ওরিয়েন্টেশন পরিবর্তিত হয়, যেমন portrait মোড থেকে ল্যান্ডস্কেপে, তখন ব্যানারের জন্য উপলব্ধ প্রস্থও প্রায়শই পরিবর্তিত হয়। নতুন লেআউটের জন্য একটি উপযুক্ত আকারের বিজ্ঞাপন প্রদর্শন নিশ্চিত করতে, একটি নতুন ব্যানারের জন্য অনুরোধ করুন। যদি আপনার ব্যানারের প্রস্থ স্থির থাকে, অথবা যদি আপনার লেআউটের সীমাবদ্ধতাগুলো এই আকার পরিবর্তন সামলাতে পারে, তবে এই ধাপটি এড়িয়ে যান।
সুইফট
override func viewWillTransition(
to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator
) {
coordinator.animate(alongsideTransition: { _ in
// Load a new ad for the new orientation.
})
}
উদ্দেশ্য-সি
- (void)viewWillTransitionToSize:(CGSize)size
withTransitionCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator {
[coordinator animateAlongsideTransition:^(id<UIViewControllerTransitionCoordinatorContext> context) {
// Load a new ad for the new orientation.
} completion:nil];
}
বিজ্ঞাপন ইভেন্ট
GADBannerViewDelegate ব্যবহারের মাধ্যমে, আপনি লাইফসাইকেল ইভেন্টগুলো শুনতে পারেন, যেমন যখন কোনো বিজ্ঞাপন বন্ধ করা হয় বা ব্যবহারকারী অ্যাপটি ছেড়ে চলে যায়।
ব্যানার ইভেন্টের জন্য নিবন্ধন করুন
ব্যানার বিজ্ঞাপন ইভেন্টের জন্য নিবন্ধন করতে, GAMBannerView এর delegate প্রপার্টিটি এমন একটি অবজেক্টে সেট করুন যা GADBannerViewDelegate প্রোটোকলটি ইমপ্লিমেন্ট করে। সাধারণত, যে ক্লাসটি ব্যানার বিজ্ঞাপন ইমপ্লিমেন্ট করে, সেটিই ডেলিগেট ক্লাস হিসেবেও কাজ করে, সেক্ষেত্রে delegate প্রপার্টিটি self এ সেট করা যেতে পারে।
সুইফট
bannerView.delegate = self
SwiftUI
banner.delegate = context.coordinator
উদ্দেশ্য-সি
bannerView.delegate = self;
ব্যানার ইভেন্ট বাস্তবায়ন করুন
GADBannerViewDelegate এর প্রতিটি মেথডকে ঐচ্ছিক হিসেবে চিহ্নিত করা হয়েছে, তাই আপনাকে শুধু আপনার পছন্দের মেথডগুলোই ইমপ্লিমেন্ট করতে হবে। এই উদাহরণটি প্রতিটি মেথড ইমপ্লিমেন্ট করে এবং কনসোলে একটি বার্তা লগ করে:
সুইফট
func bannerViewDidReceiveAd(_ bannerView: BannerView) {
print("Banner ad loaded.")
}
func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
print("Banner ad failed to load: \(error.localizedDescription)")
}
func bannerViewDidRecordImpression(_ bannerView: BannerView) {
print("Banner ad recorded an impression.")
}
func bannerViewDidRecordClick(_ bannerView: BannerView) {
print("Banner ad recorded a click.")
}
func bannerViewWillPresentScreen(_ bannerView: BannerView) {
print("Banner ad will present screen.")
}
func bannerViewWillDismissScreen(_ bannerView: BannerView) {
print("Banner ad will dismiss screen.")
}
func bannerViewDidDismissScreen(_ bannerView: BannerView) {
print("Banner ad did dismiss screen.")
}
উদ্দেশ্য-সি
- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
NSLog(@"bannerViewDidReceiveAd");
}
- (void)bannerView:(GAMBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
NSLog(@"bannerView:didFailToReceiveAdWithError: %@", error.localizedDescription);
}
- (void)bannerViewDidRecordImpression:(GAMBannerView *)bannerView {
NSLog(@"bannerViewDidRecordImpression");
}
- (void)bannerViewWillPresentScreen:(GAMBannerView *)bannerView {
NSLog(@"bannerViewWillPresentScreen");
}
- (void)bannerViewWillDismissScreen:(GAMBannerView *)bannerView {
NSLog(@"bannerViewWillDismissScreen");
}
- (void)bannerViewDidDismissScreen:(GAMBannerView *)bannerView {
NSLog(@"bannerViewDidDismissScreen");
}
iOS API ডেমো অ্যাপে ব্যানার ডেলিগেট মেথডগুলোর বাস্তবায়ন দেখতে অ্যাড ডেলিগেট উদাহরণটি দেখুন।
ব্যবহারের ক্ষেত্র
এই অ্যাড ইভেন্ট মেথডগুলোর কিছু ব্যবহারের উদাহরণ নিচে দেওয়া হলো।
বিজ্ঞাপন পাওয়া গেলে ভিউ হায়ারার্কিতে একটি ব্যানার যুক্ত করুন।
আপনি হয়তো একটি বিজ্ঞাপন পাওয়ার পর পর্যন্ত ভিউ হায়ারার্কিতে একটি GAMBannerView যোগ করা বিলম্বিত করতে চাইতে পারেন। আপনি bannerViewDidReceiveAd: ইভেন্টটি লিসেন করার মাধ্যমে এটি করতে পারেন:
সুইফট
func bannerViewDidReceiveAd(_ bannerView: BannerView) {
// Add banner to view and add constraints.
addBannerViewToView(bannerView)
}
উদ্দেশ্য-সি
- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
// Add bannerView to view and add constraints as above.
[self addBannerViewToView:self.bannerView];
}
একটি ব্যানার বিজ্ঞাপন অ্যানিমেট করুন
নিচের উদাহরণে দেখানো হয়েছে, ব্যানার অ্যাডটি রিটার্ন হওয়ার পর সেটিকে অ্যানিমেট করার জন্য আপনি bannerViewDidReceiveAd: ইভেন্টটিও ব্যবহার করতে পারেন:
সুইফট
func bannerViewDidReceiveAd(_ bannerView: BannerView) {
bannerView.alpha = 0
UIView.animate(withDuration: 1, animations: {
bannerView.alpha = 1
})
}
উদ্দেশ্য-সি
- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
bannerView.alpha = 0;
[UIView animateWithDuration:1.0 animations:^{
bannerView.alpha = 1;
}];
}
অ্যাপটি থামান এবং আবার চালু করুন।
GADBannerViewDelegate প্রোটোকলে বিভিন্ন ইভেন্ট সম্পর্কে আপনাকে অবহিত করার জন্য মেথড রয়েছে, যেমন যখন কোনো ক্লিকের ফলে একটি ওভারলে প্রদর্শিত বা অদৃশ্য হয়। এই ইভেন্টগুলো বিজ্ঞাপনের কারণে ঘটেছে কিনা তা যদি আপনি ট্রেস করতে চান, তাহলে এই GADBannerViewDelegate মেথডগুলোর জন্য রেজিস্টার করুন।
শুধু বিজ্ঞাপনে ক্লিকের ফলে আসা বিষয়গুলোই নয়, বরং সব ধরনের ওভারলে প্রেজেন্টেশন বা এক্সটার্নাল ব্রাউজার ইনভোকেশন ধরার জন্য আপনার অ্যাপের UIViewController বা UIApplication এর সমতুল্য মেথডগুলো লিসেন করা ভালো। নিচে একটি টেবিল দেওয়া হলো যেখানে GADBannerViewDelegate মেথডগুলোর সাথে একই সময়ে কল হওয়া সমতুল্য iOS মেথডগুলো দেখানো হয়েছে:
| GADBannerViewDelegate পদ্ধতি | আইওএস পদ্ধতি |
|---|---|
bannerViewWillPresentScreen: | UIViewController-এর viewWillDisappear: |
bannerViewWillDismissScreen: | UIViewController-এর viewWillAppear: |
bannerViewDidDismissScreen: | UIViewController-এর viewDidAppear: |
ম্যানুয়াল ইমপ্রেশন গণনা
ইম্প্রেশন কখন রেকর্ড করা হবে সে সম্পর্কে আপনার বিশেষ শর্ত থাকলে, আপনি অ্যাড ম্যানেজারে ম্যানুয়ালি ইম্প্রেশন পিং পাঠাতে পারেন। এটি করার জন্য, প্রথমে একটি বিজ্ঞাপন লোড করার আগে ম্যানুয়াল ইম্প্রেশনের জন্য একটি GAMBannerView সক্রিয় করতে হবে:
সুইফট
bannerView.enableManualImpressions = true
উদ্দেশ্য-সি
self.bannerView.enableManualImpressions = YES;
যখন আপনি নিশ্চিত হন যে একটি বিজ্ঞাপন সফলভাবে প্রদর্শিত হয়েছে এবং স্ক্রিনে রয়েছে, তখন আপনি ম্যানুয়ালি একটি ইম্প্রেশন চালু করতে পারেন:
সুইফট
bannerView.recordImpression()
উদ্দেশ্য-সি
[self.bannerView recordImpression];
অ্যাপ ইভেন্ট
আপনি GADAppEventDelegate ব্যবহার করে অ্যাড ম্যানেজার-নির্দিষ্ট অ্যাপ ইভেন্টগুলো শুনতে পারেন। এই ইভেন্টগুলো বিজ্ঞাপনের জীবনচক্রের যেকোনো সময়ে ঘটতে পারে, এমনকি GADBannerViewDelegate অবজেক্টের bannerViewDidReceiveAd: কল হওয়ার আগেও।
অ্যাপ ইভেন্টগুলিতে রেজিস্টার করার জন্য, GAMBannerView এর delegate প্রপার্টিটি এমন একটি অবজেক্টে সেট করুন যা GADAppEventDelegate প্রোটোকলটি ইমপ্লিমেন্ট করে। সাধারণত, যে ক্লাসটি ব্যানার অ্যাড ইমপ্লিমেন্ট করে, সেটিই ডেলিগেট ক্লাস হিসেবেও কাজ করে, সেক্ষেত্রে delegate প্রপার্টিটি self এ সেট করা যেতে পারে।
সুইফট
// Set this property before making the request for an ad.
bannerView.appEventDelegate = self
উদ্দেশ্য-সি
// Set this property before making the request for an ad.
self.bannerView.appEventDelegate = self;
অ্যাপ ইভেন্ট থেকে রঙ নির্দিষ্ট করে কীভাবে আপনার অ্যাপের ব্যাকগ্রাউন্ড রঙ পরিবর্তন করতে হয়, তার একটি উদাহরণ এখানে দেওয়া হলো:
সুইফট
func bannerView(
_ banner: AdManagerBannerView, didReceiveAppEvent name: String, withInfo info: String?
) {
if name == "color" {
if info == "green" {
// Set background color to green.
view.backgroundColor = UIColor.green
} else if info == "blue" {
// Set background color to blue.
view.backgroundColor = UIColor.blue
} else {
// Set background color to black.
view.backgroundColor = UIColor.black
}
}
}
উদ্দেশ্য-সি
- (void)bannerView:(GAMBannerView *)banner
didReceiveAppEvent:(NSString *)name
withInfo:(NSString *)info {
if ([name isEqual:@"color"]) {
if ([info isEqual:@"green"]) {
// Set background color to green.
self.view.backgroundColor = [UIColor greenColor];
} else if ([info isEqual:@"blue"]) {
// Set background color to blue.
self.view.backgroundColor = [UIColor blueColor];
} else {
// Set background color to black.
self.view.backgroundColor = [UIColor blackColor];
}
}
}
এবং, এখানে সংশ্লিষ্ট ক্রিয়েটিভটি রয়েছে যা appEventDelegate এ রঙিন অ্যাপ ইভেন্ট বার্তা পাঠায়:
<html>
<head>
<script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
<script>
document.addEventListener("DOMContentLoaded", function() {
// Send a color=green event when ad loads.
admob.events.dispatchAppEvent("color", "green");
document.getElementById("ad").addEventListener("click", function() {
// Send a color=blue event when ad is clicked.
admob.events.dispatchAppEvent("color", "blue");
});
});
</script>
<style>
#ad {
width: 320px;
height: 50px;
top: 0px;
left: 0px;
font-size: 24pt;
font-weight: bold;
position: absolute;
background: black;
color: white;
text-align: center;
}
</style>
</head>
<body>
<div id="ad">Carpe diem!</div>
</body>
</html>
iOS API ডেমো অ্যাপে অ্যাপ ইভেন্টের বাস্তবায়ন দেখতে অ্যাড ম্যানেজার অ্যাপ ইভেন্টস উদাহরণটি দেখুন।
অতিরিক্ত সম্পদ
গিটহাবে উদাহরণ
- অ্যাঙ্করড অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপনের উদাহরণ: সুইফট | সুইফটইউআই | অবজেক্টিভ-সি
- উন্নত বৈশিষ্ট্যগুলির ডেমো: সুইফট | অবজেক্টিভ-সি
পরবর্তী পদক্ষেপ
ভাঁজযোগ্য ব্যানার
কলাপসিবল ব্যানার অ্যাড হলো এমন ব্যানার অ্যাড যা প্রথমে একটি বড় ওভারলে হিসেবে প্রদর্শিত হয় এবং এতে একটি বাটন থাকে যা দিয়ে অ্যাডটিকে ছোট আকারে সংকুচিত করা যায়। আপনার পারফরম্যান্স আরও অপ্টিমাইজ করতে এটি ব্যবহার করার কথা বিবেচনা করতে পারেন। আরও বিস্তারিত জানতে কলাপসিবল ব্যানার অ্যাড দেখুন।
ইনলাইন অভিযোজিত ব্যানার
অ্যাঙ্কর্ড অ্যাডাপ্টিভ ব্যানারের তুলনায় ইনলাইন অ্যাডাপ্টিভ ব্যানারগুলো আকারে বড় এবং লম্বা হয়। এগুলোর উচ্চতা পরিবর্তনযোগ্য এবং ডিভাইসের স্ক্রিনের সমান লম্বা হতে পারে। যেসব অ্যাপ স্ক্রলযোগ্য কন্টেন্টের মধ্যে ব্যানার বিজ্ঞাপন দেখায়, তাদের জন্য অ্যাঙ্কর্ড অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপনের চেয়ে ইনলাইন অ্যাডাপ্টিভ ব্যানার ব্যবহার করার পরামর্শ দেওয়া হয়। আরও বিস্তারিত জানতে ইনলাইন অ্যাডাপ্টিভ ব্যানার দেখুন।