MobileAds

Kotlin |Java

public class MobileAds

Lớp này chứa logic áp dụng cho toàn bộ SDK Quảng cáo của Google trên thiết bị di động. Hiện tại, các phương thức duy nhất trong đó được dùng để khởi tạo.

Tóm tắt

Hằng số
`static final String`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Tên miền lỗi mặc định cho SDK Quảng cáo của Google trên thiết bị di động.

Phương thức công khai
`static void`	`disableMediationAdapterInitialization(Context context)` Gọi trước `initialize` hoặc yêu cầu quảng cáo đầu tiên để tắt quá trình khởi chạy bộ chuyển đổi dàn xếp.
`static @Nullable InitializationStatus`	`getInitializationStatus()` Lấy trạng thái khởi chạy SDK.
`static @NonNull RequestConfiguration`	`getRequestConfiguration()` Lấy `RequestConfiguration` chung.
`static VersionInfo`	`getVersion()` Lấy phiên bản bên ngoài (ví dụ: 20.6.0) của SDK Quảng cáo của Google trên thiết bị di động.
`static void`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(Context context)` Khởi chạy SDK Quảng cáo của Google trên thiết bị di động.
`static void`	`initialize(Context context, OnInitializationCompleteListener listener)` Khởi chạy SDK Quảng cáo của Google trên thiết bị di động.
`static void`	`openAdInspector(Context context, OnAdInspectorClosedListener listener)` Mở giao diện người dùng của công cụ kiểm tra quảng cáo.
`static void`	`openDebugMenu(Context context, String adUnitId)` Mở trình đơn gỡ lỗi.
`static boolean`	`putPublisherFirstPartyIdEnabled(boolean enabled)` Kiểm soát việc có bật mã nhận dạng bên thứ nhất của nhà xuất bản Google Mobile Ads SDK hay không (trước đây gọi là khoá cho cùng ứng dụng).
`static @Nullable CustomTabsSession`	`registerCustomTabsSession( @NonNull Context context, @NonNull CustomTabsClient client, @NonNull String origin, @Nullable CustomTabsCallback callback )` Đăng ký một `CustomTabsClient` bằng SDK Quảng cáo của Google trên thiết bị di động để cải thiện khả năng kiếm tiền từ quảng cáo trong ứng dụng của quảng cáo trong `CustomTabsSession` này.
`static void`	`registerWebView(@NonNull WebView webview)` Đăng ký một `WebView` bằng SDK Quảng cáo của Google trên thiết bị di động để cải thiện khả năng kiếm tiền từ quảng cáo trong ứng dụng của quảng cáo trong `WebView` này.
`static void`	`setAppMuted(boolean muted)` Cho biết liệu âm thanh của ứng dụng có bị tắt tiếng hay không.
`static void`	`setAppVolume(float volume)` Đặt âm lượng âm thanh của ứng dụng.
`static void`	`setRequestConfiguration( @NonNull RequestConfiguration requestConfiguration )` Đặt `RequestConfiguration` chung sẽ được dùng cho mọi `AdRequest` trong phiên của ứng dụng.
`static void`	`startPreload( @NonNull Context context, @NonNull List<PreloadConfiguration> preloadConfigurations, @NonNull PreloadCallback preloadCallback )` Phương thức này không được dùng nữa. Thay vào đó, hãy sử dụng `start` hoặc `start`.

Hằng số

ERROR_DOMAIN

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

Tên miền lỗi mặc định cho SDK Quảng cáo của Google trên thiết bị di động.

Phương thức công khai

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

Gọi trước initialize hoặc yêu cầu quảng cáo đầu tiên để tắt quá trình khởi chạy bộ chuyển đổi dàn xếp. Phương thức này là một noop sau khi initialize hoặc yêu cầu quảng cáo đầu tiên được thực hiện.

Cảnh báo: Việc gọi phương thức này có thể ảnh hưởng tiêu cực đến hiệu suất dàn xếp của bạn. Bạn chỉ nên gọi phương thức này nếu đưa bộ chuyển đổi dàn xếp vào ứng dụng của mình, nhưng không có ý định sử dụng tính năng dàn xếp của Google trong phiên hoạt động này của ứng dụng (ví dụ: bạn đang chạy thử nghiệm A/B).

getInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

Lấy trạng thái khởi chạy SDK.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Lấy RequestConfiguration chung.

getVersion

public static VersionInfo getVersion()

Lấy phiên bản bên ngoài (ví dụ: 20.6.0) của SDK Quảng cáo của Google trên thiết bị di động.

Bạn không cần gọi initialize trước khi gọi hàm này.

khởi động

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

Khởi chạy SDK Quảng cáo của Google trên thiết bị di động.

Gọi phương thức này càng sớm càng tốt sau khi ứng dụng khởi chạy để giảm độ trễ cho yêu cầu quảng cáo đầu tiên của phiên.

Nếu phương thức này không được gọi, yêu cầu quảng cáo đầu tiên sẽ tự động khởi chạy SDK Quảng cáo của Google trên thiết bị di động.

Thông số
`Context context`	`Context` mà SDK đang chạy.

khởi động

public static void initialize(Context context, OnInitializationCompleteListener listener)

Khởi chạy SDK Quảng cáo của Google trên thiết bị di động.

Gọi phương thức này càng sớm càng tốt sau khi ứng dụng khởi chạy để giảm độ trễ cho yêu cầu quảng cáo đầu tiên của phiên.

Nếu phương thức này không được gọi, yêu cầu quảng cáo đầu tiên sẽ tự động khởi chạy SDK Quảng cáo của Google trên thiết bị di động.

Thông số
`Context context`	Hoạt động `Context` mà SDK đang chạy.
`OnInitializationCompleteListener listener`	Một lệnh gọi lại sẽ được gọi khi quá trình khởi chạy hoàn tất.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

Mở giao diện người dùng của công cụ kiểm tra quảng cáo.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

Mở trình đơn gỡ lỗi. Bạn phải gọi initialize trước hàm này.

Thông số
`Context context`	Hoạt động `Context` mà SDK đang chạy.
`String adUnitId`	Mọi mã đơn vị quảng cáo Ad Manager được liên kết với ứng dụng của bạn.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

Kiểm soát việc có bật mã nhận dạng bên thứ nhất của nhà xuất bản Google Mobile Ads SDK hay không (trước đây gọi là khoá cho cùng ứng dụng).

Mã nhận dạng được bật theo mặc định. Khi bị vô hiệu hoá, chế độ cài đặt sẽ được duy trì trong các phiên sử dụng ứng dụng và mã nhận dạng sẽ bị xoá.

Bạn phải gọi initialize trước hàm này.

Thông số
`boolean enabled`	boolean true nếu mã nhận dạng bên thứ nhất của nhà xuất bản được bật, false nếu không.

Giá trị trả về
`boolean`	true nếu quyết định được duy trì thành công. Sai nếu không duy trì được.

registerCustomTabsSession

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

Đăng ký một CustomTabsClient bằng SDK Quảng cáo của Google trên thiết bị di động để cải thiện khả năng kiếm tiền từ quảng cáo trong ứng dụng của quảng cáo trong CustomTabsSession này. Thao tác này sẽ chỉ tạo một phiên bản của CustomTabsSession và việc chạy lại thao tác này sẽ ghi đè phiên hiện có.

Thông số
`@NonNull Context context`	`Context` mà SDK đang chạy.
`@NonNull CustomTabsClient client`	`CustomTabsClient` dùng để tạo thực thể `CustomTabsSession`.
`@NonNull String origin`	Chuỗi được dùng làm nguồn gốc trên Digital Asset Link để xác minh.
`@Nullable CustomTabsCallback callback`	không bắt buộc `CustomTabsCallback` để nhận cuộc gọi lại từ `CustomTabsSession`.

Giá trị trả về
`@Nullable CustomTabsSession`	`CustomTabsSession` sẽ được dùng cho Custom Tabs Intent khi mở trang Custom Tabs.

registerWebView

public static void registerWebView(@NonNull WebView webview)

Đăng ký một WebView bằng SDK Quảng cáo của Google trên thiết bị di động để cải thiện khả năng kiếm tiền từ quảng cáo trong ứng dụng của quảng cáo trong WebView này.

setAppMuted

public static void setAppMuted(boolean muted)

Cho biết liệu âm thanh của ứng dụng có bị tắt tiếng hay không. Ảnh hưởng đến trạng thái tắt tiếng ban đầu của tất cả quảng cáo.

Cảnh báo: Việc tắt tiếng ứng dụng sẽ làm giảm khả năng đủ điều kiện của quảng cáo dạng video và có thể làm giảm doanh thu từ quảng cáo của ứng dụng. Bạn chỉ nên sử dụng API này nếu ứng dụng của bạn cung cấp chế độ kiểm soát tắt tiếng tuỳ chỉnh cho người dùng và bạn nên phản ánh quyết định tắt tiếng của người dùng trong API này.

Thông số
`boolean muted`	true nếu ứng dụng bị tắt tiếng, false nếu không. Giá trị mặc định là false.

setAppVolume

public static void setAppVolume(float volume)

Đặt âm lượng âm thanh của ứng dụng. Ảnh hưởng đến âm lượng của tất cả quảng cáo so với các đầu ra âm thanh khác.

Cảnh báo: Việc giảm âm lượng của ứng dụng sẽ làm giảm khả năng đủ điều kiện của quảng cáo dạng video và có thể làm giảm doanh thu từ quảng cáo của ứng dụng. Bạn chỉ nên sử dụng API này nếu ứng dụng của bạn cung cấp các chế độ kiểm soát âm lượng tuỳ chỉnh cho người dùng và bạn nên phản ánh lựa chọn âm lượng của người dùng trong API này.

Thông số
`float volume`	âm lượng dưới dạng số thực dấu phẩy động từ 0 (tắt tiếng) đến 1,0 (âm lượng tối đa của nội dung nghe nhìn). Giá trị mặc định là 1.0

Gửi
`java.lang.IllegalArgumentException`	nếu âm lượng nằm ngoài phạm vi hợp lệ

setRequestConfiguration

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

Đặt RequestConfiguration chung sẽ được dùng cho mọi AdRequest trong phiên của ứng dụng.

startPreload

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

Bắt đầu tải trước quảng cáo cho các cấu hình đã cho.

Các API tải trước quảng cáo đang ở giai đoạn thử nghiệm alpha có giới hạn. Vui lòng liên hệ với người quản lý tài khoản của bạn để biết thêm thông tin.

Thông số
`@NonNull Context context`	`Context` mà SDK đang chạy.
`@NonNull List<PreloadConfiguration> preloadConfigurations`	Cấu hình để tải trước quảng cáo.
`@NonNull PreloadCallback preloadCallback`	Một lệnh gọi lại sẽ được gọi khi trạng thái sẵn có của quảng cáo thay đổi cho từng cấu hình tải trước.