هذا الدليل مخصّص للناشرين الذين يدمجون بيانات تعريف الإعلان مع حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لنظام Android.
المتطلبات الأساسية
- الإصدار 17.0.0 على الأقل من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
- إكمال الخطوات الواردة في مقالة "إعلان الفيديو مقابل مكافأة".
جلب بيانات تعريف الإعلان
لمعرفة المزيد عن الإعلانات المعروضة، يمكنك الاستماع إلى التغييرات في بيانات تعريف الإعلان على "إعلانات الفيديو مقابل مكافأة".
يتم استدعاء onAdMetadataChanged() مباشرةً بعد تحميل إعلان أو عند تغيير بياناته الوصفية بشكل غير متزامن بعد تحميله. لا نضمن توفّر بيانات تعريف الإعلان في وقت تحميله، لذا ننصحك بالانتظار إلى حين استلام معاودة الاتصال هذه قبل الوصول إلى بيانات تعريف الإعلان.
في ما يلي مثال على رمز برمجي يوضّح كيفية استرداد بيانات تعريف الإعلان:
Kotlin
RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
override fun onAdLoaded(ad: RewardedAd) {
...
ad.adEventCallback = object : RewardedAdEventCallback {
override fun onAdMetadataChanged() {
val metadata = ad.adMetadata
val adId = metadata.getString("AdId")
}
}
}
})
جافا
RewardedAd.load(
new AdRequest.Builder("AD_UNIT_ID").build(),
new AdLoadCallback<RewardedAd>() {
@Override
public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
Rewarded.this.rewardedAd = rewardedAd;
...
rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
@Override
public void onAdMetadataChanged() {
Bundle metadata = rewardedAd.getAdMetadata();
String adId = metadata.getString("AdId");
}
});
};
};
);
استبدِل AD_UNIT_ID بالمعرّف الخاص بالوحدة الإعلانية. على سبيل المثال، /21775744923/example/rewarded للإعلانات مقابل مكافأة
بعد استرداد البيانات الوصفية، يمكنك التحقّق من `Bundle` بحثًا عن المفاتيح التي تهمّك. قد يكون لأنواع الإعلانات المختلفة مفاتيح مختلفة لبيانات تعريف الإعلان مرتبطة بها. تحتوي "إعلانات الفيديو المستندة إلى نموذج عرض إعلانات الفيديو (VAST)" على المفاتيح التالية:
Key |
النوع | الوصف |
|---|---|---|
AdId |
سلسلة | رقم تعريف الإعلان، ويكون فارغًا إذا لم يكن متوفّرًا |
AdTitle |
سلسلة | العنوان، ويكون فارغًا إذا لم يتم تحديده |
CreativeDurationMs |
عدد صحيح | مدة تصميم الإعلان المحدّدة بالملّي ثانية، وتكون -1 إذا كان تصميم الإعلان غير خطي |
TraffickingParameters |
سلسلة | معلّمات إدارة الحملات الإعلانية، وتكون فارغة إذا لم تكن متوفّرة |
DealId |
سلسلة | رقم تعريف الصفقة الأول الموجود في برنامج التضمين للإعلان الحالي، بدءًا من الأعلى، ويكون فارغًا إذا لم يكن متوفّرًا. |
AdSystem |
سلسلة | خادم الإعلان المصدر للإعلان، ويكون فارغًا إذا لم يكن متوفّرًا |
CreativeId |
سلسلة | رقم تعريف تصميم الإعلان المحدّد للإعلان، ويكون فارغًا إذا لم يكن متوفّرًا |
MediaURL |
سلسلة | عنوان URL للوسائط المحدّدة |
Wrappers |
مصفوفة |
يتم ملء المصفوفة بالعناصر بدءًا من الإعلان المغلّف الأقرب
(القريب من الإعلان المضمّن) والانتقال إلى الإعلان المغلّف الأبعد. كل
عنصر في المصفوفة هو قاموس يحتوي على المفاتيح والقيم التالية.
|