MobileAds

public class MobileAds

Lớp 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 chạy.

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 trên thiết bị di động của Google.

Phương thức công khai
static void

Gọi trước initialize hoặc yêu cầu quảng cáo đầu tiên để tắt tính năng khởi chạy bộ chuyển đổi dàn xếp.
static @Nullable InitializationStatus

Lấy trạng thái khởi chạy SDK.
static @NonNull RequestConfiguration

Lấy RequestConfiguration toàn cục.
static VersionInfo

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

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

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

Kiểm soát việc liệu mã nhận dạng bên thứ nhất của nhà xuất bản SDK Quảng cáo của Google trên thiết bị di động (trước đây gọi là khoá cho cùng ứng dụng) có được bật hay không.
static @Nullable CustomTabsSession
registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

Đăng ký 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

Đăng ký 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 hay không.
static void
setAppVolume(float volume)

Đặt âm lượng 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
)

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

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 trên thiết bị di động của Google.

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 tính năng khởi chạy bộ chuyển đổi dàn xếp. Phương thức này là một phương thức rỗng 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. Bạn chỉ nên gọi phương thức này nếu đưa trình chuyển đổi dàn xếp vào ứng dụng nhưng không có kế hoạch sử dụng tính năng dàn xếp của Google trong phiên ứng dụng này (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 toàn cục.

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 hàm này.

khởi chạy

@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.

Hãy 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ễ trên 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 chạy

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.

Hãy 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ễ trên 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

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 liệu mã nhận dạng bên thứ nhất của nhà xuất bản SDK Quảng cáo của Google trên thiết bị di động (trước đây gọi là khoá cho cùng ứng dụng) có được bật hay không.

Mã nhận dạng được bật theo mặc định. Khi bị tắt, chế độ cài đặt này sẽ được duy trì trên các phiên ứ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 lưu trữ thành công. Sai nếu không thể duy trì.

registerCustomTabsSession

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

Đăng ký 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 thực thể của CustomTabsSession và việc chạy lại 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 dùng làm nguồn gốc trên Đường liên kết đến tài sản kỹ thuật số để xác minh.
@Nullable CustomTabsCallback callback

CustomTabsCallback không bắt buộc để nhận lệnh gọi lại từ .
Giá trị trả về
@Nullable CustomTabsSession

Phiên bản CustomTabsSession sẽ được dùng cho Ý định thẻ tuỳ chỉnh khi mở trang Thẻ tuỳ chỉnh.

registerWebView

public static void registerWebView(@NonNull WebView webview)

Đăng ký 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 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à sai.

setAppVolume

public static void setAppVolume(float volume)

Đặt âm lượng của ứng dụng. Ảnh hưởng đến âm lượng của tất cả quảng cáo so với âm thanh đầu ra 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 từ 0 (tắt tiếng) đến 1.0 (âm lượng đầy đủ 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.

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

Lệnh gọi lại được gọi khi tình trạng có quảng cáo thay đổi cho từng cấu hình tải trước.