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

اختيار النظام الأساسي: Android جديد Android iOS

هذا الدليل مخصّص للناشرين الذين يدمجون "البيانات الوصفية للإعلان" مع حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لنظام Android.

المتطلبات الأساسية

  • الإصدار 17.0.0 على الأقل من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • إكمال الخطوات في مقالة فيديو بمكافأة.

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

لمعرفة المزيد عن الإعلانات المعروضة، استمِع إلى التغييرات في البيانات الوصفية للإعلانات في "إعلانات الفيديو بمكافأة".

يتم استدعاء 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");
          }
        });
      }
    });

Kotlin

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 عدد صحيح مدة تصميم الإعلان المحدّدة بالملّي ثانية، وتكون -1 إذا كان تصميم الإعلان غير خطي
TraffickingParameters سلسلة معلّمات إدارة الحملات الإعلانية، وتكون فارغة إذا لم تكن متوفّرة
DealId سلسلة رقم تعريف الصفقة الأول الموجود في برنامج التضمين للإعلان الحالي، بدءًا من الأعلى، ويكون فارغًا إذا لم يكن متوفّرًا.
AdSystem سلسلة خادم الإعلان المصدر للإعلان، ويكون فارغًا إذا لم يكن متوفّرًا
CreativeId سلسلة رقم تعريف تصميم الإعلان المحدّد للإعلان، ويكون فارغًا إذا لم يكن متوفّرًا
MediaURL سلسلة عنوان URL للوسائط المحدّدة
Wrappers مصفوفة يتم ملء المصفوفة بالعناصر بدءًا من الإعلان المغلّف الأقرب (القريب من الإعلان المضمّن) والانتقال إلى الإعلان المغلّف الأبعد. كل عنصر في المصفوفة هو قاموس يحتوي على المفاتيح والقيم التالية.
AdId
سلسلة. رقم تعريف الإعلان المستخدَم للإعلان المغلّف، ويكون فارغًا إذا لم يكن متوفّرًا
AdSystem
سلسلة. نظام الإعلان المستخدَم للإعلان المغلّف، ويكون فارغًا إذا لم يكن متوفّرًا
CreativeId
سلسلة. رقم تعريف تصميم الإعلان المستخدَم للإعلان المغلّف، ويكون فارغًا إذا لم يكن متوفّرًا