Đo lường mở

SDK IMA cho HTML5 bao gồm SDK Đo lường mở (OM), một tiêu chuẩn ngành do Interactive Advertising Bureau (IAB) phát triển để cho phép đo lường khả năng xem và xác minh của bên thứ ba. Khi sử dụng SDK IMA cho HTML5, SDK OM đi kèm sẽ tự động phân tích cú pháp thẻ <AdVerifications> trong thẻ quảng cáo VAST và gửi dữ liệu về khả năng xem đến các nhà cung cấp dịch vụ đo lường được chỉ định bằng cách sử dụng API OMID. Bạn có thể tuỳ ý đặt quy tắc chế độ truy cập cho từng yêu cầu để kiểm soát nội dung mà tập lệnh xác minh có thể truy cập.

SDK IMA hỗ trợ OM SDK phiên bản 1.4.

Điều kiện tiên quyết

  • Nếu sử dụng VAST 4.1 trở lên, bạn phải định cấu hình quảng cáo để cung cấp thông tin xác minh bằng <AdVerifications>. Nếu sử dụng các phiên bản VAST trước đó, quảng cáo phải sử dụng <Extension type="AdVerifications">.

  • Nếu quảng cáo của bạn được phân phát thông qua Ad Manager, hãy định cấu hình nhà cung cấp khả năng xem cho mạng Ad Manager và chỉ định nhà cung cấp khả năng xem đó cho mục hàng của bạn. Để biết thêm thông tin, hãy xem bài viết Định cấu hình nhà cung cấp khả năng xem cho mạng Ad Manager.

Chế độ truy cập

SDK OM hỗ trợ chạy tập lệnh xác minh ở 4 chế độ truy cập khác nhau, giúp kiểm soát mức độ truy cập của tập lệnh xác minh:

  • FULL: Tập lệnh xác minh có quyền truy cập trực tiếp vào mẫu quảng cáo và trang nhà xuất bản.

  • CREATIVE: Tập lệnh xác minh và mẫu quảng cáo được đưa vào hộp cát từ trang nhà xuất bản. Tuy nhiên, tập lệnh có quyền truy cập trực tiếp vào mẫu quảng cáo.

  • DOMAIN: Tập lệnh xác minh được đưa vào hộp cát và không thể truy cập vào mẫu quảng cáo hoặc trang nhà xuất bản. Tuy nhiên, tập lệnh được tải theo cách có thể xác nhận trực tiếp miền của nhà xuất bản.

  • LIMITED: Tập lệnh xác minh được đưa vào hộp cát và không thể truy cập vào mẫu quảng cáo hoặc trang nhà xuất bản, cũng như không thể xác nhận trực tiếp miền của nhà xuất bản.

Một số nhà cung cấp chỉ số khả năng xem có thể không hỗ trợ tất cả chế độ truy cập. Hãy liên hệ với nhà cung cấp tính năng đo lường khả năng xem để xác minh xem chế độ nào được hỗ trợ.

Đặt quy tắc chế độ truy cập cho một yêu cầu

Bạn phải đặt quy tắc chế độ truy cập ở cấp AdsRequest. Để thiết lập các chế độ truy cập khác nhau cho các nhà cung cấp tập lệnh xác minh, hãy truyền một từ điển ánh xạ từng OmidVerificationVendor đến một trong các chế độ truy cập nêu trên. Trường OmidVerificationVendor.OTHER được dùng để đặt chế độ truy cập mặc định cho tất cả các nhà cung cấp không được đưa vào từ điển một cách rõ ràng. Nếu không có quy tắc chế độ truy cập nào được chỉ định, các tập lệnh xác minh sẽ chạy ở chế độ truy cập LIMITED cho nhà cung cấp.

Hãy xem ví dụ sau đây để đặt GOOGLE thành google.ima.OmidAccessMode.FULL. Tất cả các nhà cung cấp khác, bao gồm cả những nhà cung cấp được liệt kê trong OmidVerificationVendor, đều mặc định sử dụng cách thiết lập OmidVerificationVendor.OTHER.

request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
    = google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
    = google.ima.OmidAccessMode.DOMAIN;

Để triển khai chế độ truy cập CREATIVE, bạn phải làm theo cả hai bước sau:

  1. Tạo hộp cát cho trình phát video trong một iframe an toàn, tách biệt với phần còn lại của trang web.

  2. Đặt OmidAccessMode cho đối tác đo lường khả năng xem thành FULL.