قالب‌های آگهی بومی سفارشی نوع «نمایشی» و «اندازه‌گیری باز»

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

پیش‌نیازها

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

یکپارچه‌سازی

اگر قصد دارید از اندازه‌گیری باز با قالب‌های آگهی بومی سفارشی که دارایی ویدیویی ندارند استفاده کنید، خودتان مسئول فراخوانی «میاناهای برنامه‌سازی کاربردی اندازه‌گیری باز» خواهید بود.

اگر از قالب‌های آگهی بومی سفارشی با دارایی ویدیویی استفاده می‌کنید، نیازی نیست این راهنما را دنبال کنید؛ «کیت توسعه نرم‌افزار تبلیغات تلفن همراه» رؤیت‌پذیری دارایی ویدیویی را ازطرف شما ردیابی می‌کند.

بار کردن آگهی

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

جاوا

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() را برای ثبت نمای محتوی با اندازه‌گیری باز ارائه می‌دهد.

همچنین باید به کیت توسعه نرم‌افزار بگویید که اندازه‌گیری آگهی‌تان را شروع کند. برای انجام این کار، روش 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 را تکمیل نکنید، داده‌هایتان گواهی نخواهد شد.