NativeAd

abstract class NativeAd


Một quảng cáo gốc của Google.

Tóm tắt

Các loại lồng nhau

abstract class NativeAd.AdChoicesInfo

Thông tin phân bổ.

abstract class NativeAd.Image

Một thành phần hình ảnh quảng cáo gốc.

Định nghĩa giao diện cho một lệnh gọi lại sẽ được gọi khi quảng cáo gốc đã tải thành công.

Một giao diện trình nghe mà các ứng dụng có thể dùng để nhận các sự kiện nhấp chuột chưa được xác nhận khi sử dụng tính năng Lượt nhấp yêu cầu xác nhận.

Hàm khởi tạo công khai

Hàm công khai

abstract Unit

Huỷ một lượt nhấp chưa được xác nhận đã được ghi lại trước đó cho quảng cáo.

abstract Unit

Huỷ đối tượng quảng cáo.

abstract Unit

Hàm này không còn được dùng nữa.

Sử dụng enableCustomClickGestureDirection.

abstract NativeAd.AdChoicesInfo?

Trả về thông tin về thuộc tính Lựa chọn quảng cáo.

abstract String?

Trả về văn bản giúp nhận diện nhà quảng cáo.

abstract String?

Trả về văn bản nội dung.

abstract String?

Trả về lời kêu gọi hành động của quảng cáo (chẳng hạn như "Mua" hoặc "Cài đặt").

abstract Bundle!

Trả về một gói gồm các thành phần bổ sung liên kết với quảng cáo gốc.

abstract String?

Trả về dòng tiêu đề văn bản chính.

abstract NativeAd.Image?

Trả về một hình ảnh nhỏ xác định nhà quảng cáo.

abstract (Mutable)List<NativeAd.Image!>!

Trả về danh sách hình ảnh lớn.

abstract MediaContent?

Trả về MediaContent được liên kết với quảng cáo này.

abstract (Mutable)List<MuteThisAdReason!>!

Trả về các lý do cho việc Ẩn quảng cáo này đối với quảng cáo này.

abstract Long

Trả về mã vị trí cho NativeAd này.

abstract String?

Đối với quảng cáo về ứng dụng, hàm này trả về một chuỗi biểu thị chi phí của ứng dụng.

abstract ResponseInfo?

Trả về đối tượng ResponseInfo cho quảng cáo đã tải.

abstract Double?

Đối với quảng cáo về ứng dụng, trả về điểm xếp hạng theo sao từ 0 đến 5, cho biết số sao mà ứng dụng có trong cửa hàng cung cấp ứng dụng đó.

abstract String?

Đối với quảng cáo về ứng dụng, hãy trả về tên của cửa hàng cung cấp ứng dụng để tải xuống.

abstract Boolean

Hàm này không còn được dùng nữa.

Khi tải một quảng cáo bằng enableCustomClickGestureDirection, tất cả quảng cáo được trả về sẽ hỗ trợ thao tác nhấp tuỳ chỉnh.

abstract Boolean

Trả về true nếu có thể tắt tiếng quảng cáo này theo phương thức lập trình.

abstract Unit
muteThisAd(muteThisAdReason: MuteThisAdReason!)

Ẩn quảng cáo này theo phương thức lập trình.

abstract Unit
performClick(clickData: Bundle!)

Bạn nên gọi phương thức này khi người dùng đã nhấp vào quảng cáo.

abstract Unit

Hàm này không còn được dùng nữa.

Giờ đây, SDK quảng cáo trên thiết bị di động của Google sẽ theo dõi các cử chỉ nhấp tuỳ chỉnh bằng cách sử dụng hướng cử chỉ nhấp được yêu cầu trong enableCustomClickGestureDirection.

abstract Boolean
recordImpression(impressionData: Bundle!)

Bạn nên gọi phương thức này khi quảng cáo xuất hiện lần đầu.

abstract Unit
reportTouchEvent(touchEventData: Bundle!)

Cần được gọi khi một sự kiện chạm xảy ra trên quảng cáo.

abstract Unit

Đặt MuteThisAdListener cho quảng cáo.

abstract Unit

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo này được ước tính là đã kiếm được tiền.

abstract Unit
setPlacementId(placementId: Long)

Đặt mã vị trí cho quảng cáo gốc.

abstract Unit

Đặt UnconfirmedClickListener cho quảng cáo.

Hàm khởi tạo công khai

NativeAd

NativeAd()

Hàm công khai

cancelUnconfirmedClick

abstract fun cancelUnconfirmedClick(): Unit

Huỷ một lượt nhấp chưa được xác nhận đã được ghi lại trước đó cho quảng cáo.

hủy bỏ

abstract fun destroy(): Unit

Huỷ đối tượng quảng cáo. Không được gọi bất kỳ phương thức nào khác trên đối tượng quảng cáo sau khi gọi destroy.

enableCustomClickGesture

abstract fun enableCustomClickGesture(): Unit

Cho phép nhà xuất bản báo cáo lượt nhấp bằng cử chỉ tuỳ chỉnh cho NativeAd này. Đơn vị quảng cáo phải nằm trong danh sách cho phép thì mới có thể sử dụng phương thức này.

Theo mặc định, SDK theo dõi số lượt nhấp vào chế độ xem thành phần. Nếu phương thức này được gọi, SDK sẽ không còn theo dõi lượt nhấp cho NativeAd này nữa. Bạn nên gọi phương thức này trước khi hiển thị quảng cáo.

getAdChoicesInfo

abstract fun getAdChoicesInfo(): NativeAd.AdChoicesInfo?

Trả về thông tin về thuộc tính Lựa chọn quảng cáo.

getAdvertiser

abstract fun getAdvertiser(): String?

Trả về văn bản giúp nhận diện nhà quảng cáo. Ứng dụng không bắt buộc phải hiển thị thành phần này, mặc dù bạn nên làm như vậy.

getBody

abstract fun getBody(): String?

Trả về văn bản nội dung. Ứng dụng phải hiển thị thành phần này.

getCallToAction

abstract fun getCallToAction(): String?

Trả về lời kêu gọi hành động của quảng cáo (chẳng hạn như "Mua" hoặc "Cài đặt"). Ứng dụng không bắt buộc phải hiển thị thành phần này, mặc dù bạn nên làm như vậy.

getExtras

abstract fun getExtras(): Bundle!

Trả về một gói gồm các thành phần bổ sung liên kết với quảng cáo gốc. Nếu quảng cáo của một đối tác dàn xếp có các thành phần ngoài các thành phần tiêu chuẩn (giá, cửa hàng, v.v.), thì bạn có thể đặt các thành phần đó bằng cách gọi phương thức trong setExtras và có thể truy xuất thông qua phương thức này. Đối với luồng không dàn xếp, phương thức này sẽ trả về một gói trống.

getHeadline

abstract fun getHeadline(): String?

Trả về dòng tiêu đề văn bản chính. Ứng dụng phải hiển thị thành phần này.

getIcon

abstract fun getIcon(): NativeAd.Image?

Trả về một hình ảnh nhỏ xác định nhà quảng cáo. Ứng dụng không bắt buộc phải hiển thị thành phần này, mặc dù bạn nên làm như vậy.

getImages

abstract fun getImages(): (Mutable)List<NativeAd.Image!>!

Trả về danh sách hình ảnh lớn. Ứng dụng không bắt buộc phải hiển thị thành phần này, mặc dù bạn nên làm như vậy.

getMediaContent

abstract fun getMediaContent(): MediaContent?

Trả về MediaContent được liên kết với quảng cáo này.

getMuteThisAdReasons

abstract fun getMuteThisAdReasons(): (Mutable)List<MuteThisAdReason!>!

Trả về các lý do cho việc Ẩn quảng cáo này đối với quảng cáo này. Sử dụng nội dung mô tả bằng văn bản từ lớp để hiển thị cho người dùng.

getPlacementId

abstract fun getPlacementId(): Long

Trả về mã vị trí cho NativeAd này.

getPrice

abstract fun getPrice(): String?

Đối với quảng cáo về ứng dụng, hàm này trả về một chuỗi biểu thị chi phí của ứng dụng. Ứng dụng không bắt buộc phải hiển thị thành phần này, mặc dù bạn nên làm như vậy.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo?

Trả về đối tượng ResponseInfo cho quảng cáo đã tải. Trả về null cho đến khi quảng cáo tải thành công.

getStarRating

abstract fun getStarRating(): Double?

Đối với quảng cáo về ứng dụng, trả về điểm xếp hạng theo sao từ 0 đến 5, cho biết số sao mà ứng dụng có trong cửa hàng cung cấp ứng dụng đó. Ứng dụng không bắt buộc phải hiển thị thành phần này, mặc dù bạn nên làm như vậy.

getStore

abstract fun getStore(): String?

Đối với quảng cáo về ứng dụng, hãy trả về tên của cửa hàng cung cấp ứng dụng để tải xuống. Ví dụ: "Google Play". Ứng dụng không bắt buộc phải hiển thị thành phần này, mặc dù bạn nên làm như vậy.

isCustomClickGestureEnabled

abstract fun isCustomClickGestureEnabled(): Boolean

Cho biết liệu bạn có thể báo cáo lượt nhấp bằng thao tác nhấp tuỳ chỉnh hay không. Liên hệ với người quản lý tài khoản để đưa đơn vị quảng cáo của bạn vào danh sách cho phép sử dụng tính năng này.

isCustomMuteThisAdEnabled

abstract fun isCustomMuteThisAdEnabled(): Boolean

Trả về true nếu có thể tắt tiếng quảng cáo này theo phương thức lập trình. Sử dụng setRequestCustomMuteThisAd để yêu cầu triển khai tuỳ chỉnh tính năng Ẩn quảng cáo này.

muteThisAd

abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit

Ẩn quảng cáo này theo phương thức lập trình.

Thông số
muteThisAdReason: MuteThisAdReason!

Lý do ẩn mà người dùng chọn. Nhận lý do tắt tiếng từ getMuteThisAdReasons. Sử dụng null để ẩn quảng cáo này bằng lý do mặc định.

performClick

abstract fun performClick(clickData: Bundle!): Unit

Bạn nên gọi phương thức này khi người dùng đã nhấp vào quảng cáo. Đơn vị quảng cáo phải có trong danh sách cho phép thì mới có thể sử dụng API này. Phương thức này chỉ nên được sử dụng bởi các nhà xuất bản trình bổ trợ Unity.

Thông số
clickData: Bundle!

gói môi trường ứng dụng khi lượt nhấp xảy ra. Để biết thông tin chi tiết về cách tạo dữ liệu lượt nhấp Bundle, hãy xem NativeAdConstants.

recordCustomClickGesture

abstract fun recordCustomClickGesture(): Unit

Báo cáo lượt nhấp cho NativeAd này bằng thao tác nhấp tuỳ chỉnh. Đơn vị quảng cáo phải nằm trong danh sách cho phép thì mới có thể sử dụng phương thức này.

Bạn phải gọi enableCustomClickGesture trước khi gọi phương thức này.

recordImpression

abstract fun recordImpression(impressionData: Bundle!): Boolean

Bạn nên gọi phương thức này khi quảng cáo xuất hiện lần đầu. Đơn vị quảng cáo phải có trong danh sách cho phép thì mới có thể sử dụng API này.

Thông số
impressionData: Bundle!

gói môi trường ứng dụng khi lượt hiển thị xảy ra. Để biết thông tin chi tiết về cách tạo dữ liệu lượt nhấp Bundle, hãy xem NativeAdConstants.

Giá trị trả về
Boolean

true nếu lượt hiển thị được ghi lại thành công

reportTouchEvent

abstract fun reportTouchEvent(touchEventData: Bundle!): Unit

Cần được gọi khi một sự kiện chạm xảy ra trên quảng cáo. Đơn vị quảng cáo phải có trong danh sách cho phép thì mới có thể sử dụng API này. Nếu bạn muốn sử dụng tính năng này, hãy liên hệ với người quản lý tài khoản của bạn.

Thông số
touchEventData: Bundle!

gói gồm toạ độ và thời lượng của sự kiện chạm.

Ví dụ về biểu diễn JSON của gói touchEventData:

  {    "x": "100",  // The x-coordinate of the touch event relative to the window.    "y": "50",  // The y-coordinate of the touch event relative to the window.    "duration_millis": "500",  // The amount of milliseconds the user pressed on the asset.  }

setMuteThisAdListener

abstract fun setMuteThisAdListener(listener: MuteThisAdListener!): Unit

Đặt MuteThisAdListener cho quảng cáo.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo này được ước tính là đã kiếm được tiền.

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

Đặt mã vị trí cho quảng cáo gốc.

Để đảm bảo mã vị trí này được đưa vào báo cáo, hãy gọi phương thức này trước khi liên kết quảng cáo với một NativeAdView.

Thông số
placementId: Long

Một số nguyên dài do giao diện người dùng AdMob cung cấp cho vị trí đã định cấu hình.

setUnconfirmedClickListener

abstract fun setUnconfirmedClickListener(
    listener: NativeAd.UnconfirmedClickListener!
): Unit

Đặt UnconfirmedClickListener cho quảng cáo.