এই নির্দেশিকাটি সেইসব বিজ্ঞাপন নেটওয়ার্কের জন্য তৈরি করা হয়েছে যারা Google মধ্যস্থতার মধ্যে রিয়েল-টাইম বিডিংয়ে (RTB) অংশগ্রহণ করার জন্য একটি বিডিং অ্যাডাপ্টার তৈরি করতে চায়। আপনি প্রকাশক হলে, প্রকাশক মধ্যস্থতা নির্দেশাবলী দেখুন।
বিডিং অ্যাডাপ্টার হল ইন্টিগ্রেশনের ক্লায়েন্ট-সাইড অংশ। অ্যাডাপ্টার আপনার বিজ্ঞাপন নেটওয়ার্ক SDK-কে Google Mobile Ads SDK (Legacy)-এর সাথে যোগাযোগ করতে দেয় যাতে আপনার বিডারের মাধ্যমে পরিবেশিত বিজ্ঞাপন লোড করা যায়।
বিডিং যাতে সঠিকভাবে কাজ করে তার জন্য আপনার অ্যাডাপ্টারকে ইনিশিয়ালাইজেশন, সিগন্যাল সংগ্রহ করা, বিজ্ঞাপন লোড করা এবং বিজ্ঞাপন লাইফসাইকেল ইভেন্ট রিলে করার মতো কাজগুলি ম্যানেজ করতে হবে। এই নির্দেশিকায় আমরা আপনাকে দেখাব যে এইসব অপারেশন ম্যানেজ করার জন্য আপনার অ্যাডাপ্টার কীভাবে প্রয়োগ করা উচিত।
বিডিং অ্যাডাপ্টারের ওয়ার্কফ্লো
শুরু করা
অ্যাডাপ্টারের সম্পূর্ণ অনুরোধ-উত্তর-রেন্ডারিং লাইফসাইকেলের বিস্তারিত ফ্লো নিচে দেখানো হয়েছে:

অ্যাডাপ্টার ওয়ার্কফ্লোয়ের নিম্নলিখিত অংশের জন্য দায়ী:
ধাপ ৪-৭: আপনার অ্যাডাপ্টার ইনিশিয়ালাইজ করুন এবং ইনিশিয়ালাইজেশন সম্পূর্ণ হলে Google Mobile Ads SDK (Legacy)-এ কল ব্যাক করুন।
১০-১৩ ধাপ: RTB অনুরোধে অংশগ্রহণ করার জন্য আপনার বিডারকে পাঠানোর উদ্দেশ্যে আপনার বিজ্ঞাপন নেটওয়ার্ক SDK থেকে সিগন্যাল সংগ্রহ করুন এবং সেগুলি Google Mobile Ads SDK-তে ফরওয়ার্ড করুন।
১৮-২১ নম্বর ধাপ: আপনার বিডার যদি জয়ী বিড ফিরিয়ে দেয়, তাহলে আপনার বিডারের থেকে পাওয়া উত্তর অনুযায়ী বিজ্ঞাপন লোড করুন। লোড হয়ে গেলে, Google Mobile Ads SDK (Legacy)-কে বিজ্ঞপ্তি পাঠান যে বিজ্ঞাপন লোড হয়ে গেছে।
ধাপ ২৩ এবং তার পরে: আপনার বিজ্ঞাপন দেখানোর সময়, ইম্প্রেশন ও ক্লিক ইভেন্টের পাশাপাশি আপনার বিজ্ঞাপনের প্রেজেন্টেশন লাইফসাইকেল চলাকালীন হওয়া অন্যান্য বিজ্ঞাপন ইভেন্ট সম্পর্কে Google Mobile Ads SDK-কে জানান।
বিডিং অ্যাডাপ্টার প্রয়োগ করা
Google Mobile Ads SDK (Legacy)-এর জন্য বিডিং অ্যাডাপ্টার তৈরি করতে, আপনাকে অবশ্যই RtbAdapter
অ্যাবস্ট্রাক্ট ক্লাস এক্সটেন্ড করতে হবে। নিম্নলিখিত বিভাগগুলি RtbAdapter-এ প্রতিটি অ্যাবস্ট্রাক্ট পদ্ধতি ব্যাখ্যা করে।
getSDKVersionInfo()
এখানে আপনার SDK-এর ভার্সন উল্লেখ করতে হবে। এই ভার্সনটি OpenRTB অনুরোধের অংশ হিসেবে আপনার বিডারের কাছে পাঠানো হয়।
এই পদ্ধতিতে আপনাকে একটি VersionInfo ফেরত দিতে হবে। নিচের উদাহরণে দেখানো হয়েছে যে কীভাবে
আপনি SDK-এর স্ট্রিং ভার্সনকে VersionInfo.-এ পরিবর্তন করতে পারেন
@Override
public VersionInfo getSDKVersionInfo() {
// Get your SDK's version as a string. E.g. "1.2.3"
// String versionString = YourSdk.getVersion();
String splits[] = versionString.split("\\.");
if (splits.length >= 3) {
int major = Integer.parseInt(splits[0]);
int minor = Integer.parseInt(splits[1]);
int micro = Integer.parseInt(splits[2]);
return new VersionInfo(major, minor, micro);
}
String logMessage = String.format("Unexpected SDK version format: %s." +
"Returning 0.0.0 for SDK version.", sdkVersion);
Log.w(TAG, logMessage);
return new VersionInfo(0, 0, 0);
}
getVersionInfo()
এখানে আপনার অ্যাডাপ্টারের ভার্সন রিটার্ন করতে হবে। এই ভার্সনটি OpenRTB অনুরোধের অংশ হিসেবে আপনার বিডারের কাছে পাঠানো হয়।
Google-এর ওপেন সোর্স ও ভার্সন করা
অ্যাডাপ্টার
৪-সংখ্যার অ্যাডাপ্টার ভার্সন স্কিম ব্যবহার করে, কিন্তু VersionInfo-এ শুধু ৩টি
সংখ্যা ব্যবহার করা যায়। এই সমস্যার সমাধান করতে, নিচে দেখানো উদাহরণ অনুযায়ী, শেষ দুটি সংখ্যাকে
প্যাচ ভার্সনে একত্রিত করার সাজেশন দেওয়া হচ্ছে।
@Override
public VersionInfo getVersionInfo() {
// Get your adapters's version as a string. E.g. "1.2.3.0"
String versionString = BuildConfig.VERSION_NAME;
String splits[] = versionString.split("\\.");
if (splits.length >= 4) {
int major = Integer.parseInt(splits[0]);
int minor = Integer.parseInt(splits[1]);
int micro = Integer.parseInt(splits[2]) * 100 + Integer.parseInt(splits[3]);
return new VersionInfo(major, minor, micro);
}
String logMessage = String.format("Unexpected adapter version format: %s." +
"Returning 0.0.0 for adapter version.", versionString);
Log.w(TAG, logMessage);
return new VersionInfo(0, 0, 0);
}
initialize()
টাইমআউট: ৩০ সেকেন্ড
আপনার অ্যাডাপ্টারে প্রথম যে মেথড কল করা হয় সেটি হল initialize() মেথড। এটি
সেশন প্রতি একবারই কল করা হয়। এই পদ্ধতি আপনাকে MediationConfiguration অবজেক্টের একটি তালিকা প্রদান করে যা এই অ্যাপে প্লেসমেন্টের সম্পূর্ণ তালিকা দেখায় যা আপনার বিজ্ঞাপন নেটওয়ার্কের জন্য কনফিগার করা হয়েছে; আপনি প্রতিটি প্লেসমেন্টের জন্য ক্রেডেনশিয়াল পার্স করতে এই তালিকার মাধ্যমে লুপ করতে পারেন এবং শুরু করার জন্য আপনার SDK-তে প্রাসঙ্গিক ডেটা পাস করতে পারেন।
আপনার SDK শুরু হয়ে গেলে এবং বিজ্ঞাপনের অনুরোধ পাওয়ার জন্য প্রস্তুত হলে, InitializationCompleteCallback-এর
onInitializationSucceeded() মেথডটি ইনভোক করুন।
এই কলব্যাক অ্যাপ প্রকাশকদের কাছে ফরওয়ার্ড করা হয় যাতে তারা জানতে পারেন যে তারা
বিজ্ঞাপন লোড করা শুরু করতে পারবেন।
@Override
public void initialize(Context context,
InitializationCompleteCallback initializationCompleteCallback,
List<MediationConfiguration> mediationConfigurations) {
// Initialize your ad network's SDK.
...
// Invoke the InitializationCompleteCallback once initialization completes.
initializationCompleteCallback.onInitializationSucceeded();
}
collectSignals()
টাইমআউট: ১ সেকেন্ড
প্রকাশক যখনই কোনও বিজ্ঞাপনের অনুরোধ করেন, আপনার RtbAdapter-এর একটি নতুন ইনস্ট্যান্স
তৈরি করা হয় এবং collectSignals() পদ্ধতি কল করা হয়। বিজ্ঞাপনের অনুরোধ, উত্তর এবং
সেই বিজ্ঞাপনের রেন্ডারিং লাইফসাইকেলের সময়সীমার জন্য
RtbAdapter-এর এই ইনস্ট্যান্স ব্যবহার করা হবে। collectSignals() পদ্ধতি আপনার অ্যাডাপ্টারকে ডিভাইস থেকে সিগন্যাল প্রদান করতে দেয় যা OpenRTB অনুরোধে আপনার বিডারকে পাঠানো হয়।
collectSignals() ব্যাকগ্রাউন্ড থ্রেডে কল করা হয়েছে। Google Mobile Ads SDK (Legacy)
বিডিংয়ে অংশগ্রহণকারী সব অ্যাডাপ্টারের থেকে
একই সাথে সিগন্যাল চায়। এই সময় UI থ্রেডে কল করার সময় শ্রদ্ধাশীল থাকুন এবং
কলের সংখ্যা সীমিত করুন। সিগন্যাল সংগ্রহ করার জন্য আপনার অ্যাডাপ্টার বা SDK-কে যে ভারী কাজ করতে হবে, তা initialize() পদ্ধতিতে করা উচিত এবং ক্যাশে করা উচিত।
আপনার সিগন্যাল রেডি হয়ে গেলে, এনকোড করা সিগন্যাল সহ onSuccess() কলব্যাক
কল করুন।
এখানে একটি উদাহরণ দেওয়া হল:
@Override
public void collectSignals(RtbSignalData rtbSignalData,
SignalCallbacks signalCallbacks) {
String signals = YourSdk.getSignals();
signalCallbacks.onSuccess(signals);
}
আপনার অ্যাডাপ্টার সিগন্যাল সংগ্রহ করতে না পারলে, signalCallbacks.onFailure()
কল করুন এবং যে সমস্যা হয়েছে তা ব্যাখ্যা করে একটি স্ট্রিং পাঠান।
বিজ্ঞাপন লোড করার পদ্ধতি প্রয়োগ করা
টাইমআউট: ১০ সেকেন্ড
আপনার বিডার জয়ী বিড ফিরিয়ে দিলে, Google Mobile Ads SDK (Legacy) জয়ী বিজ্ঞাপন লোড করার জন্য আপনার অ্যাডাপ্টারকে কল করে, আপনার বিডার ফিরিয়ে দেওয়া যেকোনও ডেটা আপনাকে পাস করে, যা আপনার SDK-এর সেই বিজ্ঞাপন লোড করার জন্য প্রয়োজন।
ঠিক কোন লোড পদ্ধতি কল করা হবে তা নির্ভর করে এই অনুরোধটি যে বিজ্ঞাপন ফর্ম্যাটের জন্য করা হয়েছে তার উপর:
| বিজ্ঞাপন ফর্ম্যাট | লোড পদ্ধতি |
|---|---|
| ব্যানার | loadBannerAd()
|
| স্থান | loadInterstitialAd()
|
| পুরস্কার জিতেছেন | loadRewardedAd()
|
আপনার অ্যাডাপ্টারে কাজ করে এমন বিজ্ঞাপন ফর্ম্যাটের জন্য এইসব পদ্ধতি প্রয়োগ করুন।
লোড পদ্ধতিটি UI থ্রেডে কল করা হয়, যে অ্যাডাপ্টার থেকে আপনি সিগন্যাল প্রদান করেছেন তার একই ইনস্ট্যান্সে। এই পদ্ধতি আপনাকে নিম্নলিখিত প্যারামিটার প্রদান করে:
একটি
MediationAdConfiguration, যাতে এমন প্যারামিটার থাকে যা আপনার SDK-এর জন্য প্রয়োজন বিজয়ী বিডের জন্য বিজ্ঞাপন লোড করুন, যেমন বিড রেসপন্স এবং যেকোনও ক্রেডেনশিয়াল AdMob UI-তে প্রকাশক কনফিগার করেছেন।Google Mobile Ads SDK (Legacy)-কে জানানোর জন্য ব্যবহৃত একটি
MediationAdLoadCallbackঅবজেক্ট যখন লোডিং সফল হয় বা ব্যর্থ হয়।
আপনার SDK বিজ্ঞাপন লোড করার পরে, mediationAdLoadCallback.onSuccess() কল করুন। বিজ্ঞাপন লোড করার সময় কোনও সমস্যা হলে, যে সমস্যা হয়েছে তা ব্যাখ্যা করে একটি স্ট্রিং সহ mediationAdLoadCallback.onFailure() কল করুন।
mediationAdLoadCallback.onSuccess() পদ্ধতিতে আপনাকে এমন একটি অবজেক্ট পাস করতে হবে যা Google Mobile Ads SDK দ্বারা সংজ্ঞায়িত "বিজ্ঞাপন" ইন্টারফেসের মধ্যে কোনও একটির সাথে কনফার্ম করে। এইসব বিজ্ঞাপন ইন্টারফেস আপনাকে বিজ্ঞাপন সম্পর্কে কিছু তথ্য দিতে বলে।
এছাড়াও, MediationAdConfiguration-এ getWatermark()
পদ্ধতি আছে যা PNG ছবিকে উপস্থাপন করে এমন base64-এনকোড করা স্ট্রিং ফিরিয়ে দেয়। এই ছবি
আপনার বিজ্ঞাপনে স্বচ্ছ ওভারলেতে টাইল করা উচিত।
ওয়াটারমার্ক কীভাবে রেন্ডার করতে হয় সেই সম্পর্কে অতিরিক্ত নির্দেশিকার জন্য Google-এর সাথে যোগাযোগ করুন।
এতে দেখানো বিজ্ঞাপনের সোর্স নির্ধারণ করার জন্য প্রকাশকদের ব্যবহারের জন্য দেখানো বিজ্ঞাপন সম্পর্কে মেটাডেটা থাকে।
ব্যানারের ক্ষেত্রে, আপনাকে ব্যানার ভিউ দিতে বলা হবে। ইন্টারস্টিশিয়াল ও
পুরস্কার প্রদানকারী বিজ্ঞাপনের ক্ষেত্রে, আপনাকে পরে কোনও সময়ে বিজ্ঞাপন দেখানোর জন্য show() পদ্ধতি প্রয়োগ করতে বলা হবে। পেশাদার পদ্ধতি হিসেবে, আমরা সাজেস্ট করি যে আপনার ক্লাস যা
বিজ্ঞাপন লোড করে, সেটি যেন এই বিজ্ঞাপন পদ্ধতি প্রয়োগ করার জন্যও দায়ী থাকে।
loadBannerAd()-এর স্যাম্পেল প্রয়োগ নিচে দেওয়া হল। মনে রাখবেন
যে আপনার অ্যাডাপ্টারের প্রয়োগ আলাদা দেখাবে, কারণ আপনার অ্যাডাপ্টার
অন্য SDK-এর সাথে ইন্টিগ্রেট করে।
public final class SampleRtbAdapter extends RtbAdapter {
...
@Override
public void loadBannerAd(
MediationBannerAdConfiguration adConfiguration,
MediationAdLoadCallback<MediationBannerAd, MediationBannerAdCallback> callback) {
SampleBannerRenderer bannerRenderer =
new SampleBannerRenderer(adConfiguration, callback);
bannerRenderer.render();
}
}
// Renders a banner ad, and forwards callbacks to Google Mobile Ads SDK (Legacy).
public class SampleBannerRenderer implements MediationBannerAd {
private MediationBannerAdConfiguration adConfiguration;
private final MediationAdLoadCallback<MediationBannerAd, MediationBannerAdCallback> adLoadCallback;
private AdView adView;
private MediationBannerAdCallback callback;
public SampleRtbBannerRenderer(
MediationBannerAdConfiguration adConfiguration,
MediationAdLoadCallback<MediationBannerAd, MediationBannerAdCallback> adLoadCallback) {
this.adConfiguration = adConfiguration;
this.adLoadCallback = adLoadCallback;
}
public void render() {
adView = new AdView(adConfiguration.getContext());
adView.setAdSize(adConfiguration.getAdSize());
// serverParameters are the parameters entered in the AdMob UI for your network.
adView.setAdUnitId(adConfiguration.getServerParameters().getString("adUnitId"));
// Map the callbacks from your SDK to Google's SDK.
adView.setAdListener(new AdListener() {
// See the next step for more information on callback mapping.
// ...
});
// Get the bid response and watermark from the ad configuration and
// pass the relevant information to your SDK.
String ad = adConfiguration.getBidResponse();
String watermark = adConfiguration.getWatermark();
Bundle extras = new Bundle();
extras.putString("bid", ad);
extras.putString("watermark", watermark);
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build();
adView.loadAd(request);
}
// MediationBannerAd implementation
@NonNull
@Override
public View getView() {
return adView;
}
}
বিজ্ঞাপন প্রেজেন্টেশন লাইফসাইকেল ইভেন্ট রিলে করুন
অ্যাডাপ্টারের চূড়ান্ত দায়িত্ব হল যেকোনও প্রেজেন্টেশন লাইফসাইকেল ইভেন্ট সম্পর্কে Google Mobile Ads SDK (Legacy)-কে জানানো, যাতে সেগুলি প্রকাশকের কাছে ফরওয়ার্ড করা যায়। প্রকাশক আশা করেন যে কোন বিজ্ঞাপন নেটওয়ার্ক বিজ্ঞাপনটি পরিবেশন করছে তা নির্বিশেষে নির্দিষ্ট সময়ে এই কলব্যাকগুলি করা হবে, তাই যতটা সম্ভব এই কলব্যাকগুলি সঠিক সময়ে করা গুরুত্বপূর্ণ, যাতে Google Mobile Ads SDK (Legacy) সেগুলি প্রকাশকের কাছে ফরওয়ার্ড করতে পারে।
প্রযোজ্য হলে অ্যাডাপ্টারকে নিম্নলিখিত ইভেন্টগুলি ইনভোক করতে হবে:
| সব ফর্ম্যাটের জন্য সাধারণ | |
|---|---|
| পদ্ধতি | কখন কল করতে হবে |
reportAdClicked()
|
বিজ্ঞাপনে ক্লিক করা হয়েছে। |
reportAdImpression()
|
বিজ্ঞাপনটি একটি ইম্প্রেশন রেন্ডার করেছে। |
onAdOpened()
|
বিজ্ঞাপনটি ফুল স্ক্রিন ভিউতে দেখানো হয়েছে। |
onAdClosed()
|
বিজ্ঞাপনের ফুল-স্ক্রিন ভিউ বন্ধ করা হয়েছে। |
onAdLeftApplication()
|
বিজ্ঞাপনের কারণে ব্যবহারকারী অ্যাপ্লিকেশন ছেড়ে চলে গেছেন। |
| পুরস্কার প্রদানকারী বিজ্ঞাপন | |
onRewarded()
|
ব্যবহারকারীকে পুরস্কার দেওয়া হয়েছে। |
| ভিডিও কলব্যাক (পুরস্কার প্রদানকারী ও নেটিভ বিজ্ঞাপন) | |
onVideoStarted()
|
বিজ্ঞাপনের ভিডিও শুরু হয়েছে। |
onVideoCompleted()
|
বিজ্ঞাপনের ভিডিও শেষ হয়েছে। |
mediationAdLoadCallback.onSuccess() কল করার পরে অ্যাডাপ্টার একটি MediationAdLoadCallback<MediationAdT, MediationAdCallbackT>
অবজেক্ট ফেরত পায়। অ্যাডাপ্টার এই অবজেক্ট ধরে রাখবে এবং আপনার বিজ্ঞাপনে হওয়া প্রেজেন্টেশন ইভেন্টকে ইনভোক করতে এটি ব্যবহার করবে বলে আশা করা হয়।
সাধারণত, এইসব ইভেন্টের বেশিরভাগই আপনার বিজ্ঞাপন নেটওয়ার্কের SDK দ্বারা পরিচালিত হয়। অ্যাডাপ্টারের ভূমিকা হল আপনার বিজ্ঞাপন নেটওয়ার্ক SDK থেকে Google Mobile Ads SDK (Legacy)-এ কলব্যাক ম্যাপ করা।
নিম্নলিখিত উদাহরণ থেকে আপনি জানতে পারবেন যে কীভাবে আপনার SDK-এর বিজ্ঞাপন লিসেনার থেকে Google Mobile Ads SDK (Legacy)-এ কলব্যাক ফরওয়ার্ড করবেন:
adView.setAdListener(new AdListener() {
public void onAdLoaded() {
callback = adLoadCallback.onSuccess(SampleBannerRenderer.this);
}
public void onAdImpression() {
if (callback != null) {
callback.reportAdImpression();
}
}
public void onAdFailedToLoad(LoadAdError adError) {
adLoadCallback.onFailure("Error: " + adError.toString());
}
public void onAdClosed() {
if (callback != null) {
callback.onAdClosed();
}
}
public void onAdOpened() {
if (callback != null) {
callback.onAdOpened();
callback.reportAdClicked();
}
}
public void onAdLeftApplication() {
if (callback != null) {
callback.onAdLeftApplication();
}
}
});
নেটিভ বিজ্ঞাপনের ইম্প্রেশন ট্র্যাক করার জন্য প্রয়োজনীয় অ্যাসেট
বিজ্ঞাপনের ১ পিক্সেল দেখা গেলে, Google Mobile Ads SDK (Legacy) নেটিভ বিজ্ঞাপনের জন্য একটি ইম্প্রেশন রেকর্ড করে। আপনার বিজ্ঞাপন নেটওয়ার্ক SDK-এর যদি সঠিক ইম্প্রেশন রেন্ডার করার জন্য নির্দিষ্ট অ্যাসেট দেখানোর প্রয়োজন হয়, তাহলে আপনার বিডার বিড রেসপন্সে এইসব প্রয়োজনীয় নেটিভ অ্যাসেট উল্লেখ করতে পারে। Google Mobile Ads SDK (Legacy) তারপর যাচাই করে যে ইম্প্রেশন রেকর্ড করার আগে আপনার প্রয়োজনীয় নেটিভ অ্যাসেট দেখানো হয়েছে কিনা।
বিড উত্তরে কীভাবে অতিরিক্ত প্রয়োজনীয় অ্যাসেট উল্লেখ করতে হয় সেই সম্পর্কে আরও তথ্যের জন্য নেটিভ প্রয়োজনীয় অ্যাসেট ডকুমেন্টেশন দেখুন।
বিজ্ঞাপন সংক্রান্ত সমস্যা দেখুন
ইন্টারস্টিশিয়াল ও পুরস্কার প্রদানকারী বিজ্ঞাপনের মতো ফুল স্ক্রিন ফর্ম্যাটের ক্ষেত্রে, লোড কলব্যাক সফল হলে আপনি
MediationInterstitialAd
বা MediationRewardedAd
প্রয়োগ করবেন যাতে Google Mobile Ads SDK (Legacy) আপনার অ্যাডাপ্টারকে বিজ্ঞাপন দেখানোর জন্য বলতে পারে।
Google Mobile Ads SDK (Legacy) আশা করে যে, কোনও অ্যাডাপ্টার সফলভাবে বিজ্ঞাপন লোড করলে, প্রকাশক বিজ্ঞাপন দেখানোর জন্য অনুরোধ করলে সেটি দেখানোর জন্য রেডি থাকে। এর অর্থ হল, প্রতিটি শো কলের ফলে একটি ইম্প্রেশন তৈরি হতে হবে।
তবে, কিছু ক্ষেত্রে আপনি বিজ্ঞাপন দেখাতে নাও পারেন। আপনি
বিজ্ঞাপন দেখাতে না পারলে, ইম্প্রেশন বাতিল করতে
onAdFailedToShow()
কলব্যাক কল করুন।
ফুল স্ক্রিন বিজ্ঞাপন ফর্ম্যাটের জন্য প্রেজেন্টেশন কলব্যাক কীভাবে ইম্প্রেশন রেকর্ডিংকে প্রভাবিত করে তা নিচের সারণীতে দেখানো হয়েছে:
| কলব্যাক | ফলাফল |
|---|---|
| onAdOpened() | Impression recorded
|
| onAdFailedToShow() | Impression failure1
|
| কয়েক সেকেন্ডের জন্য উপরের কোনওটিই নয় | Impression recorded
|
১ ইম্প্রেশন ব্যর্থ হলে, আপনার বিজ্ঞাপন নেটওয়ার্ককে ইম্প্রেশনের জন্য চার্জ করা হয় না, তবে এটি আপনার বিলেবল ইভেন্ট রেট অ্যাডজাস্টমেন্টকে প্রভাবিত করে। আরও তথ্যের জন্য বিড অনুরোধ সংকেত দেখুন।
নিম্নলিখিত মক উদাহরণে লোড/শো লাইফসাইকেল দেখানো হয়েছে যেখানে বিজ্ঞাপন দেখানোর কল ব্যর্থ হতে পারে।
final class SampleRtbAdapter extends RtbAdapter implements MediationRewardedAd {
private MediationRewardedAdCallback callback;
private RewardedAd rewardedAd;
...
@Override
public void loadRewardedAd(
MediationRewardedAdConfiguration adConfiguration,
final MediationAdLoadCallback<MediationRewardedAd, MediationRewardedAdCallback> loadCallback) {
// Load an ad. This mock example uses Google's SDK, but in practice
// your adapter will load the ad using your ad network's SDK.
RewardedAd.load(adConfiguration.getContext(),
"ca-app-pub-3940256099942544/5224354917",
new AdRequest.Builder().build(),
new RewardedAdLoadCallback() {
@Override
public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
// When the ad loads, invoke the load success callback.
callback = loadCallback.onSuccess(SampleRtbAdapter.this);
}
});
}
@Override
public void showAd(Context context) {
// In this mock example, your ad network requires an activity context, but
// didn't receive one, making you unable to show the ad.
if (!(context instanceof Activity)) {
AdError error = new AdError(1, "Context must be an activity",
"com.google.ads.mediation.sample");
callback.onAdFailedToShow(error);
}
// This example shows Google SDK's callbacks, but it's likely your SDK
// has similar presentation callbacks.
rewardedAd.setFullScreenContentCallback(new FullScreenContentCallback() {
@Override
public void onAdShowedFullScreenContent() {
// Your ad network SDK successfully showed the ad. Call onAdOpened().
callback.onAdOpened();
}
@Override
public void onAdFailedToShowFullScreenContent(AdError adError) {
// Your ad network SDK failed to show the ad, invoke onAdFailedToShow.
// In practice, you will map your SDK's error to an AdError.
AdError error = new AdError(adError.getCode(), adError.getMessage(),
adError.getDomain());
callback.onAdFailedToShow(adError);
}
});
rewardedAd.show((Activity) context, ...);
}
}