google. ima. AdsManager
Cung cấp API công khai bên ngoài cho nhà xuất bản và giao tiếp với bản sao nội bộ của trình quản lý quảng cáo.
Phương pháp
thu gọn
thu gọn()
Thu gọn quảng cáo hiện tại. Đây là tuỳ chọn không hoạt động cho SDK HTML5.
định cấu hìnhAdsAdsManager
configAdsManager(content, adsRenderingSettings)
Đặt các thông số bắt buộc để lấy thông tin tham chiếu đến Ad Manager này từ sự kiện AdsManagerLoaded.
Thông số |
|
---|---|
nội dung |
Đối tượng Đối tượng phát lại nội dung của nhà xuất bản. Không được để trống giá trị. |
Cài đặt quảng cáo hiển thị |
Không bắt buộc Cài đặt hiển thị quảng cáo Các chế độ cài đặt không bắt buộc để kiểm soát việc hiển thị quảng cáo. Giá trị có thể rỗng. |
hủy bỏ
hủy()
Xóa các thành phần quảng cáo được tải trong thời gian chạy cần được xóa đúng cách tại thời điểm hoàn thành quảng cáo, đồng thời ngừng quảng cáo và tất cả hoạt động theo dõi.
hủy quảng cáo xen giữa
hủyAdBreak()
Nếu điểm chèn quảng cáo hiện đang phát, hãy loại bỏ quảng cáo đó và tiếp tục nội dung. Nếu không, hãy bỏ qua điểm chèn quảng cáo theo lịch tiếp theo. Ví dụ: Bạn có thể gọi lệnh này ngay sau khi trình quản lý quảng cáo tải để bỏ qua quảng cáo trước video mà không bỏ sót quảng cáo trong video hoặc sau video trong tương lai. Đây là không hoạt động trừ khi yêu cầu quảng cáo trả về danh sách phát hoặc phản hồi VMAP.
mở rộng
mở rộng()
Mở rộng quảng cáo hiện tại. Đây là tuỳ chọn không hoạt động cho SDK HTML5.
tiêu điểm
focus()
Đặt tiêu điểm vào nút bỏ qua (nếu có). Nếu không có tiêu điểm, hệ thống sẽ tập trung vào các thành phần tương tác, bao gồm cả biểu tượng hoặc mẫu quảng cáo tương tác.
Có thể bỏ qua trạng thái
getAdSkipState() trả về boolean
Trả về true nếu hiện có thể bỏ qua quảng cáo. Khi giá trị này thay đổi, AdsManager
sẽ kích hoạt một sự kiện AdEvent.SKIPPABLE_STATE_CHANGED
.
- Trả về
-
boolean
True nếu quảng cáo hiện có thể được bỏ qua, false nếu không.
getCuePoints
getCuePoints() trả về Mảng số
Trả về một mảng chênh lệch tính bằng giây cho biết thời điểm ngắt quảng cáo được lên lịch. Quảng cáo trước video được biểu thị bằng 0 và quảng cáo sau video được biểu thị bằng -1. Một mảng trống cho biết quảng cáo hoặc nhóm quảng cáo đó không có lịch biểu và có thể phát bất cứ lúc nào.
- Trả về
-
non-null Array of number
Danh sách chênh lệch về thời gian tính bằng giây.
Nhận thời gian còn lại
getRemainingTime() trả về số
Xem thời gian còn lại của quảng cáo hiện đang phát. Nếu quảng cáo chưa được tải hoặc đã phát xong, API sẽ trả về -1.
- Trả về
-
number
Trả về thời gian còn lại của quảng cáo hiện tại. Nếu thời gian còn lại không xác định cho quảng cáo hiện tại (ví dụ: quảng cáo tuỳ chỉnh), thì giá trị sẽ trả về -1.
nhận âm lượng
getVolume() trả về số
Nhận khối lượng cho quảng cáo hiện tại.
- Trả về
-
number
Âm lượng của quảng cáo hiện tại, từ 0 (bị tắt tiếng) đến 1 (lớn nhất).
init
init(chiều rộng, chiều cao, viewMode, videoElement)
Gọi init để khởi chạy trải nghiệm quảng cáo trên trình quản lý quảng cáo.
Thông số |
|
---|---|
chiều rộng |
number Chiều rộng quảng cáo đã chọn. |
độ cao |
number Chiều cao quảng cáo đã chọn. |
Chế độ xem |
Chế độ xem Chế độ xem đã chọn. Không được để trống giá trị. |
videoElement |
Không bắt buộc Phần tử video HTML Phần tử video để phát tuỳ chỉnh. Phần tử video này ghi đè phần tử được cung cấp trong hàm khởi tạo AdDisplayContainer. Bạn chỉ nên sử dụng thuộc tính này nếu thực sự cần thiết. Nếu không, bạn nên chỉ định phần tử video này trong khi tạo AdDisplayContainer. Giá trị có thể rỗng. |
isCustomClickTrackingUse
isCustomClickTrackingUse() trả về boolean
Trả về true nếu đang sử dụng phần tử theo dõi lượt nhấp tuỳ chỉnh để theo dõi
lượt nhấp trên quảng cáo hiện tại. Tính năng theo dõi lượt nhấp tuỳ chỉnh chỉ được sử dụng khi
bạn cung cấp phần tử theo dõi lượt nhấp tuỳ chọn cho
AdDisplayContainer
, phát lại tuỳ chỉnh và
quảng cáo hiện tại không phải là quảng cáo AdSense/AdX.
- Trả về
-
boolean
Có sử dụng tính năng theo dõi lượt nhấp tuỳ chỉnh hay không.
Đã sử dụng isCustomPlayback
isCustomPlayback luật() trả về boolean
Trả về true nếu sử dụng phần tử video tuỳ chỉnh để phát quảng cáo
hiện tại. Tính năng phát tuỳ chỉnh diễn ra khi bạn cung cấp một phần tử video không bắt buộc cho AdDisplayContainer
trên các nền tảng mà phần tử video tuỳ chỉnh cung cấp trải nghiệm xem quảng cáo liền mạch hơn.
- Trả về
-
boolean
Có sử dụng tính năng phát tuỳ chỉnh hay không.
tạm dừng
tạm dừng()
Tạm dừng quảng cáo hiện đang phát. Hàm này sẽ không hoạt động khi lớp phủ tĩnh đang hiển thị hoặc nếu quảng cáo chưa được tải hoặc phát xong.
đổi kích thước
đổi kích thước(chiều rộng, chiều cao, viewMode)
Đổi kích thước quảng cáo hiện tại.
Thông số |
|
---|---|
chiều rộng |
number Chiều rộng vùng quảng cáo mới. |
độ cao |
number Chiều cao vùng quảng cáo mới. |
Chế độ xem |
Chế độ xem Chế độ xem mới. Không được để trống giá trị. |
tiếp tục
tiếp tục()
Tiếp tục quảng cáo hiện tại đã được tải và tạm dừng. Hàm này sẽ không hoạt động khi lớp phủ tĩnh đang hiển thị hoặc nếu quảng cáo chưa được tải hoặc phát xong.
đặt âm lượng
setVolume(âm lượng)
Đặt âm lượng cho quảng cáo hiện tại.
Thông số |
|
---|---|
thể tích |
number Âm lượng được đặt, từ 0 (đã tắt tiếng) đến 1 (lớn nhất). |
bỏ qua
skip()
Bỏ qua quảng cáo hiện tại khi AdsManager.getAdSkippableState()
có giá trị true. Khi được gọi trong các trường hợp khác, việc bỏ qua không có hiệu lực. Sau khi
bỏ qua hoàn tất, AdsManager
sẽ kích hoạt một
sự kiện AdEvent.SKIPPED
.
bắt đầu
start()
Bắt đầu phát quảng cáo.
Trước tiên, nhà phát triển phải gọi AdDisplayContainer.initialize()
.
dừng
dừng()
Ngừng phát quảng cáo. Khi bạn gọi số này, nhà xuất bản sẽ quay lại nội dung.
updateAdsRenderingSettings
updateAdsRenderingSettings(adsRenderingSettings)
Cập nhật chế độ cài đặt hiển thị quảng cáo. Bạn nên sử dụng chỉ số này riêng cho các trường hợp sử dụng VMAP giữa các điểm chèn quảng cáo khi cần cập nhật các chế độ cài đặt hiển thị quảng cáo, chẳng hạn như tốc độ bit.
Thông số |
|
---|---|
Cài đặt quảng cáo hiển thị |
Cài đặt hiển thị quảng cáo Chế độ cài đặt hiển thị quảng cáo đã cập nhật. Không được để trống giá trị. |