SDK Chèn quảng cáo động (DAI) của Google cho HTML5 hỗ trợ Secure Interactive Media Interface Definition (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ể về SIMID mà DAI SDK hỗ trợ.
Tìm hiểu về thông báo từ nhà sáng tạo đến người chơi
Bảng sau đây liệt kê những thông báo mà mẫu quảng cáo SIMID có thể gửi đến IMA DAI:
| Nhắn tin | Mô tả |
|---|---|
clickThru |
DAI SDK sẽ ping các URL theo dõi lượt nhấp được định cấu hình trong thẻ quảng cáo DAI. DAI SDK bỏ qua mọi URI tuỳ chỉnh hoặc lựa chọn điều hướng mà mẫu quảng cáo cung cấp. |
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 các thuộc tính currentTime, duration, volume, muted, paused và fullscreen. Thuộc tính currentSrc luôn trả về null vì DAI sử dụng các luồng được ghép nối phía máy chủ. |
log |
Chuyển tiếp thông báo nhật ký mẫu quảng cáo đến tính năng ghi nhật ký bảng điều khiển gỡ lỗi DAI SDK để khắc phục sự cố. |
reportTracking |
Yêu cầu DAI SDK ping URL theo dõi cho mẫu quảng cáo. |
requestPause |
Yêu cầu DAI SDK tạm dừng trình phát đa phương tiện. |
requestPlay |
Yêu cầu DAI SDK tiếp tục phát trên trình phát nội dung nghe nhìn. |
requestSkip |
Yêu cầu DAI SDK bỏ qua quảng cáo hiện tại. Chỉ được hỗ trợ cho các luồng VOD. Từ chối nếu mẫu quảng cáo gửi thông báo này cho một sự kiện phát trực tiếp. |
Xem xét những thông báo về mẫu quảng cáo không được hỗ trợ gửi đến trình phát
DAI SDK không xử lý các loại CreativeMessage sau đây:
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: luôn bị từ chối. Trình phát dự kiến mẫu quảng cáo sẽ xử lý thao tác điều hướng.requestResize: luôn bị từ chối. SDK DAI không hỗ trợ đổi kích thước mẫu quảng cáo.requestStop: luôn bị từ chối. Loại này dành cho các trường hợp sử dụng có thời lượng mở rộng mà DAI không hỗ trợ.requestChangeVolume: DAI SDK giải quyết thành công sự kiện này nhưng không thực hiện thay đổi về âm lượng cho mẫu quảng cáo.
Tìm hiểu về thông điệp từ người chơi đến nhà sáng tạo
Bảng sau đây liệt kê những thông báo mà DAI 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 với dữ liệu môi trường và các 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 của 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 SDK DAI đã bỏ qua quảng cáo. Chỉ được hỗ trợ cho các luồng VOD. |
Xem xét những thông báo về trình phát không được hỗ trợ đối với mẫu quảng cáo
SDK DAI không hỗ trợ hoặc gửi các thông báo sau đến mẫu quảng cáo:
resizeappBackgroundedappForegroundedlog
Xem thông tin cập nhật về trạng thái nội dung nghe nhìn
DAI 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)seekingseekedtimeupdate(định kỳ)volumechange(bao gồm cả trạng thái tắt tiếng)
DAI SDK không hỗ trợ các sự kiện sau và không gửi thông tin cập nhật về trạng thái nội dung nghe nhìn khi các sự kiện này xảy ra:
endeddurationchangeerror