এই গাইডে iOS অ্যাপে অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপন লোড করার ব্যাপারে আলোচনা করা হয়েছে।
পূর্বশর্ত
চালিয়ে যাওয়ার আগে, Google Mobile Ads SDK সেট-আপ করুন।
সবসময় টেস্ট বিজ্ঞাপন দিয়ে পরীক্ষা করুন
আপনার অ্যাপ তৈরি ও পরীক্ষা করার সময়, লাইভ, প্রোডাকশন বিজ্ঞাপনের পরিবর্তে পরীক্ষামূলক বিজ্ঞাপন ব্যবহার করতে ভুলবেন না। এটি না করলে আপনার অ্যাকাউন্ট সাসপেন্ড করা হতে পারে।
টেস্ট বিজ্ঞাপন লোড করার সবচেয়ে সহজ উপায় হল iOS ব্যানারের জন্য আমাদের নির্দিষ্ট টেস্ট বিজ্ঞাপন ইউনিট আইডি ব্যবহার করা:
/21775744923/example/adaptive-banner
প্রতিটি অনুরোধের জন্য পরীক্ষামূলক বিজ্ঞাপন দেখানোর জন্য এটি বিশেষভাবে কনফিগার করা হয়েছে এবং কোডিং, টেস্টিং ও ডিবাগিং করার সময় আপনি নিজের অ্যাপে এটি ব্যবহার করতে পারবেন। শুধু মনে রাখবেন, অ্যাপ প্রকাশ করার আগে আপনাকে এই আইডিটি নিজের বিজ্ঞাপন ইউনিট আইডি দিয়ে পরিবর্তন করতে হবে।
Google Mobile Ads SDK টেস্ট বিজ্ঞাপন কীভাবে কাজ করে সেই সম্পর্কে আরও জানতে, টেস্ট বিজ্ঞাপন দেখুন।
GAMBannerView তৈরি করা
ব্যানার বিজ্ঞাপন GAMBannerView
অবজেক্টে দেখানো হয়, তাই ব্যানার বিজ্ঞাপন ইন্টিগ্রেট করার প্রথম ধাপ হল আপনার ভিউ হায়ারার্কিতে একটি GAMBannerView
অন্তর্ভুক্ত করা। এটি সাধারণত প্রোগ্রাম্যাটিক্যালি বা
ইন্টারফেস বিল্ডারের মাধ্যমে করা হয়।
প্রোগ্রাম্যাটিক
এছাড়াও, সরাসরি GAMBannerView ইনস্ট্যান্টিয়েট করা যেতে পারে।
নিচের উদাহরণে একটি GAMBannerView তৈরি করা হয়েছে:
Swift
// 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)
}
Objective-C
// 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-এর সমান করে সেট করুন।
বিজ্ঞাপনের সাইজ সেট করুন
বড় অ্যাডাপ্টিভ ব্যানার, স্ক্রল করা যায় না এমন লেআউটের জন্য ডিজাইন করা আরও বড় ফর্ম্যাট প্রদান করে। স্ট্যান্ডার্ড অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানারের তুলনায়, এই ব্যানারগুলি আরও বেশি উচ্চতা (স্ক্রিনের উচ্চতার ২০% পর্যন্ত, ৫০ থেকে ১৫০ পয়েন্টের মধ্যে) দেখানোর অনুমতি দেয়। এই বর্ধিত স্পেস ভিডিও কন্টেন্টের জন্য অপ্টিমাইজ করা হয়েছে।
নিম্নলিখিত উদাহরণটি একটি বড় অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানারের সাইজ দেখায়:
Swift
// Request a large anchored adaptive banner with a width of 375.
bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)
Objective-C
// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);
বিজ্ঞাপন লোড করুন
GAMBannerView সেট-আপ করা হয়ে গেলে এবং adUnitID-এর মতো প্রপার্টি কনফিগার করা হয়ে গেলে,
বিজ্ঞাপন লোড করার সময় হয়ে যায়। এটি GAMRequest
অবজেক্টে loadRequest:
কল করে করা হয়:
Swift
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())
Objective-C
// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);
[self.bannerView loadRequest:[GAMRequest request]];
GAMRequest অবজেক্ট একটি বিজ্ঞাপন অনুরোধকে দেখায় এবং টার্গেটিং সংক্রান্ত তথ্যের মতো
জিনিসের জন্য প্রপার্টি থাকে।
বিজ্ঞাপন রিফ্রেশ করা
আপনি যদি রিফ্রেশ করার জন্য বিজ্ঞাপন ইউনিট কনফিগার করে থাকেন, তাহলে বিজ্ঞাপন লোড না হলে আপনাকে অন্য বিজ্ঞাপনের অনুরোধ করতে হবে না। Ad Manager UI-তে আপনার উল্লেখ করা যেকোনও রিফ্রেশ রেট Google Mobile Ads SDK মেনে চলে। আপনি রিফ্রেশ করার সুবিধা চালু না করে থাকলে, নতুন অনুরোধ করুন। বিজ্ঞাপন ইউনিট রিফ্রেশ করা সম্পর্কে আরও জানতে, যেমন রিফ্রেশ রেট সেট করা, দেখুন মোবাইল অ্যাপে বিজ্ঞাপনের রিফ্রেশ রেট।
ওরিয়েন্টেশন পরিবর্তন ম্যানেজ করুন
আপনার অ্যাপের স্ক্রিন ওরিয়েন্টেশন পরিবর্তন হলে, যেমন
portrait
মোড থেকে ল্যান্ডস্কেপ, ব্যানার দেখানোর জন্য উপলভ্য প্রস্থও প্রায়ই পরিবর্তিত হয়। নতুন লেআউটের জন্য উপযুক্ত সাইজের বিজ্ঞাপন দেখাচ্ছেন কিনা তা নিশ্চিত করতে, নতুন ব্যানার অনুরোধ করুন। আপনার ব্যানারের প্রস্থ স্থির থাকলে অথবা আপনার লেআউট কনস্ট্রেন্ট যদি
রিসাইজ করার বিষয়টি ম্যানেজ করতে পারে, তাহলে এই ধাপটি এড়িয়ে যান।
Swift
override func viewWillTransition(
to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator
) {
coordinator.animate(alongsideTransition: { _ in
// Load a new ad for the new orientation.
})
}
Objective-C
- (void)viewWillTransitionToSize:(CGSize)size
withTransitionCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator {
[coordinator animateAlongsideTransition:^(id<UIViewControllerTransitionCoordinatorContext> context) {
// Load a new ad for the new orientation.
} completion:nil];
}
বিজ্ঞাপন ইভেন্ট
GADBannerViewDelegate ব্যবহার করে, আপনি লাইফসাইকেল ইভেন্ট শুনতে পারবেন,
যেমন, কোনও বিজ্ঞাপন বন্ধ করা হলে বা ব্যবহারকারী অ্যাপ থেকে বেরিয়ে গেলে।
ব্যানার ইভেন্টের জন্য রেজিস্টার করুন
ব্যানার বিজ্ঞাপন ইভেন্টের জন্য রেজিস্টার করতে, delegate প্রপার্টিকে
GAMBannerView এমন একটি অবজেক্টে সেট করুন যা
GADBannerViewDelegate প্রোটোকল প্রয়োগ করে। সাধারণত, যে ক্লাস ব্যানার
বিজ্ঞাপন প্রয়োগ করে সেটিও প্রতিনিধি ক্লাস হিসেবে কাজ করে, সেক্ষেত্রে, delegate প্রপার্টি self হিসেবে সেট করা
যায়।
Swift
bannerView.delegate = self
SwiftUI
banner.delegate = context.coordinator
Objective-C
bannerView.delegate = self;
ব্যানার ইভেন্ট প্রয়োগ করুন
GADBannerViewDelegate-এর প্রতিটি পদ্ধতিকে ঐচ্ছিক হিসেবে চিহ্নিত করা হয়েছে, তাই আপনি
শুধুমাত্র সেইসব পদ্ধতি প্রয়োগ করতে হবে যা আপনি চান। এই উদাহরণ প্রতিটি পদ্ধতি প্রয়োগ করে
এবং কনসোলে একটি মেসেজ লগ করে:
Swift
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.")
}
Objective-C
- (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: ইভেন্টের জন্য
শুনে আপনি এটি করতে পারবেন:
Swift
func bannerViewDidReceiveAd(_ bannerView: BannerView) {
// Add banner to view and add constraints.
addBannerViewToView(bannerView)
}
Objective-C
- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
// Add bannerView to view and add constraints as above.
[self addBannerViewToView:self.bannerView];
}
ব্যানার বিজ্ঞাপন অ্যানিমেট করা
এছাড়াও, নিম্নলিখিত উদাহরণে দেখানো হয়েছে যে, bannerViewDidReceiveAd: ইভেন্ট ব্যবহার করে একবার ব্যানার বিজ্ঞাপন অ্যানিমেট করা
হতে পারে:
Swift
func bannerViewDidReceiveAd(_ bannerView: BannerView) {
bannerView.alpha = 0
UIView.animate(withDuration: 1, animations: {
bannerView.alpha = 1
})
}
Objective-C
- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
bannerView.alpha = 0;
[UIView animateWithDuration:1.0 animations:^{
bannerView.alpha = 1;
}];
}
অ্যাপ পজ ও আবার চালু করা
GADBannerViewDelegate প্রোটোকলে ইভেন্ট সম্পর্কে আপনাকে জানানোর পদ্ধতি আছে, যেমন
ক্লিক করার ফলে ওভারলে দেখানো বা সরিয়ে দেওয়া হলে। এইসব ইভেন্ট বিজ্ঞাপনের কারণে হয়েছে কিনা তা
ট্রেস করতে চাইলে, এইসব
GADBannerViewDelegate পদ্ধতির জন্য রেজিস্টার করুন।
শুধু বিজ্ঞাপনে ক্লিক থেকে আসা নয়, সব ধরনের ওভারলে প্রেজেন্টেশন বা এক্সটার্নাল ব্রাউজার ইনভোকেশন
ক্যাচ করতে, আপনার অ্যাপ UIViewController বা UIApplication-এ সমতুল্য পদ্ধতি
লিসেন করলে ভাল হয়। এখানে একটি সারণী দেওয়া হল
যেখানে GADBannerViewDelegate পদ্ধতির মতো একই সময়ে
ইনভোক করা সমতুল্য iOS পদ্ধতি দেখানো হয়েছে:
| GADBannerViewDelegate পদ্ধতি | iOS পদ্ধতি |
|---|---|
bannerViewWillPresentScreen: |
UIViewController-এর viewWillDisappear: |
bannerViewWillDismissScreen: |
UIViewController-এর viewWillAppear: |
bannerViewDidDismissScreen: |
UIViewController-এর viewDidAppear: |
ম্যানুয়ালি ইম্প্রেশন গণনা করা
ইম্প্রেশন কখন রেকর্ড করা উচিত সেই বিষয়ে আপনার বিশেষ শর্ত থাকলে, আপনি ম্যানুয়ালি Ad Manager-এ ইম্প্রেশন পিং পাঠাতে পারেন। এটি করার জন্য প্রথমে
বিজ্ঞাপন লোড করার আগে ম্যানুয়াল ইম্প্রেশনের জন্য GAMBannerView চালু করতে হবে:
Swift
bannerView.enableManualImpressions = true
Objective-C
self.bannerView.enableManualImpressions = YES;
আপনি যখন নির্ধারণ করেন যে কোনও বিজ্ঞাপন সফলভাবে ফিরে এসেছে এবং স্ক্রিনে রয়েছে, আপনি ম্যানুয়ালি একটি ইম্প্রেশন ফায়ার করতে পারেন:
Swift
bannerView.recordImpression()
Objective-C
[self.bannerView recordImpression];
অ্যাপ ইভেন্ট
আপনি GADAppEventDelegate ব্যবহার করে Ad Manager-নির্দিষ্ট অ্যাপ ইভেন্ট শুনতে পারবেন।
বিজ্ঞাপনের লাইফসাইকেল চলাকালীন যেকোনও সময় এইসব ইভেন্ট ঘটতে পারে, এমনকি GADBannerViewDelegate অবজেক্টের bannerViewDidReceiveAd: কল করার আগেও।
অ্যাপ ইভেন্টের জন্য রেজিস্টার করতে, GAMBannerView-এ ডেলিগেট প্রপার্টি এমন একটি অবজেক্টে সেট করুন যা GADAppEventDelegate প্রোটোকল প্রয়োগ করে। সাধারণত, যে ক্লাস ব্যানার বিজ্ঞাপন
ইমপ্লিমেন্ট করে সেটি ডেলিগেট ক্লাস হিসেবেও কাজ করে, যেক্ষেত্রে ডেলিগেট প্রপার্টি
self-এ সেট করা যেতে পারে।
Swift
// Set this property before making the request for an ad.
bannerView.appEventDelegate = self
Objective-C
// Set this property before making the request for an ad.
self.bannerView.appEventDelegate = self;
অ্যাপ ইভেন্ট থেকে রঙ নির্দিষ্ট করে আপনার অ্যাপের ব্যাকগ্রাউন্ড রঙ কীভাবে পরিবর্তন করবেন তা দেখানোর জন্য এখানে একটি উদাহরণ দেওয়া হল:
Swift
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
}
}
}
Objective-C
- (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 ডেমো অ্যাপে অ্যাপ ইভেন্ট প্রয়োগ করার জন্য Ad Manager অ্যাপ ইভেন্টের উদাহরণ দেখুন।
অতিরিক্ত রিসোর্স
GitHub-এ উদাহরণ
- অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপনের উদাহরণ: Swift | SwiftUI | Objective-C
- উন্নত ফিচারের ডেমো: Swift | Objective-C
পরবর্তী ধাপ
আড়াল করা যায় এমন ব্যানার
আড়াল করা যায় এমন ব্যানার বিজ্ঞাপন হল এমন ব্যানার বিজ্ঞাপন যা প্রথমে একটি বড় ওভারলে হিসেবে দেখানো হয়, যেখানে বিজ্ঞাপনটি ছোট আকারে আড়াল করার জন্য একটি বোতাম থাকে। পারফর্ম্যান্স আরও অপ্টিমাইজ করতে এটি ব্যবহার করার কথা বিবেচনা করুন। আরও বিবরণের জন্য আড়াল করা যায় এমন ব্যানার বিজ্ঞাপন দেখুন।
ইনলাইন অ্যাডাপ্টিভ ব্যানার
অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানারের তুলনায় ইনলাইন অ্যাডাপ্টিভ ব্যানারগুলি বড় ও লম্বা হয়। ব্যানার। এগুলির উচ্চতা পরিবর্তনশীল এবং ডিভাইসের স্ক্রিনের মতো লম্বা হতে পারে। যেসব অ্যাপে স্ক্রল করা যায় এমন কন্টেন্টে ব্যানার বিজ্ঞাপন প্লেস করা হয়, সেগুলির জন্য অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপনের পরিবর্তে ইনলাইন অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপন সাজেস্ট করা হয়। আরও বিবরণের জন্য ইনলাইন অ্যাডাপ্টিভ ব্যানার দেখুন।