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

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

پیش‌نیازها

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

ادغام

اگر قصد دارید از اندازه‌گیری باز با قالب‌های تبلیغاتی بومی سفارشی که حاوی محتوای ویدیویی نیستند استفاده کنید، خودتان مسئول فراخوانی 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