AbstractAdRequestBuilder

Kotlin |Java

abstract class AbstractAdRequestBuilder<T : AbstractAdRequestBuilder<T!>?>

คลาสย่อยโดยตรงที่ทราบ

AdManagerAdRequest.Builder, AdRequest.Builder

AdManagerAdRequest.Builder	สร้าง AdManagerAdRequest
AdRequest.Builder	สร้าง AdRequest

---

คลาส Base Builder เพื่อช่วยสร้างคำขอโฆษณา

สรุป

ฟังก์ชันสาธารณะ
T!	@CanIgnoreReturnValue addCustomEventExtrasBundle(     adapterClass: Class<CustomEvent!>!,     customEventExtras: Bundle! ) ฟังก์ชันนี้เลิกใช้งานแล้ว โปรดใช้ addNetworkExtrasBundle แทน
T!	@CanIgnoreReturnValue addCustomTargeting(key: String!, value: String!) เพิ่มพารามิเตอร์การกำหนดเป้าหมายที่กำหนดเอง
T!	@CanIgnoreReturnValue addCustomTargeting(key: String!, values: (Mutable)List<String!>!) เพิ่มพารามิเตอร์การกำหนดเป้าหมายที่กำหนดเองที่มีหลายค่า
T!	@CanIgnoreReturnValue addKeyword(keyword: String!) เพิ่มคีย์เวิร์ดเพื่อวัตถุประสงค์ในการกำหนดเป้าหมาย
T!	@CanIgnoreReturnValue addNetworkExtrasBundle(     adapterClass: Class<MediationExtrasReceiver!>!,     networkExtras: Bundle! ) เพิ่มพารามิเตอร์เพิ่มเติมเพื่อส่งไปยัง Ad Network Adapter ที่เฉพาะเจาะจง
T!	@CanIgnoreReturnValue setAdString(adString: String!) ตั้งค่าสตริงโฆษณาที่แสดงถึงการตอบกลับโฆษณา
T!	@CanIgnoreReturnValue setContentUrl(contentUrl: String!) ตั้งค่า URL ของเนื้อหาสำหรับเว็บไซต์ที่มีเนื้อหาตรงกับเนื้อหาหลักของแอป
T!	@CanIgnoreReturnValue setHttpTimeoutMillis(httpTimeoutMillis: Int) ตั้งค่าการหมดเวลาที่กำหนดเองสำหรับการเรียก HTTPS ที่ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ทำในระหว่างคำขอโฆษณา
T!	@CanIgnoreReturnValue setNeighboringContentUrls(     neighboringContentUrls: (Mutable)List<String!>! ) ตั้งค่า URL ที่แสดงถึงเนื้อหาเว็บที่อยู่ใกล้โฆษณา
T!	@CanIgnoreReturnValue setPlacementId(placementId: Long) ตั้งค่ารหัสตำแหน่งเริ่มต้นสำหรับโฆษณาที่โหลด
T!	@CanIgnoreReturnValue setRequestAgent(requestAgent: String!) ตั้งค่าสตริงตัวแทนคำขอเพื่อระบุแหล่งที่มาของคำขอโฆษณา

ฟังก์ชันที่ป้องกันไว้
abstract T!	self() แสดงผลอินสแตนซ์ของตัวเองของประเภทข้อมูลย่อยที่ระบุ

ฟังก์ชันสาธารณะ

addCustomEventExtrasBundle

@CanIgnoreReturnValue
fun addCustomEventExtrasBundle(
    adapterClass: Class<CustomEvent!>!,
    customEventExtras: Bundle!
): T!

ฟังก์ชันนี้เลิกใช้งานแล้ว

โปรดใช้ addNetworkExtrasBundle แทน

เพิ่มพารามิเตอร์พิเศษเพื่อส่งไปยังอแดปเตอร์เหตุการณ์ที่กําหนดเองที่เฉพาะเจาะจง

พารามิเตอร์
adapterClass: Class<CustomEvent!>!	Class ของอะแดปเตอร์เหตุการณ์ที่กําหนดเองที่คุณกําลังระบุข้อมูลเพิ่มเติม
customEventExtras: Bundle!	Bundle ข้อมูลเพิ่มเติมที่จะส่งไปยังอแดปเตอร์เหตุการณ์ที่กําหนดเอง

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, value: String!): T!

เพิ่มพารามิเตอร์การกำหนดเป้าหมายที่กำหนดเอง การเรียกใช้ฟังก์ชันนี้เป็นครั้งที่ 2 ด้วยคีย์เดียวกันจะเขียนทับค่าเก่า

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, values: (Mutable)List<String!>!): T!

เพิ่มพารามิเตอร์การกำหนดเป้าหมายที่กำหนดเองที่มีหลายค่า การเรียกใช้ฟังก์ชันนี้เป็นครั้งที่ 2 ด้วยคีย์เดียวกันจะเขียนทับค่าเก่า

addKeyword

@CanIgnoreReturnValue
fun addKeyword(keyword: String!): T!

เพิ่มคีย์เวิร์ดเพื่อวัตถุประสงค์ในการกำหนดเป้าหมาย

addNetworkExtrasBundle

@CanIgnoreReturnValue
fun addNetworkExtrasBundle(
    adapterClass: Class<MediationExtrasReceiver!>!,
    networkExtras: Bundle!
): T!

เพิ่มพารามิเตอร์เพิ่มเติมเพื่อส่งไปยัง Ad Network Adapter ที่เฉพาะเจาะจง

พารามิเตอร์
adapterClass: Class<MediationExtrasReceiver!>!	Classของอะแดปเตอร์ที่ควรได้รับส่วนเสริม
networkExtras: Bundle!	Bundle ข้อมูลเพิ่มเติมที่จะส่งไปยังตัวกลางการแสดงโฆษณา

setAdString

@CanIgnoreReturnValue
fun setAdString(adString: String!): T!

ตั้งค่าสตริงโฆษณาที่แสดงถึงการตอบกลับโฆษณา หากตั้งค่าไว้ SDK จะแสดงโฆษณานี้และไม่สนใจข้อมูลการกำหนดเป้าหมายอื่นๆ ทั้งหมดที่ตั้งค่าไว้ในคำขอนี้

setContentUrl

@CanIgnoreReturnValue
fun setContentUrl(contentUrl: String!): T!

ตั้งค่า URL ของเนื้อหาสำหรับเว็บไซต์ที่มีเนื้อหาตรงกับเนื้อหาหลักของแอป เนื้อหาเว็บไซต์นี้ใช้เพื่อวัตถุประสงค์ในการกำหนดเป้าหมายและความปลอดภัยของแบรนด์

การขว้าง
java.lang.NullPointerException	หาก contentUrl เป็น {code null}
java.lang.IllegalArgumentException	หาก contentUrl ว่างเปล่าหรือมีความยาวเกิน 512

setHttpTimeoutMillis

@CanIgnoreReturnValue
fun setHttpTimeoutMillis(httpTimeoutMillis: Int): T!

ตั้งค่าการหมดเวลาที่กำหนดเองสำหรับการเรียก HTTPS ที่ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ทำในระหว่างคำขอโฆษณา

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

พารามิเตอร์
httpTimeoutMillis: Int	จำนวนเต็มที่ระบุการหมดเวลา HTTPS เป็นมิลลิวินาที ระบบจะไม่สนใจค่าที่ต่ำกว่า 5000 (5 วินาที) ค่าเริ่มต้นคือ 60000 (60 วินาที)

setNeighboringContentUrls

@CanIgnoreReturnValue
fun setNeighboringContentUrls(
    neighboringContentUrls: (Mutable)List<String!>!
): T!

ตั้งค่า URL ที่แสดงถึงเนื้อหาเว็บที่อยู่ใกล้โฆษณา ส่งเสริมความปลอดภัยของแบรนด์และอนุญาตให้โฆษณาที่แสดงมีการจัดประเภทระดับแอป (MA, T, PG ฯลฯ) ซึ่งเหมาะสมกับเนื้อหาที่อยู่ข้างเคียงมากขึ้น

พารามิเตอร์
neighboringContentUrls: (Mutable)List<String!>!	รายการ URL ของเนื้อหาที่เกี่ยวข้องซึ่งจะแนบไปกับ URL ของเนื้อหาที่เกี่ยวข้องที่มีอยู่

setPlacementId

@CanIgnoreReturnValue
fun setPlacementId(placementId: Long): T!

ตั้งค่ารหัสตำแหน่งเริ่มต้นสำหรับโฆษณาที่โหลด

สำหรับโฆษณาแบนเนอร์ เราขอแนะนำให้ใช้ setPlacementId แทน การเรียกใช้ loadAd ด้วยคำขอที่ตั้งค่ารหัสตำแหน่งจะมีผลเหมือนกับการเรียกใช้ setPlacementId

พารามิเตอร์
placementId: Long	จำนวนเต็มแบบยาวที่ UI ของ AdMob ระบุสำหรับตําแหน่งที่กําหนดค่า

setRequestAgent

@CanIgnoreReturnValue
fun setRequestAgent(requestAgent: String!): T!

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

ฟังก์ชันที่ป้องกันไว้

ตนเอง

protected abstract fun self(): T!

แสดงผลอินสแตนซ์ของตัวเองของประเภทข้อมูลย่อยที่ระบุ