این راهنما برای ناشرانی در نظر گرفته شده است که می‌خواهند متادیتای تبلیغات (Ad Metadata) را با SDK تبلیغات موبایلی گوگل برای اندروید (Google Mobile Ads SDK) ادغام کنند.
پیش‌نیازها
- حداقل نسخه ۱۷.۰.۰ از SDK تبلیغات موبایلی گوگل.
- مراحل موجود در ویدیوی پاداش‌دار را تکمیل کنید.
دریافت فراداده‌های تبلیغ
برای کسب اطلاعات بیشتر در مورد تبلیغات ارائه شده، به تغییرات ابرداده تبلیغات در تبلیغات ویدیویی جایزه‌دار توجه کنید.
تابع onAdMetadataChanged() درست پس از بارگذاری یک تبلیغ یا زمانی که متادیتای آن پس از بارگذاری به صورت ناهمگام تغییر می‌کند، فراخوانی می‌شود. تضمینی وجود ندارد که متادیتای یک تبلیغ در زمان بارگذاری آن در دسترس باشد، بنابراین توصیه می‌کنیم قبل از دسترسی به متادیتای یک تبلیغ، منتظر این فراخوانی باشید.
در اینجا یک مثال کد وجود دارد که نحوه بازیابی ابرداده تبلیغ را نشان می‌دهد:
جاوا
RewardedAd.load(this, "/21775744923/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, "/21775744923/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") } } })
پس از بازیابی فراداده، می‌توانید بسته را برای کلیدهای مورد نظر خود بررسی کنید. انواع مختلف تبلیغات ممکن است کلیدهای فراداده تبلیغاتی متفاوتی داشته باشند. تبلیغات ویدیویی VAST کلیدهای زیر را دارند:
Key | نوع | توضیحات |
|---|---|---|
AdId | رشته | شناسه آگهی، در صورت عدم وجود، خالی است. |
AdTitle | رشته | عنوان، در صورت عدم تعیین، خالی است. |
CreativeDurationMs | عدد صحیح | مدت زمان خلاقیت انتخاب شده بر حسب میلی ثانیه، در صورت غیرخطی بودن -۱. |
TraffickingParameters | رشته | پارامترهای قاچاق، در صورت عدم وجود، خالی. |
DealId | رشته | اولین شناسه معامله موجود در زنجیره پوششی برای تبلیغ فعلی، از بالا شروع می‌شود - در صورت موجود نبودن، خالی است. |
AdSystem | رشته | سرور تبلیغاتی منبع تبلیغ، در صورت عدم دسترسی، خالی است. |
CreativeId | رشته | شناسه‌ی آگهی تبلیغاتی انتخاب‌شده، در صورت موجود نبودن، خالی است. |
MediaURL | رشته | آدرس اینترنتی (URL) رسانه انتخاب شده. |
Wrappers | آرایه | این آرایه با عناصری که از داخلی‌ترین پوشه (نزدیک به پوشه درون‌خطی) شروع می‌شوند و به سمت بیرونی‌ترین پوشه حرکت می‌کنند، پر شده است. هر عنصر در آرایه یک دیکشنری است که شامل کلیدها و مقادیر زیر است.
|