تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

البيانات الوصفية للإعلان

هذا الدليل مخصّص للناشرين الذين يدمجون البيانات الوصفية للإعلانات مع حزمة "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 لـ "الإعلانات مقابل مكافأة".

بعد استرداد البيانات الوصفية، يمكنك التحقّق من الحزمة بحثًا عن المفاتيح التي تهمّك. قد تكون هناك مفاتيح مختلفة للبيانات الوصفية للإعلانات مرتبطة بأنواع مختلفة من الإعلانات. تحتوي إعلانات الفيديو على شكل VAST على المفاتيح التالية:

`Key`	النوع	الوصف
`AdId`	سلسلة	رقم تعريف الإعلان، ويكون فارغًا في حال عدم توفّره
`AdTitle`	سلسلة	العنوان، ويكون فارغًا إذا لم يتم تحديده
`CreativeDurationMs`	عدد صحيح	مدة تصميم الإعلان المحدّد بالمللي ثانية، أو ‎-1 إذا كان غير خطي
`TraffickingParameters`	سلسلة	مَعلمات إدارة الحملات، وتكون فارغة في حال عدم توفّرها
`DealId`	سلسلة	رقم تعريف الصفقة الأول في سلسلة برنامج تضمين الإعلان الحالي، بدءًا من الأعلى، ويكون فارغًا في حال عدم توفّره
`AdSystem`	سلسلة	خادم الإعلانات المصدر للإعلان، ويكون فارغًا إذا لم يكن متاحًا.
`CreativeId`	سلسلة	رقم تعريف تصميم الإعلان المحدّد للإعلان، ويكون فارغًا إذا لم يكن متاحًا
`MediaURL`	سلسلة	عنوان URL للوسائط المحدّدة
`Wrappers`	مصفوفة	تتم تعبئة الصفيف بعناصر تبدأ من الإعلان التغليفي الأقرب إلى الإعلان المضمّن، ثم تنتقل إلى الخارج وصولاً إلى الإعلان التغليفي الأبعد. كل عنصر في المصفوفة هو قاموس يحتوي على المفاتيح والقيم التالية. `AdId` String. معرّف الإعلان المستخدَم لإعلان تضمين، ويكون فارغًا إذا لم يكن متاحًا `AdSystem` String. نظام الإعلانات المستخدَم للإعلان المغلِّف، ويكون فارغًا في حال عدم توفّره `CreativeId` String. رقم تعريف تصميم الإعلان المستخدَم لإعلان تضمين، ويكون فارغًا إذا لم يكن متاحًا.