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

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

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

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

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

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

قد تريد بعض التطبيقات معرفة المزيد من المعلومات عن الإعلانات التي تم عرضها. يمكنك الاستماع إلى التغييرات في البيانات الوصفية للإعلانات في إعلانات الفيديو التي تضم مكافآت من خلال استدعاء RewardedVideoAd.setAdMetadataListener() باستخدام تنفيذ AdMetadataListener. بعد استدعاء AdMetadataListener.onAdMetadataChanged()، يمكنك التحقّق من RewardedVideo.getAdMetadata() للاطّلاع على البيانات الوصفية للإعلان.

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