SDK Quảng cáo trên phương tiện truyền thông tương tác (IMA) của Google cho HTML5 hỗ trợ Định nghĩa giao diện nghe nhìn tương tác bảo mật (SIMID) phiên bản 1.1. Hướng dẫn này trình bày các tính năng và thông báo cụ thể của SIMID mà IMA SDK hỗ trợ.
Hiểu rõ thông điệp từ mẫu quảng cáo đến người chơi
Bảng sau đây liệt kê các thông báo mà mẫu quảng cáo SIMID có thể gửi đến IMA SDK:
| Nhắn tin | Mô tả |
|---|---|
clickThru |
Xử lý lượt nhấp vào quảng cáo dựa trên URI mà mẫu quảng cáo cung cấp. |
fatalError |
Kết thúc phiên quảng cáo và báo cáo lỗi nghiêm trọng từ mẫu quảng cáo. |
getMediaState |
Trả về trạng thái hiện tại của trình phát nội dung nghe nhìn, bao gồm URI, currentTime, duration, volume và trạng thái tắt tiếng. |
log |
Chuyển tiếp thông điệp nhật ký mẫu quảng cáo đến IMA SDK để gỡ lỗi. |
reportTracking |
Yêu cầu SDK IMA ping URL theo dõi thay mặt cho mẫu quảng cáo. |
requestChangeAdDuration |
Yêu cầu sửa đổi tổng thời lượng của phiên quảng cáo. |
requestNavigation |
Yêu cầu điều hướng đến một URI bên ngoài. |
requestPause |
Yêu cầu SDK IMA tạm dừng trình phát nội dung nghe nhìn. |
requestPlay |
Yêu cầu SDK IMA tiếp tục hoặc phát trình phát nội dung nghe nhìn. |
requestResize |
Yêu cầu đổi kích thước trình phát video. Nếu trình phát cho phép đổi kích thước, thì SDK IMA sẽ đổi kích thước trình phát. |
requestSkip |
Yêu cầu SDK bỏ qua quảng cáo hiện tại. |
requestStop |
Yêu cầu SDK dừng phiên quảng cáo. |
handleSkipShown |
Thông báo cho IMA SDK rằng mẫu quảng cáo đã hiển thị giao diện người dùng bỏ qua quảng cáo. |
requestFocus |
Yêu cầu tiêu điểm cho iframe của mẫu quảng cáo. |
Xem thông báo về mẫu quảng cáo không được hỗ trợ cho trình phát
IMA SDK không xử lý các loại CreativeMessage sau:
requestChangeVolumerequestFullscreenrequestExitFullscreen
Hiểu rõ thông điệp quảng cáo dành cho người chơi
Bảng sau đây liệt kê các thông báo mà IMA SDK hỗ trợ gửi đến mẫu quảng cáo SIMID:
| Nhắn tin | Mô tả |
|---|---|
init |
Được gửi trong quá trình thiết lập phiên bằng dữ liệu môi trường và thông số quảng cáo. |
startCreative |
Thông báo cho mẫu quảng cáo để bắt đầu và hiển thị iframe mẫu quảng cáo. |
adStopped |
Thông báo rằng phiên quảng cáo đã kết thúc, bao gồm cả mã lý do. |
adSkipped |
Thông báo cho mẫu quảng cáo rằng người dùng hoặc IMA SDK đã bỏ qua quảng cáo. |
resize |
Thông báo cho mẫu quảng cáo về các thay đổi đối với kích thước trình phát hoặc video. |
appBackgrounded |
Thông báo cho mẫu quảng cáo rằng ứng dụng đã chuyển sang chế độ nền. |
appForegrounded |
Thông báo cho mẫu quảng cáo rằng ứng dụng đã quay lại nền trước. |
fatalError |
Thông báo cho mẫu quảng cáo về lỗi phía trình phát. |
log |
Gửi thông điệp nhật ký từ trình phát đến mẫu quảng cáo. |
focusIn |
Thông báo rằng mẫu quảng cáo đã được lấy tiêu điểm. |
Xem xét nội dung cập nhật về trạng thái nội dung nghe nhìn
IMA SDK gửi thông báo mediaStateUpdate đến mẫu quảng cáo cho các sự kiện sau:
playpausestalled(đang lưu vào bộ đệm)seekingseekedendeddurationchangetimeupdate, định kỳ.volumechange, bao gồm cả trạng thái tắt tiếng.