هذا الدليل موجَّه للناشرين الذين يدمجون البيانات الوصفية للإعلانات مع حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لنظام التشغيل Android.
المتطلبات الأساسية
- الحد الأدنى للإصدار 17.0.0 من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- أكمِل الخطوات الواردة في فيديو بمكافأة.
جارٍ استرجاع البيانات الوصفية للإعلان
قد تريد بعض التطبيقات معرفة المزيد عن الإعلانات التي تم عرضها. يمكنك الاستماع إلى التغييرات في البيانات الوصفية للإعلانات على إعلانات الفيديو التي تضم مكافأة من خلال الاتصال بـ RewardedVideoAd.setAdMetadataListener()
مع تنفيذ AdMetadataListener
. بعد استدعاء AdMetadataListener.onAdMetadataChanged()
، يمكنك التحقق من RewardedVideo.getAdMetadata()
بحثًا عن البيانات الوصفية للإعلان.
يتم استدعاء onAdMetadataChanged()
بعد تحميل الإعلان مباشرةً أو عندما تتغير بياناته الوصفية بشكل غير متزامن بعد تحميلها. وليس من المضمون
أن تكون البيانات الوصفية للإعلان متوفّرة في وقت تحميل
الإعلان، لذا ننصح بانتظار معاودة الاتصال هذه قبل الوصول إلى البيانات الوصفية
للإعلان.
في ما يلي مثال على رمز يوضّح كيفية استرداد البيانات الوصفية للإعلان:
Java
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"); } }); } });
Kotlin
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") } } })
بعد استرداد البيانات الوصفية، يمكنك التحقق من الحزمة بحثًا عن المفاتيح التي تهمك. قد يكون لأنواع الإعلانات المختلفة مفاتيح مختلفة للبيانات الوصفية للإعلان مرتبطة بها. تحتوي إعلانات الفيديو بتنسيق VAST على المفاتيح التالية:
Key |
Type | الوصف |
---|---|---|
AdId |
سلسلة | رقم تعريف الإعلان، فارغًا إذا لم يكن متاحًا. |
AdTitle |
سلسلة | حقل العنوان فارغ في حال عدم تحديده |
CreativeDurationMs |
عدد صحيح | مدة تصميم الإعلان المحدّدة بالمللي ثانية، -1 إذا لم تكن خطية. |
TraffickingParameters |
سلسلة | مَعلمات عدد الزيارات، فارغة إذا لم تكن متوفّرة |
DealId |
سلسلة | رقم تعريف الصفقة الأول المتوفّر في سلسلة برامج تضمين للإعلان الحالي، بدءًا من أعلى قيمة فارغة إذا لم يكن متاحًا. |
AdSystem |
سلسلة | خادم الإعلان المصدر للإعلان، فارغًا إذا لم يكن متاحًا. |
CreativeId |
سلسلة | رقم تعريف تصميم الإعلان المحدّد للإعلان، فارغًا إذا لم يكن متاحًا. |
MediaURL |
سلسلة | تمثّل هذه السمة عنوان URL للوسائط المحدّدة. |
Wrappers |
مصفوفة |
تتم تعبئة المصفوفة بعناصر تبدأ من إعلان الالتفاف الداخلي
(بالقرب من الإعلان المضمّن) وتنتقل إلى خارج الإعلان الخارجي. كل عنصر في المصفوفة هو قاموس يحتوي على المفاتيح والقيم التالية.
|