รวมคำขอโฆษณาเนทีฟและโฆษณาแบนเนอร์

คุณสามารถรวมโฆษณาเนทีฟและโฆษณาแบนเนอร์ไว้ในคำขอโฆษณาได้โดยทำการเปลี่ยนแปลงโค้ดเพียงเล็กน้อย

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

Google Mobile Ads SDK เวอร์ชัน 11.0.0 ขึ้นไป

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

โหลดโฆษณา

ระบบจะโหลดโฆษณาเนทีฟที่แสดงผลแบบกำหนดเองโดยใช้คลาส AdLoader ซึ่งมีคลาส AdLoader.Builder ของตัวเองเพื่อปรับแต่งโฆษณาในระหว่างการสร้าง การเพิ่ม Listener ลงใน AdLoader ขณะสร้างจะช่วยให้แอประบุประเภทรูปแบบโฆษณาที่พร้อมรับได้ จากนั้น AdLoader จะขอเฉพาะโฆษณาประเภทดังกล่าว

นอกจากนี้ คุณยังกำหนดค่าออบเจ็กต์ AdLoader เพื่อส่งคำขอโฆษณาที่อาจส่งผลให้แสดงโฆษณาแบนเนอร์หรือโฆษณาเนทีฟก็ได้ การเพิ่ม OnAdManagerAdViewLoadedListener ลงใน AdLoader ขณะสร้างจะระบุว่าโฆษณาแบนเนอร์ควรแข่งขันกับโฆษณาเนทีฟเพื่อแสดงโฆษณาตามคำขอ

โค้ดต่อไปนี้แสดงวิธีสร้าง AdLoader ที่สามารถโหลดโฆษณาเนทีฟหรือโฆษณาแบนเนอร์ในคำขอเดียว

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native-and-banner")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
      @Override
      public void onNativeAdLoaded(NativeAd nativeAd) {
        // Show the ad.
      }
    })
    .forAdManagerAdView(new OnAdManagerAdViewLoadedListener() {
      @Override
      public void onAdManagerAdViewLoaded(AdManagerAdView adView) {
        // Show the banner ad.
      }
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(new AdListener() {
      @Override
      public void onAdFailedToLoad(LoadAdError error) {
        // Handle the failure by logging, altering the UI, etc.
      }
    })
    .withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native-and-banner")
    .forNativeAd { nativeAd ->
      // Show the ad.
    }
    .forAdManagerAdView({ adView ->
      // Show the banner ad.
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(object: AdListener() {
      override fun onAdFailedToLoad(adError: LoadAdError) {
        // Handle the failure by logging, altering the UI, etc.
      }
    })
    .withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build()

เมธอด forAdManagerAdView() จะเตรียม AdLoader ให้พร้อมรับโฆษณาแบนเนอร์ คุณต้องระบุรายการขนาดโฆษณาที่ถูกต้องซึ่งมีความยาวผันแปรได้พร้อมกับ OnAdManagerAdViewLoadedListener เมื่อเรียกใช้ forAdManagerAdView()

คุณต้องระบุขนาดโฆษณาที่ถูกต้องอย่างน้อย 1 ขนาดจึงจะส่งคำขอโฆษณาที่ถูกต้องได้ เมื่อโหลดโฆษณาแบนเนอร์สำเร็จ ระบบจะเรียกใช้เมธอด onAdManagerAdViewLoaded() ของออบเจ็กต์ Listener ที่ระบุ

ตั้งค่าออบเจ็กต์ AdViewOptions

ฟังก์ชันสุดท้ายที่รวมอยู่ในการสร้าง AdLoader คือเมธอด withAdManagerAdViewOptions() ซึ่งเป็นอีกเมธอดที่ไม่บังคับ

Java

.withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

Kotlin

.withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

ออบเจ็กต์ AdManagerAdViewOptions ช่วยให้ผู้เผยแพร่โฆษณาสามารถตั้งค่าตัวเลือกที่เฉพาะเจาะจงสำหรับโฆษณาแบนเนอร์ที่โหลดโดย AdLoader ได้ เช่น

setManualImpressionsEnabled(): เปิดใช้การรายงานการแสดงผลด้วยตนเองสำหรับการจอง Google Ad Manager แอปที่ใช้การแสดงผลด้วยตนเองสามารถกำหนดได้เองว่าจะบันทึกการแสดงผลเมื่อใด และทำได้โดยการเรียกใช้ AdManagerAdView.recordManualImpression()