أشكال الإعلانات المدمجة مع المحتوى المخصّصة لنوع العرض والقياس المفتوح

يوضِّح هذا الدليل كيفية دمج أشكال إعلانات مدمجة مع المحتوى مخصّصة مع القياس المفتوح.

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

الدمج

إذا كنت تخطّط لاستخدام القياس المفتوح مع أشكال الإعلانات المدمجة مع المحتوى المخصّصة التي لا تحتوي على مادة عرض فيديو، ستكون مسؤولاً عن استدعاء واجهات Open Measurement API بنفسك. لا يتوفّر القياس المفتوح لأشكال الإعلانات المدمجة مع المحتوى المخصّصة من النوع الشبكة الإعلانية إلا في الإصدار 18.1.1 والإصدارات الأحدث من حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة.

إذا كنت تستخدِم أشكال إعلانات مدمجة مع المحتوى مخصّصة مع مادة عرض فيديو، لن تحتاج إلى اتّباع هذا الدليل، لأنّ حزمة "SDK لإعلانات الأجهزة الجوّالة" تعمل على تتبُّع إمكانية عرض مادة عرض الفيديو نيابةً عنك.

لنلقِ نظرة الآن على كيفية استخدام القياس المفتوح مع NativeCustomTemplateAd. بوجهٍ عام، يجب تنبيه حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة عندما تريد بدء قياس إمكانية العرض وتسجيل مشاهدة إعلانك المخصّصة.

تحميل إعلان

يكون تحميل الإعلان مماثلاً سواء كنت تستخدم القياس المفتوح أم لا. في ما يلي طريقة توضّح كيفية طلب NativeCustomTemplateAd:

public void loadAd() {
   AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
    .forCustomTemplateAd("YOUR-TEMPLATE-ID",
      new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
          @Override
          public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
              // Register your view and begin open measurement.
              // We will define this method below.
              MyActivity.this.registerOpenMeasurementAndShowAd(ad);
          }
      },
      new NativeCustomTemplateAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomTemplateAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();
}

تسجيل طريقة العرض وبدء القياس

لتفعيل القياس المفتوح على NativeCustomTemplateAd، سجِّل عرض الإعلان المخصّص باستخدام العنصر DisplayOpenMeasurement المرتبط بالعنصر NativeCustomTemplateAd. يوفّر الكائن DisplayOpenMeasurement طريقة setView() لتسجيل عرض الحاوية باستخدام القياس المفتوح.

عليك أيضًا إعلام حزمة تطوير البرامج (SDK) صراحةً ببدء قياس إعلانك. ولإجراء ذلك، عليك استدعاء الإجراء start() في الكائن DisplayOpenMeasurement في NativeCustomTemplateAd. ويجب استدعاء الطريقة start() من سلسلة التعليمات الرئيسية، ولن يكون لعمليات الاستدعاء اللاحقة أي تأثير.

إليك كيف تبدو علامة التبويب هذه:

public void  registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {

...
// Show ad
...
displayCustomTemplateAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();

}

تجدر الإشارة إلى أنّه يجب عرض إعلانك قبل تسجيل طريقة العرض. عرض إعلانك مغطى بأشكال الإعلانات المخصّصة المدمجة المدمجة.

التنسيق customTemplateAdFrame هو حاوية الإعلان من أجل NativeCustomTemplateAd ويجب أن يحتوي على جميع مواد العرض داخل المربّع المحيط بطريقة العرض.

الحصول على شهادة الاعتماد من مكتب الإعلانات التفاعلية (IAB)

بعد إصدار تطبيقك، ستبدأ في تلقّي بيانات القياس. ومع ذلك، لن يتم اعتماد بياناتك إلى أن تُكمل عملية اعتماد مكتب الإعلانات التفاعلية (IAB).