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

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (Legacy)

ব্যানার বিজ্ঞাপন হল আয়তাকার বিজ্ঞাপন যা অ্যাপের লেআউটের একটি অংশ জুড়ে থাকে। অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানার সবসময় স্ক্রিনে থাকে, স্ক্রিনের উপরে বা নিচে অ্যাঙ্কর করা থাকে, যার সর্বাধিক উচ্চতা স্ক্রিনের আকারের ২০% এবং সর্বাধিক উচ্চতা ১৫০ পিক্সেল। প্রতিটি ডিভাইসের জন্য বিজ্ঞাপনের সাইজ অপ্টিমাইজ করতে, অ্যাডাপ্টিভ ব্যানার ব্যবহার করুন।

এই নির্দেশিকায় iOS অ্যাপে অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপন লোড করার বিষয়টি অন্তর্ভুক্ত রয়েছে।

পূর্বশর্ত

চালিয়ে যাওয়ার আগে, Google Mobile Ads SDK সেট-আপ করুন।

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

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

বিজ্ঞাপন লোড টেস্ট করার সবচেয়ে সহজ উপায় হল iOS ব্যানারের জন্য আমাদের নির্দিষ্ট টেস্ট বিজ্ঞাপন ইউনিট আইডি ব্যবহার করা:

ca-app-pub-3940256099942544/2435281174

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

Google Mobile Ads SDKটেস্ট বিজ্ঞাপন কীভাবে কাজ করে সেই সম্পর্কে আরও জানতে, টেস্ট বিজ্ঞাপন দেখুন।

GADBannerView তৈরি করা

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

প্রোগ্রাম্যাটিক্যালি

GADBannerView-এর ইনস্ট্যান্স সরাসরিও তৈরি করা যায়। নিচের উদাহরণে একটি GADBannerView তৈরি করা হয়েছে:

Swift

// Initialize the banner view.
bannerView = BannerView()
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

BannerView ব্যবহার করতে, 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)
  }

height ও width ভ্যালু নির্দিষ্ট করে ভিউ হায়ারার্কিতে আপনার UIViewRepresentable যোগ করুন:

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.
GADBannerView *bannerView = [[GADBannerView 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 ফাইলে GADBannerView যোগ করতে পারবেন। এই পদ্ধতি ব্যবহার করার সময়, ব্যানারে শুধুমাত্র পজিশন কনস্ট্রেন্ট যোগ করতে ভুলবেন না। যেমন, স্ক্রিনের নিচে অ্যাডাপ্টিভ ব্যানার দেখানোর সময়, ব্যানার ভিউয়ের নিচের অংশ বটম লেআউট গাইডের উপরের অংশের সমান করে সেট করুন এবং 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);

বিজ্ঞাপন লোড করা

GADBannerView সেট-আপ করা হয়ে গেলে এবং adUnitID-এর মতো প্রপার্টি কনফিগার করা হয়ে গেলে, বিজ্ঞাপন লোড করার সময় হয়ে যায়। GADRequest অবজেক্টে loadRequest: কল করে এটি করা হয়:

Swift

func loadBannerAd(bannerView: BannerView) {
  // Request a large anchored adaptive banner with a width of 375.
  bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)
  bannerView.load(Request())
}

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:[GADRequest request]];

GADRequest অবজেক্ট একটি বিজ্ঞাপন অনুরোধকে উপস্থাপন করে এবং টার্গেটিং তথ্যের মতো বিষয়গুলির জন্য প্রপার্টি থাকে।

বিজ্ঞাপন রিফ্রেশ করা

আপনি যদি রিফ্রেশ করার জন্য আপনার বিজ্ঞাপন ইউনিট কনফিগার করে থাকেন, তাহলে বিজ্ঞাপন লোড না হলে আপনাকে অন্য বিজ্ঞাপনের জন্য অনুরোধ করতে হবে না। AdMob 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 প্রপার্টি GADBannerView-এ এমন একটি অবজেক্টে সেট করুন যা 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:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidReceiveAd");
}

- (void)bannerView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
  NSLog(@"bannerView:didFailToReceiveAdWithError: %@", error.localizedDescription);
}

- (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidRecordImpression");
}

- (void)bannerViewWillPresentScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillPresentScreen");
}

- (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillDismissScreen");
}

- (void)bannerViewDidDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidDismissScreen");
}

iOS API ডেমো অ্যাপে ব্যানার ডেলিগেট পদ্ধতি প্রয়োগ করার জন্য বিজ্ঞাপন ডেলিগেট উদাহরণ দেখুন।

Swift Objective-C

যেসব ক্ষেত্রে ব্যবহার করা যাবে

এইসব বিজ্ঞাপন ইভেন্ট পদ্ধতির কিছু উদাহরণ এখানে দেওয়া হল।

বিজ্ঞাপন পাওয়া গেলে ভিউ হায়ারার্কিতে ব্যানার যোগ করুন

আপনি হয়ত বিজ্ঞাপন না পাওয়া পর্যন্ত ভিউ হায়ারার্কিতে GADBannerView যোগ করতে দেরি করতে চাইবেন। bannerViewDidReceiveAd: ইভেন্টের জন্য শুনে আপনি এটি করতে পারবেন:

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  // Add banner to view and add constraints.
  addBannerViewToView(bannerView)
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)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:(GADBannerView *)bannerView {
  bannerView.alpha = 0;
  [UIView animateWithDuration:1.0 animations:^{
    bannerView.alpha = 1;
  }];
}

অ্যাপ পজ ও আবার চালু করা

GADBannerViewDelegate প্রোটোকলে ইভেন্ট সম্পর্কে আপনাকে জানানোর পদ্ধতি আছে, যেমন ক্লিক করার ফলে ওভারলে দেখানো বা বাতিল করা। এইসব ইভেন্ট বিজ্ঞাপনের কারণে হয়েছে কিনা তা ট্রেস করতে চাইলে, এইসব GADBannerViewDelegate পদ্ধতির জন্য রেজিস্টার করুন।

শুধু বিজ্ঞাপনে ক্লিক থেকে আসা নয়, সব ধরনের ওভারলে প্রেজেন্টেশন বা এক্সটার্নাল ব্রাউজার ইনভোকেশন ক্যাচ করতে, আপনার অ্যাপ UIViewController বা UIApplication-এ সমতুল্য পদ্ধতি লিসেন করলে ভাল হয়। এখানে একটি টেবিল দেওয়া হল যেখানে iOS-এর সমতুল্য পদ্ধতি দেখানো হয়েছে যেগুলি GADBannerViewDelegate পদ্ধতির মতো একই সময়ে আহ্বান করা হয়:

GADBannerViewDelegate মেথড iOS পদ্ধতি
bannerViewWillPresentScreen: UIViewController-এর viewWillDisappear:
bannerViewWillDismissScreen: UIViewController-এর viewWillAppear:
bannerViewDidDismissScreen: UIViewController-এর viewDidAppear:

অতিরিক্ত রিসোর্স

GitHub-এ উদাহরণ

  • অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপনের উদাহরণ: Swift | SwiftUI | Objective-C

পরবর্তী ধাপ

আড়াল করা যায় এমন ব্যানার

আড়াল করা যায় এমন ব্যানার বিজ্ঞাপন হল এমন ব্যানার বিজ্ঞাপন যা প্রথমে একটি বড় ওভারলে হিসেবে দেখানো হয়, যেখানে বিজ্ঞাপনটি ছোট আকারে আড়াল করার জন্য একটি বোতাম থাকে। পারফর্ম্যান্স আরও অপ্টিমাইজ করতে এটি ব্যবহার করার কথা বিবেচনা করুন। আরও বিবরণের জন্য আড়াল করা যায় এমন ব্যানার বিজ্ঞাপন দেখুন।

ইনলাইন অ্যাডাপ্টিভ ব্যানার

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

অন্যান্য বিষয় এক্সপ্লোর করুন