قالب‌های تبلیغات بومی سفارشی نوع نمایش و اندازه‌گیری باز

این راهنما نحوه ادغام قالب‌های تبلیغات بومی سفارشی با اندازه‌گیری باز را توضیح می‌دهد.

پیش نیازها

قبل از ادامه، موارد زیر را انجام دهید:

یکپارچه سازی

اگر قصد دارید از اندازه‌گیری باز با قالب‌های تبلیغات بومی سفارشی که حاوی دارایی ویدیویی نیستند استفاده کنید، خودتان مسئول فراخوانی Open Measurement API هستید.

اگر از قالب‌های تبلیغات بومی سفارشی با دارایی ویدیویی استفاده می‌کنید، نیازی به پیروی از این راهنما ندارید. SDK تبلیغات تلفن همراه قابلیت مشاهده دارایی ویدیو را از طرف شما ردیابی می کند.

یک تبلیغ را بارگیری کنید

چه از اندازه‌گیری باز استفاده کنید یا نه، بارگذاری یک تبلیغ یکسان است. در اینجا روشی وجود دارد که نحوه درخواست یک آگهی بومی سفارشی را نشان می دهد:

جاوا 

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());
}

CustomNativeOMIDSnippets.java

کاتلین 

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())
}

CustomNativeOMIDSnippets.kt

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();
  }
}
CustomNativeOMIDSnippets.java

کاتلین 

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

CustomNativeOMIDSnippets.kt