Các chế độ hoạt động của SDK
SDK có thể hoạt động ở một hoặc nhiều chế độ, tuỳ thuộc vào nội dung phản hồi quảng cáo mà SDK nhận được từ máy chủ quảng cáo.
- Một quảng cáo
- Một quảng cáo có thể được phát bất cứ lúc nào khi thông báo
start
được gửi đếnIMAAdsManager
. Bạn không cần phải khởi chạy đặc biệt để phát một quảng cáo. - Nhóm quảng cáo
- Một số quảng cáo sẽ phát lặp lại khi thông báo
start
được gửi đếnIMAAdsManager
. Bạn không cần phải khởi chạy đặc biệt để phát một nhóm quảng cáo. - Quy tắc quảng cáo
- Danh sách phát gồm các điểm chèn quảng cáo được lên lịch vào những thời điểm nhất định dựa trên nội dung cụ thể. Thông báo
start
bị bỏ qua ở chế độ quy tắc quảng cáo. Có thể có nhiều điểm chèn quảng cáo được lên lịch trong một danh sách phát (ví dụ: trước video, giữa video, sau video). Để biết thêm thông tin chi tiết về cách triển khai, hãy xem phần Quy tắc quảng cáo bên dưới.
Quy tắc quảng cáo
IMA tvOS SDK hỗ trợ danh sách phát quảng cáo hoàn toàn tự động. Tính năng này chèn điểm chèn quảng cáo vào nội dung như chỉ định trong Google Ad Manager khi quản lý quảng cáo. Điều này cũng giúp đơn giản hoá đáng kể mã trình phát video cần thiết để hỗ trợ các điểm chèn quảng cáo, bao gồm quảng cáo trước video, trong video và sau video.
- Khi quản lý quảng cáo trong Ad Manager, bạn có thể chỉ định các quy tắc quảng cáo khác nhau như "luôn phát điểm chèn quảng cáo ở đầu nội dung" hoặc "phát một điểm chèn quảng cáo 1 phút mỗi 30 phút nội dung".
- Khi quảng cáo được yêu cầu, máy chủ quảng cáo có thể trả về danh sách phát quảng cáo. SDK sẽ xử lý danh sách phát và tự động lên lịch cho các điểm chèn quảng cáo đã được chỉ định.
- Khi khởi tạo
AdsManager
, đối tượngIMAContentPlayhead
sẽ được chuyển vào thông qua lệnh gọiinitializeWithContentPlayhead:adsRenderingSettings:
. Nếu đang sử dụng AVPlayer để hiển thị nội dung, bạn sẽ truyền một thực thể củaIMAAVPlayerContentPlayhead
đến SDK khi tạoadDisplayContainer
. Đối tượng này dùng để theo dõi tiến trình phát nội dung, nhờ đó, hệ thống sẽ tự động chèn điểm chèn quảng cáo vào những thời điểm được chỉ định trong Ad Manager.
Đối với AVPlayer:
IMAContentPlayhead *contentPlayhead = [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer]; IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl adDisplayContainer:adDisplayContainer contentPlayhead:contentPlayhead userContext:nil];
Không dùng AVPlayer:
- Triển khai giao diện
IMAContentPlayhead
. - Triển khai
currentTime
để trả về thời gian hiện tại của trình phát video. - Thay đổi lệnh gọi khởi động
IMAAdsManager
để sử dụnginitializeWithContentPlayhead:self
.
- Triển khai giao diện
- IMAAdsManagerDelegate dùng để tạm dừng và tiếp tục nội dung khi phát điểm chèn quảng cáo.
Lưu ý: Khi nội dung đã phát xong hoặc người dùng đã dừng phát, hãy nhớ gọi contentComplete
trên IMAAdsLoader
để báo hiệu cho SDK rằng nội dung đã phát xong. Sau đó, SDK sẽ phát điểm chèn quảng cáo sau video nếu đã lên lịch phát điểm chèn quảng cáo đó.
Sự kiện ALL_ADS_COMPLETED
sẽ tăng lên khi tất cả điểm chèn quảng cáo đã được phát. Ngoài ra, xin lưu ý rằng hoạt động theo dõi nội dung bắt đầu khi phương thức initializeWithContentPlayhead:adsRenderingSettings
của IMAAdsManager
được gọi và bạn phải luôn gọi initializeWithContentPlayhead:adsRenderingSettings
trước khi phát nội dung.