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

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

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

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

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

เริ่มต้น

public static void initialize(Context context, OnInitializationCompleteListener listener)

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

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

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

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

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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

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

การคืนสินค้า
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 เพื่อรับการติดต่อกลับจาก

การคืนสินค้า
@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
)

วิธีการนี้เลิกใช้งานแล้ว

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

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

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

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