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

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

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

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

التكامل

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

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

تحميل إعلان

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

جافا

private void loadCustomNativeAd(Context context, ViewGroup nativeCustomFormatAdContainer) {

  AdLoader adLoader =
      new AdLoader.Builder(context, "AD_UNIT_ID")
          .forCustomFormatAd(
              "CUSTOM_TEMPLATE_ID",
              new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
                @Override
                public void onCustomFormatAdLoaded(@NonNull NativeCustomFormatAd ad) {
                  // Show the ad first and then register your view and begin open measurement.
                  // Make sure to do this on the main thread.

                  // ...
                  // Show ad
                  // ...

                  startOpenMeasurement(ad, nativeCustomFormatAdContainer);
                }
              },
              new NativeCustomFormatAd.OnCustomClickListener() {
                @Override
                public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
                  // Handle the click action
                }
              })
          .build();
  adLoader.loadAd(new AdRequest.Builder().build());
}

Kotlin

private fun loadCustomNativeAd(context: Context, nativeCustomFormatAdContainer: ViewGroup) {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forCustomFormatAd(
        "CUSTOM_TEMPLATE_ID",
        NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->
          // Show the ad first and then register your view and begin open measurement. Make sure
          // to do this on the main thread.

          // ...
          // Show ad
          // ...

          startOpenMeasurement(ad, nativeCustomFormatAdContainer)
        },
        NativeCustomFormatAd.OnCustomClickListener { ad, assetName ->
          // Handle the click action.
        },
      )
      .build()

  adLoader.loadAd(AdRequest.Builder().build())
}

استبدِل AD_UNIT_ID وCUSTOM_TEMPLATE_ID برقم تعريف الوحدة الإعلانية ورقم تعريف النموذج المخصّص.

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

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

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

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

جافا

private void startOpenMeasurement(
    NativeCustomFormatAd ad, ViewGroup nativeCustomFormatAdContainer) {
  DisplayOpenMeasurement displayOpenMeasurement = ad.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer);
    displayOpenMeasurement.start();
  }
}

Kotlin

private fun startOpenMeasurement(
  ad: NativeCustomFormatAd,
  nativeCustomFormatAdContainer: ViewGroup,
) {
  ad.getDisplayOpenMeasurement()?.let { displayOpenMeasurement ->
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer)
    displayOpenMeasurement.start()
  }
}

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

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

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

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