این راهنما برای ناشران در نظر گرفته شده است که فراداده تبلیغات را با Google Mobile Ads SDK برای Android ادغام می کنند.
پیش نیازها
- حداقل نسخه 17.0.0 Google Mobile Ads SDK.
- مراحل را در ویدیوی پاداشی کامل کنید.
واکشی ابرداده آگهی
برخی از برنامه‌ها ممکن است بخواهند درباره تبلیغاتی که ارائه شده‌اند بیشتر بدانند. می‌توانید با فراخوانی RewardedVideoAd.setAdMetadataListener() با اجرای AdMetadataListener به تغییرات فراداده آگهی در تبلیغات ویدیویی دارای پاداش گوش دهید. هنگامی که AdMetadataListener.onAdMetadataChanged() فراخوانی شد، می توانید RewardedVideo.getAdMetadata() برای فراداده های یک آگهی بررسی کنید.
onAdMetadataChanged() درست پس از بارگیری آگهی یا زمانی که ابرداده آن به صورت ناهمزمان پس از بارگیری تغییر می کند فراخوانی می شود. تضمینی وجود ندارد که ابرداده یک آگهی در زمان بارگیری آگهی در دسترس باشد، بنابراین توصیه می‌کنیم قبل از دسترسی به فراداده آگهی منتظر این تماس باشید.
در اینجا یک نمونه کد نشان می دهد که چگونه می توان ابرداده تبلیغات را بازیابی کرد:
جاوا
RewardedAd.load(this, "/6499/example/rewarded", new AdManagerAdRequest.Builder().build(),
new RewardedAdLoadCallback() {
@Override
public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
mRewardedAd = rewardedAd;
rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() {
@Override
public void onAdMetadataChanged() {
Bundle metadata = rewardedAd.getAdMetadata();
String adId = metadata.getString("AdId");
}
});
}
});
کاتلین
RewardedAd.load(this, "/6499/example/rewarded", AdManagerAdRequest.Builder().build(),
object : RewardedAdLoadCallback() {
override fun onAdLoaded(rewardedAd: RewardedAd) {
mRewardedAd = rewardedAd
rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener {
val metadata = rewardedAd.adMetadata
val adId = metadata.getString("AdId")
}
}
})
پس از بازیابی متادیتا، می‌توانید Bundle را برای یافتن کلیدهایی که برایتان مهم هستند بررسی کنید. انواع مختلف تبلیغات ممکن است دارای کلیدهای فراداده تبلیغات متفاوتی باشند. تبلیغات ویدیویی VAST دارای کلیدهای زیر هستند:
Key | تایپ کنید | شرح |
|---|---|---|
AdId | رشته | شناسه آگهی در صورت موجود نبودن خالی است. |
AdTitle | رشته | عنوان، اگر مشخص نشده باشد خالی است. |
CreativeDurationMs | عدد صحیح | مدت زمان خلاقیت انتخاب شده بر حسب میلی ثانیه، -1 اگر غیرخطی باشد. |
TraffickingParameters | رشته | پارامترهای قاچاق، اگر در دسترس نباشد خالی است. |
DealId | رشته | اولین شناسه معامله موجود در زنجیره بسته بندی آگهی فعلی، از بالا شروع می شود - اگر در دسترس نباشد خالی است. |
AdSystem | رشته | سرور آگهی منبع آگهی، در صورت موجود نبودن خالی است. |
CreativeId | رشته | شناسه خلاقیت انتخاب شده برای تبلیغ، در صورت موجود نبودن خالی است. |
MediaURL | رشته | URL رسانه انتخاب شده. |
Wrappers | آرایه | آرایه با عناصری پر شده است که از درونی‌ترین آگهی بسته‌بندی شروع می‌شوند (نزدیک به آگهی درون خطی) و به سمت بیرونی‌ترین آگهی بسته‌بندی حرکت می‌کنند. هر عنصر در آرایه یک فرهنگ لغت است که حاوی کلیدها و مقادیر زیر است.
|