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

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

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

قبل المتابعة، يُرجى اتّخاذ الإجراءات التالية:

التكامل

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

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

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

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

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

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

Kotlin

@MainThread
private fun displayCustomNativeAd(
  customNativeAd: CustomNativeAd,
  nativeAdViewContainer: FrameLayout,
) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  val displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement()
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer)
    displayOpenMeasurement.start()
  }
}

جافا

@MainThread
private void displayCustomNativeAd(
    CustomNativeAd customNativeAd, FrameLayout nativeAdViewContainer) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  DisplayOpenMeasurement displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer);
    displayOpenMeasurement.start();
  }
}

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

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

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

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