การรวมคำขอโฆษณาเนทีฟที่แสดงผลที่กำหนดเองและโฆษณาแบนเนอร์

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

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

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 11.0.0 ขึ้นไป
• ทำขั้นตอนเริ่มต้นใช้งานให้เสร็จสมบูรณ์

กำลังโหลดโฆษณา

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

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

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

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/nativeandbanner")
    .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, and so on.
      }
    })
    .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, "/6499/example/nativeandbanner")
    .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, and so on.
      }
    })
    .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 ที่ระบุ

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

การตั้งค่า 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()