لمناقشة منتجاتنا وتقديم ملاحظات بشأنها، انضمّ إلى قناة Discord الرسمية في "مدير إعلانات Google" على خادم منتدى Google للإعلان والقياس.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

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

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

يتم طلب onAdMetadataChanged() بعد تحميل إعلان مباشرةً أو عند تغيير بياناته الوصفية بشكل غير متزامن بعد تحميله. ولا نضمن توفّر البيانات الوصفية للإعلان عند تحميله، لذا ننصحك بالانتظار إلى أن يتم تنفيذ عملية معاودة الاتصال هذه قبل الوصول إلى البيانات الوصفية للإعلان.

في ما يلي مثال على الرمز البرمجي الذي يوضّح كيفية استرداد بيانات وصفية للإعلان:

Java

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` String. معرّف الإعلان المستخدَم في الإعلان الغلافي، ويكون فارغًا إذا لم يكن متاحًا. `AdSystem` String. نظام الإعلانات المستخدَم في الإعلان المغلّف، ويكون فارغًا إذا لم يكن متاحًا. `CreativeId` String. معرّف تصميم الإعلان المستخدَم في الإعلان الإطاري، ويكون فارغًا إذا لم يكن متاحًا.