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

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

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

الدمج

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

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

تحميل إعلان

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

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

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

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

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

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

public void  registerOpenMeasurementAndShowAd(NativeCustomFormatAd ad) {

...
// Show ad
...
displayCustomFormatAd(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 هو حاوية الإعلان NativeCustomFormatAd ويجب أن يحتوي على كل الأصول داخل مربع الإحاطة المنظر.

الحصول على شهادة اعتماد من IAB

بعد إصدار تطبيقك، ستبدأ في تلقّي بيانات القياس. وَلَكِنْ فلن يتم اعتماد بياناتك حتى تكمل عملية الحصول على شهادة IAB.