google.
Lớp này đại diện cho một vùng chứa hiển thị quảng cáo. SDK sẽ tự động tạo các cấu trúc bên trong thông sốcontainerElement để chứa quảng cáo video và lớp phủ.
Khi một bản sao của lớp này được tạo, lớp này sẽ tạo một IFRAME trong vùng chứa và tải lõi SDK. IFRAME này phải được giữ nguyên để SDK hoạt động đúng cách. Sau khi phát hết quảng cáo
và SDK không cần thiết nữa, hãy dùng phương thức destroy()
để huỷ tải SDK.
Tham số vùng chứa vùng chứa phải là một phần tử của DOM. Cần phải định vị chính xác vùng chứa để quảng cáo hiển thị đúng cách. Bạn nên đặt video ở trên trình phát video nội dung và định kích thước trình phát để bao phủ toàn bộ trình phát video. Hãy tham khảo tài liệu về SDK để biết thông tin chi tiết về các cách triển khai được đề xuất.
Lưu ý: Luôn cần gọi phương thức initialize() trong mã được gọi trực tiếp bởi một hành động của người dùng (chẳng hạn như một lượt nhấp hoặc nhấn).
Hàm dựng
Vùng chứa quảng cáo hiển thị
mới AdDisplayContainer(containerElement, videoElement, clickTAGTrackingElement)
Thông số |
|
|---|---|
|
vùng chứa phần tử |
Phần tử hiển thị quảng cáo. Phần tử phải được chèn vào DOM trước khi tạo AdDisplayContainer. Không được để trống giá trị. |
|
videoElement |
Không bắt buộc Chỉ định phần tử quảng cáo dạng video thay thế. Bạn nên luôn chuyển vào trình phát video nội dung của mình. Không được để trống giá trị. |
|
nhấp theo dõi yếu tố |
Không bắt buộc Chỉ định phần tử lượt nhấp quảng cáo dạng video thay thế. Hãy để trống giá trị này để cho phép SDK xử lý các lượt nhấp. Ngay cả khi đã được cung cấp, SDK sẽ chỉ sử dụng phần tử theo dõi lượt nhấp tuỳ chỉnh khi mẫu quảng cáo không phải của AdSense/AdX hiển thị trong những môi trường không hỗ trợ thành phần giao diện người dùng phủ lên trình phát video (ví dụ: iPhone hoặc Android 4.0). Không được hiển thị phần tử theo dõi lượt nhấp tuỳ chỉnh qua trình phát video vì phần tử này có thể chặn các lượt nhấp đến các phần tử giao diện người dùng mà SDK hiển thị. Ngoài ra, xin lưu ý rằng SDK sẽ không sửa đổi chế độ hiển thị của phần tử theo dõi lượt nhấp tuỳ chỉnh. Điều này có nghĩa là nếu bạn cung cấp phần tử theo dõi lượt nhấp tuỳ chỉnh, thì phần tử này phải hiển thị đúng cách khi phát quảng cáo tuyến tính. Bạn có thể kiểm tra ima.AdsManager.isCustomClickTrackingUse khi sự kiện ima.AdEvent.Type.STARTED được kích hoạt để xác định xem có hiển thị phần tử theo dõi lượt nhấp tùy chỉnh của mình hay không. Nếu phù hợp với giao diện người dùng, bạn nên ẩn phần tử theo dõi lượt nhấp khi sự kiện ima.AdEvent.Type.CONTENT_RESUME_REQUESTED kích hoạt. Không được để trống giá trị. |
Phương pháp
hủy bỏ
hủy()
Huỷ trạng thái nội bộ và các phần tử DOM đã tạo trước đó. SDK IMA sẽ bị gỡ tải và không thực hiện lệnh gọi nào khác đến bất kỳ API nào.
khởi chạy
khởi tạo()
Khởi chạy các phần tử video nội bộ để phát lại. Bạn phải gọi phương thức này là kết quả trực tiếp của một hành động của người dùng. Khi đó, trình duyệt có thể đánh dấu phần tử video là do người dùng bắt đầu.
Một số trình duyệt sẽ cho phép phát video mà không cần người dùng tương tác nếu video bị tắt tiếng. Đối với hành vi này, hãy sử dụng AdsRequest.setAdWillPlayMuted(true) và gọi phương thức này trước AdsManager.start().