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 phản hồi quảng cáo mà SDK đó nhận được từ quảng cáo máy chủ.
- Quảng cáo đơn lẻ
- Một quảng cáo có thể phát bất cứ lúc nào khi
start
tin nhắn sẽ được gửi tớiIMAAdsManager
. Không có hoạt động khởi tạo đặc biệt để phát một quảng cáo. - Nhóm quảng cáo
- Một số quảng cáo phát ngược lại khi thông báo
start
được gửi đếnIMAAdsManager
. Không cần khởi tạo đặ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 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 cho các điểm chèn quảng cáo
nội dung. Thông báo
start
sẽ bị bỏ qua trong chế độ quy tắc quảng cáo. Có thể 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, cuối 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 iOS 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. Công cụ này cũng đơ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 cả 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 chẳng hạn 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 trong 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ề một danh sách phát quảng cáo. SDK 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 đã đã chỉ định.
- Khi khởi tạo
AdsManager
,IMAContentPlayhead
được truyền vào quainitializeWithContentPlayhead:adsRenderingSettings:
. Nếu bạn đang sử dụng AVPlayer để hiển thị nội dung của mình, bạn sẽ truyền bản saoIMAAVPlayerContentPlayhead
vào SDK khi bạn tạoadDisplayContainer
Đối tượng này được dùng để theo dõi tiến trình phát nội dung quảng cáo điểm chèn quảng cáo được tự động chèn tại thời điểm quy định trong Ad Manager.
Khi dùng AVPlayer:
IMAContentPlayhead *contentPlayhead = [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer]; IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl adDisplayContainer:adDisplayContainer contentPlayhead:contentPlayhead userContext:nil];
Nếu không có 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 chạy
IMAAdsManager
thành sử dụnginitializeWithContentPlayhead:self
.
- Triển khai giao diện
- IMAAdsManagerDelegate được dùng để tạm dừng và tiếp tục nội dung khi các điểm chèn quảng cáo được phát.
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 biết rằng nội dung
đã phát xong. Sau đó, SDK này sẽ phát điểm chèn quảng cáo sau video nếu đã được lên lịch.
Sự kiện ALL_ADS_COMPLETED
sẽ được thực hiện khi tất cả các điểm chèn quảng cáo đều có
đã được phát. Ngoài ra, xin lưu ý rằng hoạt động theo dõi nội dung bắt đầu khi
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.