MobileAds

Kotlin |Java

public class MobileAds

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

สรุป

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

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

ค่าคงที่

ERROR_DOMAIN

public static final String ERROR_DOMAIN = "com.google.android.gms.ads"

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

เมธอดสาธารณะ

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

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

getInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

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

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

รับ RequestConfiguration ทั่วโลก

getVersion

public static VersionInfo getVersion()

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

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

เริ่มต้น

@RequiresPermission(value = Manifest.permission.INTERNET)
public static void initialize(Context context)

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

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

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

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

เริ่มต้น

public static void initialize(Context context, OnInitializationCompleteListener listener)

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

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

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

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

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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

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

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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

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

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

registerCustomTabsSession

public static @Nullable CustomTabsSession registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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

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

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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

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

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

setAppVolume

public static void setAppVolume(float volume)

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

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

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

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

setRequestConfiguration

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

public static void startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

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

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

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