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

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

اختيار النظام الأساسي: Android iOS Android (الإصدار القديم)

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