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 หรือคําขอโฆษณาแรกเพื่อปิดใช้การเริ่มต้นการทำงานของอะแดปเตอร์สื่อกลาง
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 หรือคําขอโฆษณาแรกเพื่อปิดใช้การเริ่มต้นการทำงานของอะแดปเตอร์สื่อกลาง วิธีการนี้จะใช้งานไม่ได้เมื่อ initialize หรือมีการสร้างคําขอโฆษณาแรก

คำเตือน: การเรียกใช้เมธอดนี้อาจส่งผลเสียต่อประสิทธิภาพของสื่อกลาง คุณควรเรียกใช้เมธอดนี้เฉพาะในกรณีที่คุณรวมอะแดปเตอร์สื่อกลางไว้ในแอป แต่ไม่ได้วางแผนที่จะใช้สื่อกลางของ Google ในระหว่างเซสชันนี้ของแอป (เช่น คุณกําลังทำการทดสอบ 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

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

หากไม่ได้เรียกใช้เมธอดนี้ คําขอโฆษณารายการแรกจะเริ่มต้นใช้งาน Google Mobile Ads SDK โดยอัตโนมัติ

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

เริ่มต้น

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

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

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

หากไม่ได้เรียกใช้เมธอดนี้ คําขอโฆษณารายการแรกจะเริ่มต้นใช้งาน Google Mobile Ads SDK โดยอัตโนมัติ

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

putPublisherFirstPartyIdEnabled

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

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

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

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

พารามิเตอร์
enabled: Boolean	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 ที่จะใช้สําหรับ 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

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

ให้ใช้ start หรือ start แทน

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

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

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