Tính năng đo lường mở trong SDK IMA DAI

SDK IMA dành cho iOS bao gồm SDK Đo lường mở (OM), là một tiêu chuẩn ngành được phát triển bởi Cục quảng cáo tương tác (IAB) để hỗ trợ bên thứ ba khả năng xem và đo lường xác minh. Khi sử dụng SDK IMA cho iOS, 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 khả năng xem tới các nhà cung cấp dịch vụ đo lường đã chỉ định thông qua OMID API.IMA SDK hỗ trợ SDK OM v1.4, tiện ích Xác minh quảng cáo GAM trên VAST 2 trở lên và nút AdVerifys trên VAST 4+.Để tận dụng tính năng Đo lường mở, hãy lưu ý những điểm sau:

  • Để sử dụng tính năng Đo lường mở, bạn phải có phiên bản 3.9.0 trở lên của SDK IMA dành cho iOS.

  • Quảng cáo phải được định cấu hình để quản lý <AdVerifications> trong VAST của quảng cáo theo thông số kỹ thuật VAST 4.1 nếu sử dụng VAST 4.1+; nếu không, <Extension type="AdVerifications"> nên sử dụng.

  • Không che AdDisplayContainer bằng bất kỳ lớp phủ nào (trong suốt hoặc không rõ ràng) vì những thành phần này sẽ bị OM gắn cờ là thành phần che khuất SDK và giảm khả năng xem.

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

Thử nghiệm

Để thử nghiệm tính năng Đo lường mở bằng SDK IMA, hãy sử dụng một trong các phiên bản bắt buộc của SDK ở trên, cùng với thẻ quảng cáo thử nghiệm.

Bạn sẽ thấy <AdVerifications> được trả về trong phản hồi VAST.

Đăng ký các thành phần che khuất điều khiển video

Các nút điều khiển video như nút tạm dừng hoặc thanh tiến trình cung cấp các thao tác phát cần thiết thông tin và hành động cho người dùng. Trên thiết bị di động, những lần nhấn không chính xác và người dùng Điều này khiến các kỳ vọng trở nên phổ biến là hiển thị hình ảnh lớn, thân thiện với cảm ứng các nút điều khiển đối với phần tử nội dung đa phương tiện. Các chế độ điều khiển này thường mờ dần khi người dùng nhấn vào và không hiển thị trong phần lớn thời gian phát.

Dưới đây là ví dụ về các nút điều khiển video do ứng dụng YouTube hiển thị:

Khi sử dụng SDK IMA, hầu hết nhà xuất bản đều triển khai các chế độ kiểm soát này bằng cách thêm một thành phần hiển thị phía trên vùng chứa hiển thị quảng cáo, trong đó vùng chứa này chủ yếu là trong suốt. Thông thường, các điều khiển là các phần tử con của khung hiển thị này che phủ hoàn toàn phần cơ bản trình phát video. Lớp phủ trong suốt này được dùng để chụp lại các sự kiện nhấn, sau đó hiển thị các điều khiển cho người dùng khi được nhấn.

Khi tính khả năng xem quảng cáo thông qua SDK Đo lường mở, tất cả thành phần hiển thị phủ lên phần tử nội dung nghe nhìn đều được coi là thành phần che khuất và làm giảm tỷ lệ khả năng xem. Trong trường hợp lớp phủ nhấn trong suốt nằm phía trên toàn bộ vùng chứa hiển thị quảng cáo, thì khoảng không quảng cáo có thể được khai báo là hoàn toàn không xem được.

SDK Đo lường mở đưa ra các điều khoản cho các chế độ điều khiển video cần được xem xét "thân thiện" các trở ngại thiết yếu đối với trải nghiệm của người dùng. Sau khi được đăng ký là thân thiện, các chế độ kiểm soát này sẽ bị loại trừ khỏi hoạt động đo lường khả năng xem quảng cáo.

Với sự hỗ trợ của IAB và MRC, SDK IMA sẽ giới thiệu một API để đăng ký các lớp phủ này bằng SDK Đo lường mở. Các thành phần điều khiển này phải là lớp phủ hoàn toàn minh bạch hoặc các nút nhỏ. Những lượt xem khác không liên quan đến phần điều khiển video phải chưa được đăng ký.

Đăng ký KHÔNG đăng ký
  • Lớp phủ trong suốt để ghi lại các lần nhấn của người dùng
  • Nút tạm thời
    • Tạm dừng
    • Phát
    • Toàn màn hình
    • Truyền/AirPlay
    • Thu gọn
    • Tiến trình/lượt tìm kiếm
    • Các thao tác khác liên quan khi phát
  • Hình mờ
  • Cửa sổ bật lên
  • Hộp thoại
  • Nút không tạm thời
  • Các chế độ xem che khuất khác

Mã mẫu sau đây minh hoạ cách đăng ký lớp phủ điều khiển video trên vùng chứa hiển thị quảng cáo:

UIView *myTransparentTapOverlay = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 250)];
UIButton *myPauseButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 50, 10)];
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the elements
// you want to register as video controls overlays.
// Make sure to register before ad playback starts.
IMAFriendlyObstruction *overlayObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myTransparentTapOverlay
                                           purpose:IMAFriendlyObstructionPurposeNotVisible
                                    detailedReason:@"This overlay is transparent"];
IMAFriendlyObstruction *pauseButtonObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myPauseButton
                                           purpose:IMAFriendlyObstructionPurposeMediaControls
                                    detailedReason:@"This is the video player pause button"];

[displayContainer registerFriendlyObstruction:overlayObstruction];
[displayContainer registerFriendlyObstruction:pauseButtonObstruction];

Sau khi xử lý xong, bạn có thể loại bỏ những vật cản này bằng cách gọi lệnh phương thức sau:

[displayContainer unregisterAllFriendlyObstructions];