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

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

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

قبل المتابعة، يُرجى تنفيذ ما يلي:

التكامل

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

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

عليك أيضًا إخبار حزمة 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.