ใช้แบนเนอร์แบบยุบได้

โฆษณาแบนเนอร์แบบยุบได้คือโฆษณาแบนเนอร์ที่แสดงเป็นโฆษณาซ้อนทับขนาดใหญ่ในตอนแรก โดยมีปุ่มให้ยุบเป็นขนาดแบนเนอร์ที่ขอไว้เดิม โฆษณาแบนเนอร์แบบยุบได้มีไว้เพื่อปรับปรุงประสิทธิภาพของโฆษณา Anchor ที่มีขนาดเล็กกว่า คู่มือนี้จะแสดงวิธีเปิดโฆษณาแบนเนอร์แบบยุบได้สําหรับพื้นที่โฆษณาแบนเนอร์ที่มีอยู่

ข้อกำหนดเบื้องต้น

• ทำตามคู่มือเริ่มต้นใช้งานโฆษณาแบนเนอร์ให้เสร็จสมบูรณ์

การใช้งาน

ตรวจสอบว่าได้กําหนดมุมมองแบนเนอร์ด้วยขนาดที่ต้องการให้ผู้ใช้เห็นในสถานะแบนเนอร์ปกติ (ยุบ) ใส่พารามิเตอร์พิเศษในคําขอโฆษณาโดยใช้ collapsible เป็นคีย์และพื้นที่โฆษณาเป็นค่า

พื้นที่โฆษณาแบบยุบได้จะกําหนดวิธีตรึงภูมิภาคที่ขยายไว้กับโฆษณาแบนเนอร์

หากโฆษณาที่โหลดเป็นแบนเนอร์แบบยุบได้ แบนเนอร์จะแสดงโฆษณาซ้อนทับแบบยุบได้ทันทีเมื่อวางไว้ในลำดับชั้นการแสดงผล

private fun loadBannerAd() {
  // ...

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val bannerAdRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize)
    .setGoogleExtrasBundle(extras)
    .build()

  BannerAd.load(
    bannerAdRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // ...
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        // ...
      }
    },
  )
}

private void loadBannerAd() {
  // ...

  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  BannerAdRequest bannerAdRequest = new BannerAdRequest.Builder("AD_UNIT_ID", adSize)
      .setGoogleExtrasBundle(extras)
      .build();

  BannerAd.load(
      bannerAdRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // ...
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          // ...
        }
      });
}

ลักษณะการทำงานของการรีเฟรชโฆษณา

สําหรับแอปที่กําหนดค่าการรีเฟรชอัตโนมัติสําหรับโฆษณาแบนเนอร์ในอินเทอร์เฟซเว็บของ Ad Manager เมื่อมีการขอโฆษณาแบนเนอร์แบบยุบได้สําหรับช่องแบนเนอร์ การรีเฟรชโฆษณาครั้งต่อๆ ไปจะไม่ขอโฆษณาแบนเนอร์แบบยุบได้ เนื่องจากการแสดงแบนเนอร์แบบยุบได้ทุกครั้งที่รีเฟรชอาจส่งผลเสียต่อประสบการณ์ของผู้ใช้

หากต้องการโหลดโฆษณาแบนเนอร์แบบยุบได้อีกรายการในเซสชันในภายหลัง คุณสามารถโหลดโฆษณาด้วยตัวเองพร้อมคําขอที่มีพารามิเตอร์ที่ยุบได้

ตรวจสอบว่าโฆษณาที่โหลดเป็นแบบยุบได้หรือไม่

โฆษณาแบนเนอร์แบบยุบไม่ได้มีสิทธิ์แสดงสําหรับคําขอแบนเนอร์แบบยุบได้เพื่อเพิ่มประสิทธิภาพให้ได้สูงสุด เรียก isCollapsible เพื่อตรวจสอบว่าแบนเนอร์ล่าสุดที่โหลดเป็นแบบยุบได้หรือไม่ หากคําขอโหลดล้มเหลวและแบนเนอร์ก่อนหน้าเป็นแบบยุบได้ API จะแสดงผลค่า true

override fun onAdLoaded(ad: BannerAd) {
  // ...
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible."
  )
}

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  // ...
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.",
      ad.isCollapsible() ? "" : "not "));
}

สื่อกลาง

โฆษณาแบนเนอร์แบบยุบได้ใช้ได้กับดีมานด์จาก Google เท่านั้น โฆษณาที่แสดงผ่านสื่อกลางจะแสดงเป็นโฆษณาแบนเนอร์ปกติแบบยุบไม่ได้