MobileAds

Kotlin |Java

class MobileAds

คลาสมีตรรกะที่ใช้กับ Google Mobile Ads SDK โดยรวม ขณะนี้ระบบจะใช้วิธีการเดียวในการเริ่มต้น

สรุป

ค่าคงที่
`const String!`	`ERROR_DOMAIN = "com.google.android.gms.ads"` ชื่อโดเมนข้อผิดพลาดเริ่มต้นสำหรับ Google Mobile Ads SDK

ฟังก์ชันสาธารณะ
`java-static Unit`	`disableMediationAdapterInitialization(context: Context!)` เรียกใช้ก่อน `initialize` หรือคำขอโฆษณาแรกเพื่อปิดใช้การเริ่มต้นใช้งาน AdMob Mediation Adapter
`java-static InitializationStatus?`	`getInitializationStatus()` รับสถานะการเริ่มต้น SDK
`java-static RequestConfiguration`	`getRequestConfiguration()` รับ `RequestConfiguration` ทั่วโลก
`java-static VersionInfo!`	`getVersion()` รับเวอร์ชันภายนอก (เช่น 20.6.0) ของ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
`java-static Unit`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(context: Context!)` เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
`java-static Unit`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
`java-static Unit`	`openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!)` เปิด UI ของเครื่องมือตรวจสอบโฆษณา
`java-static Unit`	`openDebugMenu(context: Context!, adUnitId: String!)` เปิดเมนูแก้ไขข้อบกพร่อง
`java-static Boolean`	`putPublisherFirstPartyIdEnabled(enabled: Boolean)` ควบคุมว่าจะเปิดใช้รหัสบุคคลที่หนึ่งของผู้เผยแพร่โฆษณาใน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google หรือไม่ ซึ่งก่อนหน้านี้เรียกว่าคีย์แอปเดียวกัน
`java-static CustomTabsSession?`	`registerCustomTabsSession( context: Context, client: CustomTabsClient, origin: String, callback: CustomTabsCallback? )` ลงทะเบียน `CustomTabsClient` กับ Google Mobile Ads SDK เพื่อปรับปรุงการสร้างรายได้จากโฆษณาในแอปของโฆษณาภายใน `CustomTabsSession` นี้
`java-static Unit`	`registerWebView(webview: WebView)` ลงทะเบียน `WebView` กับ Google Mobile Ads SDK เพื่อปรับปรุงการสร้างรายได้จากโฆษณาในแอปของโฆษณาภายใน `WebView` นี้
`java-static Unit`	`setAppMuted(muted: Boolean)` ระบุว่าแอปพลิเคชันปิดเสียงอยู่หรือไม่
`java-static Unit`	`setAppVolume(volume: Float)` ตั้งค่าระดับเสียงของแอปพลิเคชัน
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` ตั้งค่า `RequestConfiguration` ส่วนกลางที่จะใช้กับทุก `AdRequest` ในเซสชันของแอป
`java-static Unit`	`startPreload( context: Context, preloadConfigurations: (Mutable)List<PreloadConfiguration!>, preloadCallback: PreloadCallback )` ฟังก์ชันนี้เลิกใช้งานแล้ว โปรดใช้ `start` หรือ `start` แทน

ค่าคงที่

ERROR_DOMAIN

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

ชื่อโดเมนข้อผิดพลาดเริ่มต้นสำหรับ Google Mobile Ads SDK

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

disableMediationAdapterInitialization

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

เรียกใช้ก่อน initialize หรือคำขอโฆษณาแรกเพื่อปิดใช้การเริ่มต้นใช้งาน AdMob Mediation Adapter เมธอดนี้จะไม่มีผลเมื่อมีการเรียกใช้ initialize หรือส่งคำขอโฆษณาแรก

คำเตือน: การเรียกใช้เมธอดนี้อาจส่งผลเสียต่อประสิทธิภาพสื่อกลาง ควรเรียกใช้วิธีนี้เฉพาะในกรณีที่คุณรวม AdMob Mediation Adapter ไว้ในแอป แต่ไม่ได้วางแผนที่จะใช้ AdMob Mediation ในระหว่างเซสชันของแอปนี้ (เช่น คุณกำลังทำการทดสอบ A/B)

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

รับสถานะการเริ่มต้น SDK

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

รับ RequestConfiguration ทั่วโลก

getVersion

java-static fun getVersion(): VersionInfo!

รับเวอร์ชันภายนอก (เช่น 20.6.0) ของ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

ไม่จำเป็นต้องเรียกใช้ initialize ก่อนฟังก์ชันนี้

เริ่มต้น

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

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

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

พารามิเตอร์
`context: Context!`	`Context` ที่ SDK ทำงานอยู่

เริ่มต้น

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

เริ่มต้น SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

พารามิเตอร์
`context: Context!`	กิจกรรมที่ SDK ทำงานอยู่ `Context`
`listener: OnInitializationCompleteListener!`	Callback ที่จะเรียกใช้เมื่อการเริ่มต้นเสร็จสมบูรณ์

openAdInspector

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

เปิด UI ของเครื่องมือตรวจสอบโฆษณา

openDebugMenu

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

เปิดเมนูแก้ไขข้อบกพร่อง ต้องเรียกใช้ initialize ก่อนฟังก์ชันนี้

พารามิเตอร์
`context: Context!`	กิจกรรมที่ SDK ทำงานอยู่ `Context`
`adUnitId: String!`	รหัสหน่วยโฆษณา Ad Manager ที่เชื่อมโยงกับแอป

putPublisherFirstPartyIdEnabled

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

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

โดยจะเปิดใช้รหัสโดยค่าเริ่มต้น เมื่อปิดใช้ การตั้งค่าจะยังคงอยู่ตลอดเซสชันของแอปและระบบจะล้างรหัส

ต้องเรียกใช้ initialize ก่อนฟังก์ชันนี้

พารามิเตอร์
`enabled: Boolean`	บูลีนเป็นจริงหากเปิดใช้รหัสบุคคลที่หนึ่งของผู้เผยแพร่โฆษณา หรือเป็นเท็จในกรณีอื่นๆ

การคืนสินค้า
`Boolean`	เป็นจริงหากบันทึกการตัดสินใจสำเร็จ เป็นเท็จหากบันทึกไม่สำเร็จ

registerCustomTabsSession

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

ลงทะเบียน CustomTabsClient กับ Google Mobile Ads SDK เพื่อปรับปรุงการสร้างรายได้จากโฆษณาในแอปของโฆษณาภายใน CustomTabsSession นี้ การดำเนินการนี้จะสร้างอินสแตนซ์ของ CustomTabsSession เพียงอินสแตนซ์เดียว และการเรียกใช้ซ้ำจะลบล้างเซสชันที่มีอยู่

พารามิเตอร์
`context: Context`	`Context` ที่ SDK ทำงานอยู่
`client: CustomTabsClient`	`CustomTabsClient` ที่ใช้สร้างอินสแตนซ์ `CustomTabsSession`
`origin: String`	สตริงที่ใช้เป็นต้นทางในลิงก์เนื้อหาดิจิทัลสำหรับการยืนยัน
`callback: CustomTabsCallback?`	`CustomTabsCallback` (ไม่บังคับ) เพื่อรับสายโทรกลับจาก `CustomTabsSession`

การคืนสินค้า
`CustomTabsSession?`	`CustomTabsSession` เพื่อใช้สำหรับ Intent ของแท็บที่กำหนดเองเมื่อเปิดหน้าแท็บที่กำหนดเอง

registerWebView

java-static fun registerWebView(webview: WebView): Unit

ลงทะเบียน WebView กับ Google Mobile Ads SDK เพื่อปรับปรุงการสร้างรายได้จากโฆษณาในแอปของโฆษณาภายใน WebView นี้

setAppMuted

java-static fun setAppMuted(muted: Boolean): Unit

ระบุว่าแอปพลิเคชันปิดเสียงอยู่หรือไม่ มีผลต่อสถานะปิดเสียงเริ่มต้นสำหรับโฆษณาทั้งหมด

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

พารามิเตอร์
`muted: Boolean`	เป็นจริงหากปิดเสียงแอปไว้ เป็นเท็จหากไม่ได้ปิดเสียง ค่าเริ่มต้นคือ false

setAppVolume

java-static fun setAppVolume(volume: Float): Unit

ตั้งค่าระดับเสียงของแอปพลิเคชัน ส่งผลต่อระดับเสียงของโฆษณาทั้งหมดเมื่อเทียบกับเอาต์พุตเสียงอื่นๆ

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

พารามิเตอร์
`volume: Float`	ระดับเสียงเป็นแบบลอยตั้งแต่ 0 (ปิดเสียง) ถึง 1.0 (ระดับเสียงสื่อเต็ม) ค่าเริ่มต้นคือ 1.0

ส่ง
`java.lang.IllegalArgumentException`	หากระดับเสียงอยู่นอกช่วงที่ถูกต้อง

setRequestConfiguration

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

ตั้งค่า RequestConfiguration ส่วนกลางที่จะใช้กับทุก AdRequest ในเซสชันของแอป

startPreload

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

เริ่มโหลดโฆษณาล่วงหน้าสำหรับการกำหนดค่าที่ระบุ

ขณะนี้ API การโหลดโฆษณาล่วงหน้าอยู่ในเวอร์ชันอัลฟ่าแบบจำกัด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อสอบถามข้อมูลเพิ่มเติม

พารามิเตอร์
`context: Context`	`Context` ที่ SDK ทำงานอยู่
`preloadConfigurations: (Mutable)List<PreloadConfiguration!>`	การกำหนดค่าเพื่อโหลดโฆษณาล่วงหน้า
`preloadCallback: PreloadCallback`	Callback ที่จะเรียกใช้เมื่อความพร้อมใช้งานของโฆษณาเปลี่ยนแปลงสำหรับการกำหนดค่าการโหลดล่วงหน้าแต่ละรายการ