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

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

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

قبل المتابعة، يُرجى اتّباع الخطوات التالية:

التكامل

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

إذا كنت تستخدم أشكال إعلانات مدمَجة مع المحتوى مخصّصة تتضمّن مادة عرض فيديو، لن تحتاج إلى اتّباع هذا الدليل، لأنّ حزمة تطوير البرامج (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.