Bật tính năng Đo lường mở

Chọn nền tảng: HTML5 Android iOS

SDK IMA dành cho Android bao gồm SDK Đo lường mở (OM), một tiêu chuẩn ngành do Cục Quảng cáo Tương tác (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 dành cho Android, 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 cho các nhà cung cấp dịch vụ đo lường được chỉ định bằng API OMID. SDK IMA hỗ trợ SDK OM phiên bản 1.4, các tiện ích AdVerifications của GAM trên VAST 2+ và nút AdVerifications 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ó SDK IMA dành cho Android phiên bản 3.11.0 trở lên. Tuy nhiên, mẫu trong hướng dẫn này được thiết kế cho phiên bản mới nhất của SDK và bao gồm các API được giới thiệu trong phiên bản 3.16.5.

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

  • Không phủ AdDisplayContainer bằng bất kỳ lớp phủ nào (trong suốt hoặc mờ đục), vì các lớp phủ này sẽ bị SDK OM gắn cờ là vật cản và làm giảm khả năng xem.

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

Thử nghiệm

Để kiểm thử tính năng Đo lường mở bằng SDK IMA, hãy sử dụng phiên bản IMA hỗ trợ SDK OM cùng với thẻ quảng cáo kiểm thử.

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

Đăng ký các vật cản lớp phủ nú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 thông tin và thao tác phát cần thiết cho người dùng. Trên thiết bị di động, các thao tác nhấn không chính xác và kỳ vọng của người dùng đã khiến việc hiển thị các nút điều khiển lớn, thân thiện với thao tác chạm trên phần tử nội dung nghe nhìn trở thành thông lệ. Các nút điều khiển này thường mờ dần khi người dùng nhấn và không hiển thị trong phần lớn thời gian phát.

Để xem ví dụ về việc phủ các nút điều khiển video, hãy xem hình ảnh sau đây về các nút điều khiển hiển thị trên ứng dụng YouTube:

Mở hình ảnh ví dụ về lớp phủ đo lường

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

Khi tính toán khả năng xem quảng cáo bằng SDK Đo lường mở, tất cả các chế độ xem phủ lên phần tử nội dung nghe nhìn đều được coi là vật cản 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ì có thể khai báo khoảng không quảng cáo là hoàn toàn không xem được.

SDK Đo lường mở cung cấp các nút điều khiển video được coi là vật cản "thân thiện" cần thiết cho trải nghiệm của người dùng. Sau khi được đăng ký là thân thiện, các nút điều khiển 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 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 nút điều khiển này phải là lớp phủ hoàn toàn trong suốt hoặc các nút nhỏ. Không được đăng ký bất kỳ chế độ xem nào khác không liên quan đến các nút điều khiển video.

CÓ đăng ký KHÔNG đăng ký
  • Lớp phủ trong suốt để ghi lại thao tác 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/Tìm kiếm
    • Các thao tác khác có liên quan đến việc 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

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

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}

OpenMeasurementSnippets.java

Khi bạn hoàn tất, các vật cản này có thể bị xoá bằng cách gọi phương thức sau: 

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}
OpenMeasurementSnippets.java