SDK Quảng cáo của Google trên thiết bị di động hiện hỗ trợ phiên bản beta của MRAID v3, được xây dựng dựa trên tính năng hỗ trợ hiện có cho MRAID v2, cho phép nhà quảng cáo phân phát mẫu quảng cáo MRAID v3 cho nhà xuất bản Ad Manager. Hướng dẫn này làm rõ các chi tiết triển khai MRAID chưa rõ ràng và có thể diễn giải theo nhiều cách trong bảng thông số kỹ thuật MRAID v3. Đối tượng mục tiêu của hướng dẫn này là tác giả của mẫu quảng cáo MRAID v3.
Điều kiện tiên quyết
Nhà xuất bản phải đang chạy:
- SDK Quảng cáo của Google trên thiết bị di động cho iOS 7.30.0 trở lên cho MRAID v3
- SDK Quảng cáo của Google trên thiết bị di động cho iOS 7.4.0 trở lên cho MRAID v2
Tài liệu cơ bản hữu ích
Nếu chưa quen với MRAID, bạn có thể tìm hiểu thêm trên trang MRAID của IAB. Bạn cũng có thể tải tài liệu Định nghĩa MRAID v3 . Tài liệu này cung cấp thông tin chi tiết về tất cả các tham số được thảo luận bên dưới, cũng như bài đăng trên blog của IAB về MRAID v3.
Thông tin chi tiết về việc triển khai MRAID v3 (beta)
Khả năng xem – sự kiện exposureChange
Sự kiện này được hỗ trợ và bạn nên sử dụng trình nghe cho sự kiện exposureChange mới thay vì sự kiện viewableChange không dùng nữa.
Phương thức mraid.isViewable() cũng không dùng nữa. Tuy nhiên, các phương thức không dùng nữa này vẫn được hỗ trợ để duy trì khả năng tương thích ngược.
Định nghĩa sự kiện exposureChange được gửi bất cứ khi nào khung hiển thị quảng cáo thay đổi. SDK có cơ chế thăm dò ý kiến để tránh tạo quá nhiều sự kiện.
Trạng thái ban đầu được gửi không đồng bộ sau khi quảng cáo đăng ký trình nghe.
Lệnh gọi lại bao gồm tham số exposed_percentage, là một số dấu phẩy động
từ 0.0 đến 100.0.
Hãy tham khảo bảng thông số kỹ thuật MRAID v3 để biết mẫu sử dụng.
Phát hiện và khởi chạy MRAID và các thuộc tính MRAID_ENV
SDK tuân thủ giao thức khởi chạy như được xác định trong bảng thông số kỹ thuật MRAID v3.
Trong đối tượng MRAID_ENV, SDK không gửi IDFA, limitAdTracking, Mã ứng dụng hoặc COPPA (không bắt buộc). SDK cung cấp tất cả các biến bắt buộc trong đối tượng MRAID_ENV, bao gồm phiên bản MRAID, tên SDK và phiên bản SDK.
Đo lường khả năng nghe
Một sự kiện mới (audioVolumeChange) được giới thiệu để xác định xem có thể nghe thấy âm thanh hay không và thời điểm âm lượng thay đổi.
Sự kiện audioVolumeChange có một tham số: volume_percentage.
Giá trị là tỷ lệ phần trăm của âm lượng phát âm thanh tối đa. Đây là một
số dấu phẩy động từ 0.0 đến 100.0 (0.0 khi không được phép phát
) hoặc null nếu không xác định được âm lượng.
Hãy tham khảo bảng thông số kỹ thuật MRAID v3 để biết mẫu sử dụng.
mraid.getLocation()
Vì mraid.getLocation() không được hỗ trợ, nên phương thức này luôn trả về -1.
mraid.unload()
Bạn có thể gọi phương thức này bất cứ lúc nào và SDK sẽ phản ứng bằng cách đóng quảng cáo, huỷ phân bổ tài nguyên, sau đó xoá khung hiển thị web hoặc thay thế bằng một tài liệu khác hoặc một quảng cáo mới.
Khi mẫu quảng cáo gọi unload(), lớp gốc sẽ phản hồi như sau đối với các loại mẫu quảng cáo:
| Loại | Hành vi của unload() |
|---|---|
| Quảng cáo biểu ngữ | Tạo yêu cầu quảng cáo mới có cùng tham số yêu cầu như quảng cáo hiện tại. |
| Quảng cáo xen kẽ | Đóng quảng cáo xen kẽ. |
VPAID (Định nghĩa giao diện quảng cáo trên trình phát video)
SDK Quảng cáo của Google trên thiết bị di động không hỗ trợ VPAID. mraid.supports('vpaid')
trả về false.
mraid.useCustomClose()
mraid.useCustomClose() có thể không được hỗ trợ, tuỳ thuộc vào định dạng và loại mẫu quảng cáo.
Thông tin chi tiết về việc triển khai MRAID v2
mraid.getVersion()
mraid.getVersion() không trả về 2.0 cho đến khi mẫu quảng cáo đã tải. Đừng kiểm tra phiên bản MRAID khi mraid.getState() trả về loading.
mraid.resize()
Khi mraid.resize() được gọi, biểu ngữ gốc sẽ được thay thế bằng hình ảnh chụp màn hình của biểu ngữ. Bạn sẽ nhận thấy điều này nếu quảng cáo được đổi kích thước không bao phủ không gian quảng cáo ban đầu.
Quảng cáo được đổi kích thước cũng không tuân theo khung biểu ngữ ban đầu. Nếu một biểu ngữ được đặt trong khung hiển thị có thể cuộn, thì quảng cáo được đổi kích thước sẽ không cuộn theo biểu ngữ.
mraid.setResizeProperties()
Tất cả các lệnh gọi đến mraid.setResizeProperties() phải chứa danh sách đầy đủ các thuộc tính bắt buộc. Nếu các thuộc tính đổi kích thước không hợp lệ, chúng sẽ được đặt lại về giá trị mặc định và tất cả các lệnh gọi tiếp theo đến mraid.resize() sẽ không thành công cho đến khi mraid.setResizeProperties() được gọi lại bằng các tham số hợp lệ.
mraid.getMaxSize()
Bạn chỉ nên sử dụng mraid.getMaxSize() để xác định kích thước tối đa cho quảng cáo được đổi kích thước. Để xác định kích thước của quảng cáo có thể mở rộng, hãy sử dụng mraid.getScreenSize().
mraid.setOrientationProperties()
Khi gọi mraid.setOrientationProperties() với thuộc tính allowOrientationChange được đặt thành true, việc đặt thuộc tính forceOrientation sẽ không có tác dụng.
Mẫu quảng cáo muốn buộc hướng phải đặt allowOrientationChange thành false.
mraid.isViewable()
Nếu một khung hiển thị bao phủ một quảng cáo có thể nhìn thấy, thì mraid.isViewable() vẫn sẽ trả về true. Nội dung ứng dụng không được bao phủ quảng cáo có thể nhìn thấy.
mraid.getCurrentPosition()
Khi quảng cáo có thể mở rộng gồm 2 phần ở trạng thái mở rộng, lệnh gọi đến mraid.getCurrentPosition() trên phần đầu tiên sẽ trả về kích thước của màn hình.
mraid.supports()
Kể từ phiên bản SDK 7.11.0, mraid.supports("storePicture") và
mraid.supports("calendar") luôn trả về false. Theo bảng thông số kỹ thuật MRAID v2, mẫu quảng cáo phải có thể xử lý trường hợp các phương thức này không có sẵn.
mraid.storePicture()
Ứng dụng sẽ tự động yêu cầu quyền lưu hình ảnh khi mẫu quảng cáo MRAID gọi mraid.storePicture().