বিজ্ঞাপন প্রিলোড করা হল Google Mobile Ads SDK-এ Google-পরিচালিত বিজ্ঞাপন লোড করার ফিচার যা আপনার হয়ে বিজ্ঞাপন লোড ও ক্যাশিং ম্যানেজ করে। বিজ্ঞাপন প্রিলোড করার জন্য, আপনি যেভাবে বিজ্ঞাপন লোড করা ম্যানেজ করেন তাতে পরিবর্তন করতে হবে। বিজ্ঞাপন প্রিলোড করার মাধ্যমে পারফর্ম্যান্স অপ্টিমাইজ করতে, কাস্টম ক্যাশিং বন্ধ করুন এবং সেই দায়িত্ব Google Mobile Ads SDK-কে দিন।
ম্যানুয়াল বিজ্ঞাপন লোডিংয়ের তুলনায় বিজ্ঞাপন প্রিলোডিংয়ের সুবিধাগুলি হল:
- রেফারেন্স ম্যানেজমেন্ট: লোড করা বিজ্ঞাপন হোল্ড করে রাখে যাতে আপনি সেগুলি দেখানোর জন্য প্রস্তুত না হওয়া পর্যন্ত আপনাকে রেফারেন্স বজায় রাখতে না হয়।
- অটোমেটিক রিলোড করা: আপনি ক্যাশে থেকে একটি বিজ্ঞাপন সরিয়ে নিলে, অটোমেটিক নতুন বিজ্ঞাপন লোড করে।
- ম্যানেজ করা আবার চেষ্টা: এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে ব্যর্থ অনুরোধগুলি অটোমেটিক আবার চেষ্টা করে।
- মেয়াদ শেষ হওয়া ম্যানেজ করা: মেয়াদ শেষ হওয়ার আগে (সাধারণত এক ঘণ্টা পরে) অটোমেটিক বিজ্ঞাপন রিফ্রেশ করে।
- ক্যাশে অপ্টিমাইজেশন: আপনি যদি একের বেশি ক্যাশে সাইজ ব্যবহার করেন, তাহলে Google Mobile Ads SDK সেরা বিজ্ঞাপন দেখানোর জন্য ক্যাশে অর্ডার অপ্টিমাইজ করে।
এই গাইডে প্রিলোড বিজ্ঞাপন কনফিগার করা, প্রিলোড বিজ্ঞাপনের উপলভ্যতা চেক করা এবং প্রিলোড করা বিজ্ঞাপন দেখানোর ব্যাপারে আলোচনা করা হয়েছে।
পূর্বশর্ত
এই টিউটোরিয়াল নিয়ে এগিয়ে যাওয়ার আগে, আপনাকে অবশ্যই Google Mobile Ads SDK সেট-আপ করতে হবে।
বিজ্ঞাপন প্রিলোড করা শুরু করুন
অ্যাপ চালু হলে, একবার preload মেথড কল করুন। আপনি
preload মেথড কল করার পরে, Google Mobile Ads SDK অটোমেটিক
বিজ্ঞাপন প্রিলোড করে এবং প্রিলোড করা কনফিগারেশনের জন্য ব্যর্থ অনুরোধ আবার চেষ্টা করে।
নিম্নলিখিত উদাহরণটি বিজ্ঞাপন প্রিলোড করা শুরু করে:
Swift
// Start the preloading initialization process.
let request = Request()
let interstitialConfig = PreloadConfigurationV2(
adUnitID: adUnitID, request: request)
InterstitialAdPreloader.shared.preload(
for: adUnitID, configuration: interstitialConfig, delegate: self)
Objective-C
// Start the preloading initialization process.
GADRequest *request = [GADRequest request];
GADPreloadConfigurationV2 *interstitialConfig =
[[GADPreloadConfigurationV2 alloc] initWithAdUnitID:adUnitID
request:request];
[GADInterstitialAdPreloader.sharedInstance preloadForPreloadID:adUnitID
configuration:interstitialConfig
delegate:self];
প্রিলোড করা বিজ্ঞাপন পান ও দেখান
বিজ্ঞাপন প্রিলোড করার সময়, Google Mobile Ads SDK ক্যাশে করা বিজ্ঞাপন হোল্ড করে।
আপনি কোনও বিজ্ঞাপন দেখাতে চাইলে, adWithPreloadID মেথড কল করুন।
Google Mobile Ads SDK উপলভ্য বিজ্ঞাপন খুঁজে নেয় এবং ব্যাকগ্রাউন্ডে পরবর্তী বিজ্ঞাপন
অটোমেটিক প্রিলোড করে।
আপনি বিজ্ঞাপন দেখানোর জন্য প্রস্তুত না হওয়া পর্যন্ত adWithPreloadID মেথড কল করা এড়িয়ে চলুন। ক্যাশে বিজ্ঞাপন রাখলে, Google Mobile Ads SDK অটোমেটিক মেয়াদ শেষ হয়ে যাওয়া বিজ্ঞাপন রিফ্রেশ করে
এবং ক্যাশে অপ্টিমাইজ করে।
নিম্নলিখিত উদাহরণটি একটি প্রিলোড করা বিজ্ঞাপন ফিরিয়ে আনে এবং দেখায়:
Swift
private func showInterstitialAd(adUnitID: String) {
// Verify that the preloaded ad is available before polling.
guard isInterstitialAvailable(adUnitID: adUnitID) else {
print("Preloaded interstitial ad is not available.")
return
}
// Polling returns the next available ad and loads another ad in the background.
let ad = InterstitialAdPreloader.shared.ad(with: adUnitID)
// Interact with the ad object as needed.
print("Interstitial ad response info: \(String(describing: ad?.responseInfo))")
ad?.paidEventHandler = { (value: AdValue) in
print("Interstitial ad paid event: \(value.value), \(value.currencyCode)")
}
ad?.fullScreenContentDelegate = self
ad?.present(from: self)
}
Objective-C
- (void)showInterstitialAdWithAdUnitID:(nonnull NSString *)adUnitID {
// Verify that the preloaded ad is available before polling.
if (![self isInterstitialAvailableWithAdUnitID:adUnitID]) {
NSLog(@"Preloaded interstitial ad is not available.");
return;
}
// Getting the preloaded ad loads another ad in the background.
GADInterstitialAd *ad =
[GADInterstitialAdPreloader.sharedInstance adWithPreloadID:adUnitID];
// Interact with the ad object as needed.
NSLog(@"Interstitial ad response info: %@", ad.responseInfo);
ad.paidEventHandler = ^(GADAdValue *_Nonnull value) {
NSLog(@"Interstitial ad paid event: %@ %@ ", value.value, value.currencyCode);
};
ad.fullScreenContentDelegate = self;
[ad presentFromRootViewController:self];
}
প্রিলোড করা বিজ্ঞাপনের মেটাডেটা পান
প্রিলোড করা বিজ্ঞাপনের মেটাডেটা পেতে, আপনি বিজ্ঞাপনের রেসপন্স তথ্য অবজেক্ট দেখতে পারেন। এই প্রসেস আপনাকে ক্যাশে থেকে বিজ্ঞাপন না সরিয়েই সেটির মেটাডেটা পরীক্ষা করার সুবিধা দেয়।
নিচের উদাহরণে, রেসপন্স তথ্য অবজেক্ট থেকে প্রিলোড করা বিজ্ঞাপনের মেটাডেটা খোঁজা হয়:
Swift
private func getInterstitialAdResponseInfo(preloadID: String) {
// Get the response info for the preloaded ad.
if let responseInfo = InterstitialAdPreloader.shared.responseInfo(
with: preloadID)
{
print("Ad response ID: \(responseInfo.responseIdentifier ?? "")")
}
}
Objective-C
- (void)getInterstitialAdResponseInfoWithPreloadID:(nonnull NSString *)preloadID {
// Get the response info for the preloaded ad.
GADResponseInfo *responseInfo =
[GADInterstitialAdPreloader.sharedInstance
adResponseInfoWithPreloadID:preloadID];
if (responseInfo) {
NSLog(@"Ad response ID: %@", responseInfo.responseIdentifier);
}
}
প্রিলোড করা বিজ্ঞাপন উপলভ্য কিনা তা চেক করা
বিজ্ঞাপন উপলভ্য কিনা তা চেক করতে, নিম্নলিখিত বিকল্পগুলির মধ্যে থেকে যেকোনও একটি বেছে নিন:
প্রিলোড করা বিজ্ঞাপনের উপলভ্যতা সম্পর্কে জানুন
নিম্নলিখিত উদাহরণটি বিজ্ঞাপন উপলভ্য কিনা তা চেক করে:
Swift
private func isInterstitialAvailable(adUnitID: String) -> Bool {
// Verify that an ad is available before polling.
return InterstitialAdPreloader.shared.isAdAvailable(with: adUnitID)
}
Objective-C
- (BOOL)isInterstitialAvailableWithAdUnitID:(nonnull NSString *)adUnitID {
// Verify that an ad is available before polling.
return [GADInterstitialAdPreloader.sharedInstance isAdAvailableWithPreloadID:adUnitID];
}
প্রিলোড করা বিজ্ঞাপনের উপলভ্যতা শুনুন
বিজ্ঞাপন প্রিলোড করা হলে, প্রিলোড করা না গেলে অথবা বিজ্ঞাপন ক্যাশে শেষ হয়ে গেলে বিজ্ঞপ্তি পেতে প্রিলোড ইভেন্টের জন্য রেজিস্টার করুন।
প্রিলোড ইভেন্টগুলি অ্যানালিটিক্সের উদ্দেশ্যে ব্যবহার করা হয়। প্রিলোড ইভেন্ট কলব্যাক-এর মধ্যে:
preloadনম্বরে কল করবেন না।- বিজ্ঞাপন অবিলম্বে দেখানো না হলে
adWithPreloadIDকল করা এড়িয়ে চলুন।
নিম্নলিখিত উদাহরণটি বিজ্ঞাপন ইভেন্টের জন্য রেজিস্টার করে:
Swift
func adAvailable(forPreloadID preloadID: String, responseInfo: ResponseInfo) {
// This callback indicates that an ad is available for the specified configuration.
// No action is required here, but updating the UI can be useful in some cases.
print("Ad preloaded successfully for ad preload ID: \(preloadID)")
}
func adsExhausted(forPreloadID preloadID: String) {
// This callback indicates that all the ads for the specified configuration have been
// consumed and no ads are available to show. No action is required here, but updating
// the UI can be useful in some cases.
// Don't call InterstitialAdPreloader.shared.preload or
// InterstitialAdPreloader.shared.ad from adsExhausted.
print("Ad exhausted for ad preload ID: \(preloadID)")
}
func adFailedToPreload(forPreloadID preloadID: String, error: Error) {
print(
"Ad failed to load with ad preload ID: \(preloadID), Error: \(error.localizedDescription)"
)
}
Objective-C
- (void)adAvailableForPreloadID:(nonnull NSString *)preloadID
responseInfo:(nonnull GADResponseInfo *)responseInfo {
// This callback indicates that an ad is available for the specified configuration.
// No action is required here, but updating the UI can be useful in some cases.
NSLog(@"Ad preloaded successfully for ad unit ID: %@", preloadID);
}
- (void)adsExhaustedForPreloadID:(nonnull NSString *)preloadID {
// This callback indicates that all the ads for the specified configuration have been
// consumed and no ads are available to show. No action is required here, but updating
// the UI can be useful in some cases.
// Don't call [GAD<Format>AdPreloader preloadForPreloadID:] or
// [GAD<Format>AdPreloader adWithPreloadID:] from adsExhaustedForPreloadID.
NSLog(@"Ad exhausted for ad preload ID: %@", preloadID);
}
- (void)adFailedToPreloadForPreloadID:(nonnull NSString *)preloadID
error:(nonnull NSError *)error {
NSLog(@"Ad failed to load with ad preload ID: %@, Error: %@", preloadID,
error.localizedDescription);
}
বিজ্ঞাপন প্রিলোড করা বন্ধ করুন
সেশনে প্রিলোড আইডির জন্য আবার বিজ্ঞাপন দেখানোর প্রয়োজন না হলে, আপনি বিজ্ঞাপন প্রিলোড করা বন্ধ করতে পারেন। নির্দিষ্ট প্রিলোড আইডির জন্য
বিজ্ঞাপন প্রিলোড করা বন্ধ করতে, প্রিলোড আইডির সাথে
stopPreloadingAndRemoveAdsForPreloadID কল করুন। সব প্রিলোডারের জন্য প্রিলোডিং বন্ধ করতে, stopPreloadingAndRemoveAllAds কল করুন।
বাফারের সাইজ সেট করুন
বাফার সাইজ মেমরিতে রাখা প্রিলোড করা বিজ্ঞাপনের সংখ্যা নিয়ন্ত্রণ করে। ডিফল্ট হিসেবে, Google মেমরি খরচ এবং বিজ্ঞাপন পরিবেশনের লেটেন্সির মধ্যে ভারসাম্য বজায় রাখতে বাফারের সাইজ অপ্টিমাইজ করে। পরবর্তী বিজ্ঞাপন লোড হওয়ার আগে আপনার অ্যাপ বিজ্ঞাপন দেখালে, মেমরিতে রাখা বিজ্ঞাপনের সংখ্যা বাড়াতে আপনি কাস্টম বাফার সাইজ সেট করতে পারবেন।
Swift
let preloadConfig = PreloadConfigurationV2(adUnitID: adUnitID)
// Define a PreloadConfiguration and set the buffer size to 2 preloaded ads.
preloadConfig.bufferSize = 2
Objective-C
GADPreloadConfigurationV2 *preloadConfig =
[[GADPreloadConfigurationV2 alloc] initWithAdUnitID:adUnitID];
// Define a PreloadConfiguration and set the buffer size to 2 preloaded ads.
preloadConfig.bufferSize = 2;
প্রিলোড ক্যাশে সীমা
Google Mobile Ads SDK সমস্ত বিজ্ঞাপন ইউনিট এবং প্রিলোড আইডি জুড়ে প্রিলোড করা বিজ্ঞাপনের মোট সংখ্যার উপর অ্যাপ-ব্যাপী সীমা প্রয়োগ করে:
- ডিফল্ট সীমা: Google Mobile Ads SDK মেমরিতে সর্বাধিক ৬টি প্রিলোড করা বিজ্ঞাপন ধরে রাখে। এই সীমা সব ফর্ম্যাট ও প্রিলোড আইডি জুড়ে শেয়ার করা হয়।
- প্রতিটি প্রিলোড আইডির জন্য আমরা বাফার সাইজ দুই রাখার সাজেশন দিই।