Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Google Mobile Ads React Native API

Mô-đun @google/mobile-ads cung cấp các giao diện, lớp và hàm cấp cao nhất của TypeScript cốt lõi để tích hợp Quảng cáo của Google trên thiết bị di động vào các ứng dụng React Native.

Tổng quan

Vòng đời và quá trình khởi chạy SDK: Sử dụng initialize với InitializationConfig để khởi chạy SDK và kiểm tra trạng thái khởi chạy bộ chuyển đổi bằng getInitializationStatus và InitializationStatus.
User Messaging Platform (UMP): Quản lý sự đồng ý của người dùng bằng requestConsentInfoUpdate, loadAndShowConsentFormIfRequired, showPrivacyOptionsForm và kiểm tra trạng thái đồng ý bằng getConsentStatus và canRequestAds.
Cấu hình yêu cầu: Xác định chế độ cài đặt chính sách và tiêu chí nhắm mục tiêu trên toàn cầu bằng setRequestConfiguration và RequestConfiguration, định cấu hình các lựa chọn như AgeRestrictedTreatment, MaxAdContentRating và PublisherPrivacyPersonalizationState.
Định dạng quảng cáo: Tải và trình bày quảng cáo bằng cách sử dụng các lớp định dạng như AppOpenAd, InterstitialAd, RewardedAd và RewardedInterstitialAd.
Công cụ dành cho nhà phát triển: Kiểm tra việc phân phối quảng cáo, trạng thái bộ chuyển đổi và cấu hình SDK theo thời gian thực bằng cách sử dụng openAdInspector hoặc openDebugMenu.

Loại bí danh
`AdapterState`	Biểu thị các trạng thái khởi chạy có thể có của một bộ chuyển đổi dàn xếp.
`AdChoicesPlacement`	Vị trí đặt biểu tượng Lựa chọn quảng cáo trong lượt xem quảng cáo.
`AdFormat`	Định dạng của quảng cáo đang được yêu cầu.
`AdInspectorError`	Thông tin lỗi về lý do khiến công cụ kiểm tra quảng cáo không hoạt động.
`AdInspectorErrorCode`	Các lỗi ảnh hưởng đến việc mở hoặc vận hành công cụ kiểm tra quảng cáo.
`AdOrientation`	Các lựa chọn về hướng cho quảng cáo biểu ngữ thích ứng dạng cùng dòng và biểu ngữ thích ứng cố định cỡ lớn.
`AdSize`	Biểu thị kích thước của một quảng cáo.
`AgeRestrictedTreatment`	Xác định các lựa chọn xử lý bị giới hạn độ tuổi cho yêu cầu quảng cáo.
`ConsentStatus`	Giá trị trạng thái đồng ý.
`DebugGeography`	Giá trị gỡ lỗi để kiểm thử vị trí địa lý.
`FormErrorCode`	Biểu thị mã lỗi cho các lỗi trong thao tác biểu mẫu Nền tảng thông báo cho người dùng (UMP).
`FullScreenContentErrorCode`
`LoadAdErrorCode`	Biểu thị mã lỗi cho các lỗi trong thao tác tải quảng cáo.
`MaxAdContentRating`	Xác định mức phân loại nội dung quảng cáo tối đa cho ứng dụng, phân loại các loại quảng cáo có thể hiển thị.
`NativeAdAssetNames`	Tên dùng để xác định các thành phần quảng cáo gốc chuẩn.
`NativeAdType`	Xác định định dạng của một quảng cáo gốc đã tải.
`NativeMediaAspectRatio`	Lựa chọn ưu tiên về tỷ lệ khung hình của thành phần nghe nhìn trong quảng cáo gốc được trả về.
`OnAdInspectorClosedListener`	Định nghĩa giao diện cho một lệnh gọi lại sẽ được gọi khi giao diện người dùng công cụ kiểm tra quảng cáo đóng.
`PrecisionType`	Độ chính xác của giá trị quảng cáo được báo cáo.
`PrivacyOptionsRequirementStatus`	Trạng thái yêu cầu về các lựa chọn về quyền riêng tư.
`PublisherPrivacyPersonalizationState`	Cho biết các trạng thái cá nhân hoá Cách nhà xuất bản xử lý quyền riêng tư.
`ResizeMode`	Các lựa chọn để tuỳ chỉnh chế độ đổi kích thước của nội dung hình ảnh trong NativeAdMediaView.
`ResolvedAdSize`	Biểu thị trạng thái được phân giải cuối cùng của kích thước quảng cáo sau khi quảng cáo đã tải.
`SwipeGestureDirection`	Hướng dẫn về cử chỉ vuốt khi nhấp tuỳ chỉnh.

Biến
`AdSize`	Kích thước quảng cáo được xác định trước và các phương thức trợ giúp để tạo kích thước thích ứng và tuỳ chỉnh.

Hàm
`canRequestAds`	Kiểm tra xem trạng thái đồng ý hiện tại có cho phép bạn yêu cầu quảng cáo hay không.
`getConsentStatus`	Lấy trạng thái đồng ý hiện tại của người dùng.
`getInitializationStatus`	Lấy trạng thái khởi chạy SDK.
`getPrivacyOptionsRequirementStatus`	Kiểm tra xem ứng dụng của bạn có cần một điểm truy cập các lựa chọn về quyền riêng tư hay không.
`getRequestConfiguration`	Lấy cấu hình yêu cầu chung.
`initialize`	Khởi chạy Google Mobile Ads SDK.
`isConsentFormAvailable`	Kiểm tra xem có biểu mẫu yêu cầu đồng ý hay không.
`loadAndShowConsentFormIfRequired`	Tải biểu mẫu yêu cầu sự đồng ý và trình bày biểu mẫu đó cho người dùng nếu trạng thái đồng ý hiện tại của họ yêu cầu (ví dụ: trạng thái là REQUIRED).
`openAdInspector`	Mở lớp phủ Công cụ kiểm tra quảng cáo của Google Mobile Ads SDK.
`openDebugMenu`	Mở trình đơn gỡ lỗi.
`parseLoadAdError`	Phân tích cú pháp một lỗi gốc phát sinh trong quá trình tải quảng cáo và gói lỗi đó trong một LoadAdError.
`requestConsentInfoUpdate`	Yêu cầu cập nhật thông tin về sự đồng ý.
`reset`	Xoá tất cả trạng thái đồng ý khỏi bộ nhớ liên tục.
`setPublisherFirstPartyIdEnabled`	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 hay không.
`setRequestConfiguration`	Đặt cấu hình yêu cầu chung để tuân thủ và nhắm mục tiêu.
`setUserControlledAppVolume`	Đặt âm lượng âm thanh của ứng dụng do người dùng kiểm soát.
`setUserMutedApp`	Đặt xem ứng dụng có bị tắt tiếng hay không.
`showPrivacyOptionsForm`	Hiện biểu mẫu lựa chọn về quyền riêng tư.

Loại bí danh

AdapterState

AdapterState: typeof AdapterState[keyof typeof AdapterState]

Biểu thị các trạng thái khởi chạy có thể có của một bộ chuyển đổi dàn xếp.

Thuộc tính
`NOT_READY`	Cho biết bộ chuyển đổi dàn xếp chưa được khởi chạy hoặc không khởi chạy được.
`READY`	Cho biết rằng bộ chuyển đổi dàn xếp đã được khởi chạy thành công và sẵn sàng phân phát quảng cáo.

AdChoicesPlacement

AdChoicesPlacement:
                typeof AdChoicesPlacement[keyof typeof AdChoicesPlacement]

Vị trí đặt biểu tượng Lựa chọn quảng cáo trong lượt xem quảng cáo.

Thuộc tính
`BOTTOM_LEFT`	Góc dưới cùng bên trái của quảng cáo.
`BOTTOM_RIGHT`	Góc dưới cùng bên phải của quảng cáo.
`TOP_LEFT`	Góc trên cùng bên trái của quảng cáo.
`TOP_RIGHT`	Góc trên cùng bên phải của quảng cáo.

AdFormat

AdFormat: typeof AdFormat[keyof typeof AdFormat]

Định dạng của quảng cáo đang được yêu cầu.

Thuộc tính
`APP_OPEN`	Định dạng quảng cáo khi mở ứng dụng.
`BANNER`	Định dạng quảng cáo biểu ngữ.
`INTERSTITIAL`	Định dạng quảng cáo xen kẽ.
`NATIVE`	Định dạng quảng cáo gốc.
`REWARDED`	Định dạng quảng cáo có tặng thưởng.
`REWARDED_INTERSTITIAL`	Định dạng quảng cáo xen kẽ có tặng thưởng.

AdInspectorError

AdInspectorError:
                BaseError<AdInspectorErrorCode>

Thông tin lỗi về lý do khiến công cụ kiểm tra quảng cáo không hoạt động.

AdInspectorErrorCode

AdInspectorErrorCode:
                typeof AdInspectorErrorCode[keyof typeof AdInspectorErrorCode]

Các lỗi ảnh hưởng đến việc mở hoặc vận hành công cụ kiểm tra quảng cáo.

Thuộc tính
`ALREADY_OPEN`	Không mở được Công cụ kiểm tra quảng cáo vì công cụ này đã mở.
`FAILED_TO_LOAD`	Không tải được công cụ kiểm tra quảng cáo.
`INTERNAL_ERROR`	Công cụ kiểm tra quảng cáo gặp lỗi nội bộ.
`NOT_IN_TEST_MODE`	Không thể mở công cụ kiểm tra quảng cáo vì thiết bị không ở chế độ kiểm thử.

AdOrientation

AdOrientation: typeof AdOrientation[keyof typeof AdOrientation]

Các lựa chọn về hướng cho quảng cáo biểu ngữ thích ứng cùng dòng và quảng cáo biểu ngữ thích ứng cố định cỡ lớn.

Thuộc tính
`CURRENT`
`LANDSCAPE`
`PORTRAIT`

AdSize

AdSize:
                FixedAdSize | FluidAdSize | InlineAdaptiveAdSize | LargeAnchoredAdaptiveAdSize

Biểu thị kích thước của một quảng cáo.

Có thể là một trong những tập hợp kích thước được xác định trước (ví dụ: AdSize.LARGE_BANNER) hoặc kích thước thích ứng.

AgeRestrictedTreatment

AgeRestrictedTreatment:
                typeof AgeRestrictedTreatment[keyof typeof AgeRestrictedTreatment]

Xác định các lựa chọn xử lý bị giới hạn độ tuổi cho yêu cầu quảng cáo.

Thuộc tính
`CHILD`	Cho biết rằng các yêu cầu quảng cáo phải áp dụng chế độ xử lý theo độ tuổi TRẺ EM.
`TEEN`	Cho biết rằng các yêu cầu quảng cáo phải áp dụng chế độ xử lý theo độ tuổi của THANH THIẾU NIÊN.
`UNSPECIFIED`	Cho biết rằng không có tín hiệu cách xử lý bị giới hạn độ tuổi cụ thể nào áp dụng cho yêu cầu quảng cáo.

ConsentStatus

ConsentStatus: typeof ConsentStatus[keyof typeof ConsentStatus]

Giá trị trạng thái đồng ý.

Thuộc tính
`NOT_REQUIRED`	Không yêu cầu sự đồng ý.
`OBTAINED`	Đã nhận được sự đồng ý của người dùng, được cá nhân hoá so với không được cá nhân hoá undefined.
`REQUIRED`	Bắt buộc phải có sự đồng ý của người dùng nhưng chưa nhận được.
`UNKNOWN`	Trạng thái đồng ý không xác định.

DebugGeography

DebugGeography: typeof DebugGeography[keyof typeof DebugGeography]

Giá trị gỡ lỗi để kiểm thử vị trí địa lý.

Thuộc tính
`DISABLED`	Đã tắt vị trí địa lý gỡ lỗi cho các thiết bị gỡ lỗi.
`EEA`	Vị trí địa lý nằm ở Khu vực kinh tế Châu Âu (EEA) đối với các thiết bị gỡ lỗi.
`OTHER`	Vị trí địa lý nằm ở một khu vực không có quy định bắt buộc đối với thiết bị gỡ lỗi.
`REGULATED_US_STATE`	Vị trí địa lý nằm ở một tiểu bang tại Hoa Kỳ chịu sự điều chỉnh của luật về quyền riêng tư đối với các thiết bị gỡ lỗi.

FormErrorCode

FormErrorCode: typeof FormErrorCode[keyof typeof FormErrorCode]

Biểu thị mã lỗi cho các lỗi trong thao tác biểu mẫu Nền tảng thông báo cho người dùng (UMP).

Thuộc tính
`ALREADY_USED`	Biểu mẫu đồng ý đã được sử dụng.
`INTERNAL_ERROR`	Đã xảy ra lỗi nội bộ trong SDK.
`INVALID_OPERATION`	Thao tác không hợp lệ.
`NETWORK_ERROR`	Thao tác biểu mẫu không thành công do khả năng kết nối mạng.
`TIMEOUT`	Đã hết thời gian chờ cho thao tác biểu mẫu.
`UNAVAILABLE`	Không có biểu mẫu đồng ý.
`UNKNOWN`	Không thể liên kết mã lỗi với một mã lỗi đã biết.

FullScreenContentErrorCode

FullScreenContentErrorCode:
                typeof FullScreenContentErrorCode[keyof typeof FullScreenContentErrorCode]

Thuộc tính
`AD_ALREADY_USED`	Quảng cáo đã xuất hiện.
`AD_NOT_READY`	Quảng cáo chưa sẵn sàng hiển thị.
`AD_TOO_LARGE`	Quảng cáo quá lớn so với cảnh (chỉ dành cho iOS).
`APP_NOT_FOREGROUND`	Ứng dụng không ở nền trước.
`INTERNAL_ERROR`	Đã xảy ra lỗi nội bộ; ví dụ: đã xảy ra một ngoại lệ khi chuẩn bị hiển thị nội dung quảng cáo.
`MEDIATION_ERROR`	Bộ chuyển đổi dàn xếp không hiển thị được quảng cáo. Hãy xem FullScreenContentError.mediationAdError để biết nguyên nhân cơ bản.
`UNKNOWN`	Không thể liên kết mã lỗi với một mã lỗi đã biết.

LoadAdErrorCode

LoadAdErrorCode: typeof LoadAdErrorCode[keyof typeof LoadAdErrorCode]

Biểu thị mã lỗi cho các lỗi trong thao tác tải quảng cáo.

Thuộc tính
`AD_ALREADY_USED`	Lượt phản hồi quảng cáo đã được dùng để tải một quảng cáo.
`APP_ID_MISSING`	Yêu cầu quảng cáo không được thực hiện vì thiếu Mã ứng dụng.
`CANCELLED`	Yêu cầu quảng cáo đã bị huỷ (chỉ dành cho Android).
`INTERNAL_ERROR`	Đã xảy ra lỗi nội bộ trong SDK.
`INVALID_REQUEST`	Yêu cầu quảng cáo không hợp lệ; chẳng hạn như mã đơn vị quảng cáo không chính xác.
`INVALID_RESPONSE`	Lượt phản hồi quảng cáo từ máy chủ đến máy chủ không hợp lệ. Ví dụ: không có mã yêu cầu trong lượt phản hồi quảng cáo.
`MEDIATION_ERROR`	Không tìm thấy bộ chuyển đổi dàn xếp hoặc không thực hiện được yêu cầu quảng cáo.
`NETWORK_ERROR`	Yêu cầu quảng cáo không thành công do kết nối mạng.
`NO_FILL`	Yêu cầu quảng cáo đã thực hiện thành công, nhưng hệ thống không trả về quảng cáo do thiếu khoảng không quảng cáo.
`TIMEOUT`	Đã hết thời gian chờ yêu cầu quảng cáo.
`UNKNOWN`	Không thể liên kết mã lỗi với một mã lỗi đã biết.

MaxAdContentRating

MaxAdContentRating:
                typeof MaxAdContentRating[keyof typeof MaxAdContentRating]

Xác định mức phân loại nội dung quảng cáo tối đa cho ứng dụng, phân loại các loại quảng cáo có thể hiển thị.

Thuộc tính
`G`	Nội dung phù hợp với đối tượng chung, kể cả gia đình và trẻ em.
`MA`	Nội dung chỉ phù hợp với đối tượng người trưởng thành.
`PG`	Nội dung phù hợp với hầu hết đối tượng và cha mẹ cần cân nhắc.
`T`	Nội dung phù hợp với đối tượng thanh thiếu niên trở lên.
`UNSPECIFIED`	Không có mức phân loại nội dung cụ thể.

NativeAdAssetNames

NativeAdAssetNames:
                typeof NativeAdAssetNames[keyof typeof NativeAdAssetNames]

Tên dùng để xác định các thành phần quảng cáo gốc chuẩn.

Thuộc tính
`ADCHOICES_CONTAINER_VIEW`	Vùng chứa cho lớp phủ Lựa chọn quảng cáo.
`ADVERTISER`	Tên của nhà quảng cáo.
`BODY`	Văn bản nội dung chính của quảng cáo.
`CALL_TO_ACTION`	Văn bản kêu gọi hành động cho quảng cáo (ví dụ: "Cài đặt" hoặc "Tìm hiểu thêm").
`HEADLINE`	Dòng tiêu đề hoặc tiêu đề của quảng cáo.
`ICON`	Hình ảnh biểu tượng cho quảng cáo.
`MEDIA_CONTENT`	Nội dung đa phương tiện chính của quảng cáo (hình ảnh hoặc video).
`PRICE`	Giá của ứng dụng hoặc sản phẩm được quảng cáo.
`STAR_RATING`	Điểm xếp hạng theo sao của ứng dụng hoặc sản phẩm được quảng cáo.
`STORE`	Tên cửa hàng.

NativeAdType

NativeAdType: typeof NativeAdType[keyof typeof NativeAdType]

Xác định định dạng của một quảng cáo gốc đã tải.

Thuộc tính
`BANNER`	Quảng cáo biểu ngữ.
`CUSTOM_NATIVE`	Quảng cáo ở định dạng gốc tuỳ chỉnh.
`NATIVE`	Quảng cáo gốc.

NativeMediaAspectRatio

NativeMediaAspectRatio:
                typeof NativeMediaAspectRatio[keyof typeof NativeMediaAspectRatio]

Lựa chọn ưu tiên về tỷ lệ khung hình của thành phần nghe nhìn trong quảng cáo gốc được trả về.

Thuộc tính
`ANY`	Không có lựa chọn ưu tiên nào cho tỷ lệ khung hình của thành phần nghe nhìn quảng cáo gốc được trả về.
`LANDSCAPE`	Yêu cầu tỷ lệ khung hình ngang cho thành phần phương tiện quảng cáo gốc được trả về.
`PORTRAIT`	Yêu cầu tỷ lệ khung hình dọc cho thành phần nghe nhìn của quảng cáo gốc được trả về.
`SQUARE`	Yêu cầu tỷ lệ khung hình vuông cho nội dung nghe nhìn quảng cáo gốc được trả về.
`UNKNOWN`	Tỷ lệ khung hình không xác định.

OnAdInspectorClosedListener

OnAdInspectorClosedListener:
                ((error?) => void)

Định nghĩa giao diện cho một lệnh gọi lại sẽ được gọi khi giao diện người dùng của công cụ kiểm tra quảng cáo đóng.

PrecisionType

PrecisionType: typeof PrecisionType[keyof typeof PrecisionType]

Độ chính xác của giá trị quảng cáo được báo cáo.

Thuộc tính
`ESTIMATED`	Giá trị quảng cáo được ước tính từ dữ liệu tổng hợp.
`PRECISE`	Giá trị chính xác mà bạn phải trả cho quảng cáo này.
`PUBLISHER_PROVIDED`	Giá trị quảng cáo do nhà xuất bản cung cấp, chẳng hạn như CPM thủ công trong một nhóm dàn xếp.
`UNKNOWN`	Giá trị quảng cáo có độ chính xác không xác định.

PrivacyOptionsRequirementStatus

PrivacyOptionsRequirementStatus:
                typeof PrivacyOptionsRequirementStatus[keyof typeof PrivacyOptionsRequirementStatus]

Trạng thái yêu cầu về các lựa chọn về quyền riêng tư.

Thuộc tính
`NOT_REQUIRED`	Bạn không bắt buộc phải có điểm truy cập các lựa chọn về quyền riêng tư.
`REQUIRED`	Bạn phải có điểm truy cập các lựa chọn về quyền riêng tư.
`UNKNOWN`	Không xác định được trạng thái yêu cầu đối với lựa chọn về quyền riêng tư.

PublisherPrivacyPersonalizationState

PublisherPrivacyPersonalizationState: typeof PublisherPrivacyPersonalizationState[keyof typeof PublisherPrivacyPersonalizationState]

Cho biết các trạng thái cá nhân hoá theo cách xử lý quyền riêng tư của nhà xuất bản.

Thuộc tính
`DEFAULT`	Cho biết rằng yêu cầu quảng cáo phải áp dụng chế độ xử lý quyền riêng tư mặc định của nhà xuất bản.
`DISABLED`	Cho biết rằng yêu cầu quảng cáo phải áp dụng chế độ xử lý quyền riêng tư của nhà xuất bản không được cá nhân hoá.
`ENABLED`	Cho biết rằng yêu cầu quảng cáo phải áp dụng chế độ xử lý quyền riêng tư được cá nhân hoá của nhà xuất bản.

ResizeMode

ResizeMode: typeof ResizeMode[keyof typeof ResizeMode]

Các lựa chọn để tuỳ chỉnh chế độ đổi kích thước của nội dung hình ảnh trong NativeAdMediaView.

Thuộc tính
`CONTAIN`	Điều chỉnh tỷ lệ đồng nhất cho phù hợp với khung hiển thị. Chiều cao và chiều rộng của hình ảnh được điều chỉnh tỷ lệ cùng nhau sao cho mỗi phương diện nhỏ hơn hoặc bằng phương diện tương ứng của khung hiển thị. Hình ảnh được điều chỉnh tỷ lệ cho vừa với bên trong khung hiển thị mà không làm biến dạng tỷ lệ khung hình hoặc bị cắt.
`COVER`	Điều chỉnh tỷ lệ đồng nhất để bao phủ khung hiển thị. Chiều cao và chiều rộng của hình ảnh được điều chỉnh tỷ lệ cùng nhau sao cho mỗi phương diện bằng hoặc lớn hơn phương diện tương ứng của khung hiển thị. Hình ảnh được cắt cho vừa với khung hiển thị mà không làm biến dạng tỷ lệ khung hình.
`STRETCH`	Điều chỉnh tỷ lệ chiều rộng và chiều cao một cách độc lập để lấp đầy khung hiển thị. Chiều cao và chiều rộng của hình ảnh được điều chỉnh tỷ lệ riêng biệt để khớp với kích thước của khung hiển thị. Hình ảnh được thu nhỏ để lấp đầy hoàn toàn khung hiển thị mà không bị cắt. Tuy nhiên, tỷ lệ khung hình của hình ảnh không được duy trì.

ResolvedAdSize

ResolvedAdSize:
                FixedAdSize | FluidAdSize

Biểu thị trạng thái cuối cùng đã phân giải của một kích thước quảng cáo sau khi quảng cáo đã tải.

Đối với hầu hết các quảng cáo, trạng thái này sẽ phân giải thành một FixedAdSize có kích thước chính xác là width và height. Đối với quảng cáo biểu ngữ có kích thước linh hoạt, điều này sẽ chuyển thành một FluidAdSize, trong đó các kích thước được quản lý theo hệ phân cấp view.

SwipeGestureDirection

SwipeGestureDirection:
                typeof SwipeGestureDirection[keyof typeof SwipeGestureDirection]

Hướng dẫn về cử chỉ vuốt khi nhấp tuỳ chỉnh.

Thuộc tính
`DOWN`	Vuốt xuống.
`LEFT`	Vuốt sang trái.
`RIGHT`	Vuốt sang phải.
`UP`	Vuốt lên.

Biến

AdSize

AdSize: { 
  BANNER: FixedAdSize; 
  custom: ((width,
                height) => FixedAdSize); 
  FLUID: FluidAdSize; 
  FULL_BANNER: FixedAdSize; 
  getCurrentOrientationInlineAdaptiveBannerAdSize: ((width) => InlineAdaptiveAdSize); 
  getInlineAdaptiveBannerAdSize: ((width,
                maxHeight) => InlineAdaptiveAdSize); 
  getLandscapeInlineAdaptiveBannerAdSize: ((width) => InlineAdaptiveAdSize); 
  getLargeAnchoredAdaptiveBannerAdSize: ((width) => Promise<LargeAnchoredAdaptiveAdSize>); 
  getLargeLandscapeAnchoredAdaptiveBannerAdSize: ((width) => Promise<LargeAnchoredAdaptiveAdSize>); 
  getLargePortraitAnchoredAdaptiveBannerAdSize: ((width) => Promise<LargeAnchoredAdaptiveAdSize>); 
  getPortraitInlineAdaptiveBannerAdSize: ((width) => InlineAdaptiveAdSize); 
  LARGE_BANNER: FixedAdSize; 
  LEADERBOARD: FixedAdSize; 
  MEDIUM_RECTANGLE: FixedAdSize; 
}

Kích thước quảng cáo được xác định trước và các phương thức trợ giúp để tạo kích thước thích ứng và tuỳ chỉnh.

Hàm

canRequestAds

canRequestAds(): boolean

Kiểm tra xem trạng thái đồng ý hiện tại có cho phép bạn yêu cầu quảng cáo hay không.

Giá trị trả về
`boolean`	`true` nếu bạn có thể yêu cầu quảng cáo, `false` nếu không.

getConsentStatus

getConsentStatus(): ConsentStatus

Lấy trạng thái đồng ý hiện tại của người dùng.

Giá trị trả về
`ConsentStatus`	Trạng thái đồng ý hiện tại.

getInitializationStatus

getInitializationStatus(): InitializationStatus

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

Sử dụng phương thức này để kiểm tra xem SDK đã hoàn tất quá trình khởi chạy hay chưa và để kiểm tra trạng thái của từng bộ chuyển đổi dàn xếp.

Giá trị trả về
`InitializationStatus`	Trạng thái khởi tạo hiện tại.

getPrivacyOptionsRequirementStatus

getPrivacyOptionsRequirementStatus(): PrivacyOptionsRequirementStatus

Kiểm tra xem ứng dụng của bạn có cần một điểm truy cập các lựa chọn về quyền riêng tư hay không.

Nếu cần một điểm truy cập, hãy thêm một phần tử trên giao diện người dùng có thể nhìn thấy và tương tác vào ứng dụng của bạn để gọi showPrivacyOptionsForm nhằm hiển thị biểu mẫu các lựa chọn về quyền riêng tư. Nếu không bắt buộc phải có một điểm truy cập, hãy định cấu hình phần tử trên giao diện người dùng của bạn sao cho không hiển thị và tương tác được.

Giá trị trả về
`PrivacyOptionsRequirementStatus`	Trạng thái yêu cầu đối với lựa chọn về quyền riêng tư.

getRequestConfiguration

getRequestConfiguration(): RequestConfiguration

Lấy cấu hình yêu cầu chung.

Sử dụng phương thức này để truy xuất cấu hình yêu cầu hiện tại đã được áp dụng trên toàn cầu.

Giá trị trả về
`RequestConfiguration`	Cấu hình yêu cầu chung hiện tại.

initialize

initialize(config,
              onInitializationComplete?): void

Khởi chạy Google Mobile Ads SDK.

Gọi phương thức này trước khi tải quảng cáo và trước khi tương tác với phần còn lại của Google Mobile Ads SDK.

Thông số
`config: InitializationConfig`	Các lựa chọn để kiểm soát quá trình khởi chạy SDK.
`Optional onInitializationComplete: ((status) => void)`	Một hàm callback sẽ chạy khi SDK hoàn tất quá trình khởi động.

isConsentFormAvailable

isConsentFormAvailable(): boolean

Kiểm tra xem có biểu mẫu yêu cầu đồng ý hay không.

Giá trị trả về
`boolean`	`true` nếu có biểu mẫu yêu cầu đồng ý, `false` nếu không.

loadAndShowConsentFormIfRequired

loadAndShowConsentFormIfRequired(onDismissed?): void

Tải biểu mẫu yêu cầu sự đồng ý và trình bày biểu mẫu đó cho người dùng nếu trạng thái đồng ý hiện tại của họ yêu cầu (ví dụ: trạng thái là REQUIRED).

Thông số
`Optional onDismissed: ((error?) => void)`	Hàm gọi lại được gọi khi biểu mẫu bị đóng hoặc nếu không cần biểu mẫu, với FormError không bắt buộc nếu quá trình trình bày không thành công.

openAdInspector

openAdInspector(_listener): void

Mở lớp phủ Công cụ kiểm tra quảng cáo của Google Mobile Ads SDK.

Sử dụng phương thức này để gỡ lỗi chế độ thiết lập dàn xếp và nguồn quảng cáo.

Thông số
`_listener: OnAdInspectorClosedListener`

openDebugMenu

openDebugMenu(adUnitId): void

Mở trình đơn gỡ lỗi.

Sử dụng phương thức này để mở trình đơn gỡ lỗi cho một đơn vị quảng cáo cụ thể nhằm hỗ trợ kiểm thử và khắc phục sự cố về cấu hình quảng cáo.

Thông số
`adUnitId: string`	Mã đơn vị quảng cáo để mở trình đơn gỡ lỗi.

parseLoadAdError

parseLoadAdError(error): LoadAdError

Phân tích cú pháp một lỗi gốc phát sinh trong quá trình tải quảng cáo và gói lỗi đó trong một LoadAdError.

Thông số
`error: unknown`	Đối tượng lỗi do mô-đun gốc tạo ra.

Giá trị trả về
`LoadAdError`	Một đối tượng LoadAdError đã phân tích cú pháp.

requestConsentInfoUpdate

requestConsentInfoUpdate(params?, onComplete?): void

Yêu cầu cập nhật thông tin về sự đồng ý.

Bạn phải gọi API này trong mỗi phiên ứng dụng trước khi gọi getConsentStatus.

Sau khi gọi API này, giá trị trả về getConsentStatus sẽ được cập nhật đồng bộ để giữ trạng thái đồng ý từ phiên ứng dụng trước đó (nếu có).

Bạn có thể cập nhật lại getConsentStatus thành trạng thái mới nhất sau khi gọi lệnh gọi lại onComplete.

Thông số
`Optional params: ConsentRequestParameters`	Cấu hình không bắt buộc để gỡ lỗi và nhắm mục tiêu.
`Optional onComplete: ((error?) => void)`	Hàm callback được gọi khi quá trình cập nhật thông tin về sự đồng ý hoàn tất, có FormError không bắt buộc nếu yêu cầu không thành công.

reset

reset(): void

Xoá tất cả trạng thái đồng ý khỏi bộ nhớ liên tục.

Chỉ sử dụng cho mục đích gỡ lỗi.

setPublisherFirstPartyIdEnabled

setPublisherFirstPartyIdEnabled(enabled): void

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 hay không.

Bật hoặc tắt mã nhận dạng bên thứ nhất của nhà xuất bản trong Google Mobile Ads SDK (trước đây gọi là khoá cho cùng ứng dụng).

Xem thêm

Bật mã nhận dạng bên thứ nhất của nhà xuất bản

Thông số
`enabled: boolean`	True để bật mã nhận dạng bên thứ nhất của nhà xuất bản; false để tắt. Giá trị mặc định là `true`.

setRequestConfiguration

setRequestConfiguration(_config): void

Đặt cấu hình yêu cầu chung cho việc tuân thủ và nhắm mục tiêu.

Sử dụng phương thức này để chỉ định thông tin chi tiết về việc nhắm mục tiêu, chẳng hạn như mức phân loại nội dung quảng cáo tối đa, chế độ cài đặt tuân thủ (chẳng hạn như thẻ xử lý theo độ tuổi) và mã nhận dạng thiết bị thử nghiệm.

Thông số
`_config: RequestConfiguration`

setUserControlledAppVolume

setUserControlledAppVolume(volume): void

Đặt âm lượng âm thanh của ứng dụng do người dùng kiểm soát.

Sử dụng phương thức này để điều chỉnh âm lượng âm thanh của tất cả quảng cáo so với đầu ra âm thanh khác trên thiết bị.

Thông số
`volume: number`	Mức âm lượng, từ 0,0 (im lặng) đến 1,0 (tối đa). Mọi giá trị dấu phẩy động trong phạm vi này đều hợp lệ (ví dụ: 0,001 hoặc 0,33333). Giá trị này không bị giới hạn ở mức tăng kích thước bước cụ thể, chẳng hạn như 0,1.

setUserMutedApp

setUserMutedApp(muted): void

Đặt xem ứng dụng có bị tắt tiếng hay không.

Sử dụng phương thức này để kiểm soát trạng thái tắt tiếng âm thanh ban đầu của các quảng cáo tiếp theo.

Thông số
`muted: boolean`	Có nên tắt tiếng âm thanh của ứng dụng hay không. Giá trị mặc định là `false`.

showPrivacyOptionsForm

showPrivacyOptionsForm(onDismissed?): void

Hiện biểu mẫu lựa chọn về quyền riêng tư.

Hiển thị biểu mẫu lựa chọn về quyền riêng tư nếu getPrivacyOptionsRequirementStatus là REQUIRED.

Bạn chỉ nên gọi phương thức này để phản hồi thông tin đầu vào của người dùng nhằm yêu cầu hiển thị biểu mẫu lựa chọn về quyền riêng tư.

SDK sẽ tự động tải sẵn biểu mẫu lựa chọn về quyền riêng tư khi có biểu mẫu. Nếu chưa tải sẵn biểu mẫu nào, SDK sẽ cố gắng tải một biểu mẫu theo cách không đồng bộ.

Lệnh gọi lại onDismissed sẽ được gọi sau khi người dùng nhìn thấy biểu mẫu, chọn một lựa chọn và đóng biểu mẫu. Phương thức này cũng có thể trả về FormError nếu:

Biểu mẫu này không hoạt động.
Biểu mẫu không xuất hiện.
Biểu mẫu vẫn đang được tải trước.

Thông số
`Optional onDismissed: ((error?) => void)`	Hàm gọi lại được gọi khi biểu mẫu bị đóng, với FormError không bắt buộc nếu quá trình trình bày không thành công.

Google Mobile Ads React Native API Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tổng quan

Loại bí danh

AdapterState

AdChoicesPlacement

AdFormat

AdInspectorError

AdInspectorErrorCode

AdOrientation

AdSize

AgeRestrictedTreatment

ConsentStatus

DebugGeography

FormErrorCode

FullScreenContentErrorCode

LoadAdErrorCode

MaxAdContentRating

NativeAdAssetNames

NativeAdType

NativeMediaAspectRatio

OnAdInspectorClosedListener

PrecisionType

PrivacyOptionsRequirementStatus

PublisherPrivacyPersonalizationState

ResizeMode

ResolvedAdSize

SwipeGestureDirection

Biến

AdSize

Hàm

canRequestAds

getConsentStatus

getInitializationStatus

getPrivacyOptionsRequirementStatus

getRequestConfiguration

initialize

isConsentFormAvailable

loadAndShowConsentFormIfRequired

openAdInspector

openDebugMenu

parseLoadAdError

requestConsentInfoUpdate

reset

setPublisherFirstPartyIdEnabled

setRequestConfiguration

setUserControlledAppVolume

setUserMutedApp

showPrivacyOptionsForm

Google Mobile Ads React Native API