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

هذا الدليل موجَّه للناشرين الذين يدمجون البيانات الوصفية للإعلانات مع حزمة "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 مصفوفة تتم تعبئة المصفوفة بعناصر تبدأ من إعلان الالتفاف الداخلي (بالقرب من الإعلان المضمّن) وتنتقل إلى خارج الإعلان الخارجي. كل عنصر في المصفوفة هو قاموس يحتوي على المفاتيح والقيم التالية.
AdId
سلسلة: رقم تعريف الإعلان مُستخدَم لإعلان برنامج تضمين، فارغًا إذا لم يكن متاحًا.
AdSystem
سلسلة: نظام إعلان مُستخدَم لإعلان الالتفاف، فارغًا إذا لم يكن متاحًا.
CreativeId
سلسلة: رقم تعريف تصميم الإعلان مُستخدَم لإعلان الالتفاف، ويكون فارغًا إذا لم يكن متاحًا.