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

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

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 على المفاتيح التالية: