NativeAd

public 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

public abstract class NativeAd.AdChoicesInfo

Thông tin phân bổ.

public 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

Phương thức công khai

abstract void

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 void

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

abstract void

Phương thức này không được dùng nữa.

Sử dụng enableCustomClickGestureDirection.

abstract @Nullable NativeAd.AdChoicesInfo

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

abstract @Nullable String

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

abstract @Nullable String

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

abstract @Nullable 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 @Nullable String

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

abstract @Nullable NativeAd.Image

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

abstract List<NativeAd.Image>

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

abstract @Nullable MediaContent

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

abstract 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 @Nullable 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 @Nullable ResponseInfo

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

abstract @Nullable 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 @Nullable 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

Phương thức này không đượ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 void
muteThisAd(MuteThisAdReason muteThisAdReason)

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

abstract void
performClick(Bundle clickData)

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 void

Phương thức này không đượ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(Bundle impressionData)

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 void
reportTouchEvent(Bundle touchEventData)

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

abstract void

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

abstract void

Đă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 void
setPlacementId(long placementId)

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

abstract void

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

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

NativeAd

public NativeAd()

Phương thức công khai

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

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ỏ

public abstract void destroy()

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

public abstract void enableCustomClickGesture()

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

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

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

getAdvertiser

public abstract @Nullable String getAdvertiser()

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

public abstract @Nullable String getBody()

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

getCallToAction

public abstract @Nullable String getCallToAction()

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

public abstract Bundle getExtras()

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

public abstract @Nullable String getHeadline()

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

public abstract @Nullable NativeAd.Image getIcon()

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

public abstract List<NativeAd.ImagegetImages()

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

public abstract @Nullable MediaContent getMediaContent()

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

getMuteThisAdReasons

public abstract List<MuteThisAdReasongetMuteThisAdReasons()

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

public abstract long getPlacementId()

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

getPrice

public abstract @Nullable String getPrice()

Đố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

public abstract @Nullable ResponseInfo getResponseInfo()

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

public abstract @Nullable Double getStarRating()

Đố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

public abstract @Nullable String getStore()

Đố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

public abstract boolean isCustomClickGestureEnabled()

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

public abstract boolean isCustomMuteThisAdEnabled()

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

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

Ẩ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

public abstract void performClick(Bundle clickData)

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ố
Bundle clickData

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

public abstract void recordCustomClickGesture()

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

public abstract boolean recordImpression(Bundle impressionData)

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ố
Bundle impressionData

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

public abstract void reportTouchEvent(Bundle touchEventData)

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ố
Bundle touchEventData

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

public abstract void setMuteThisAdListener(MuteThisAdListener listener)

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

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Đă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

public abstract void setPlacementId(long placementId)

Đặ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ố
long placementId

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

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

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