Как включить Open Measurement

Выберите платформу: HTML5 Android iOS

В IMA SDK для Android входит Open Measurement (OM) SDK – отраслевой стандарт, разработанный Бюро интерактивной рекламы (IAB) и позволяющий сторонним поставщикам отслеживать видимость и проверять показы. При использовании IMA SDK для Android включенный в него OM SDK автоматически анализирует тег <AdVerifications> в тегах объявлений VAST и отправляет данные о видимости указанным поставщикам услуг по отслеживанию с помощью OMID API. IMA SDK поддерживает OM SDK версии 1.6, расширения AdVerifications в Google Менеджере рекламы для VAST 2 и более поздних версий, а также узел AdVerifications для VAST 4 и более поздних версий.Чтобы использовать Open Measurement, учитывайте следующее:

  • Чтобы использовать Open Measurement, у вас должна быть версия IMA SDK для Android 3.11.0 или более поздняя. Однако пример в этом руководстве предназначен для последней версии SDK и включает API, представленные в версии 3.16.5.

  • Объявления должны быть настроены так, чтобы в их коде VAST передавался элемент <AdVerifications> в соответствии со спецификацией VAST 4.1, если используется VAST 4.1 или более поздней версии. В противном случае необходимо использовать элемент <Extension type="AdVerifications">.

  • Не закрывайте AdDisplayContainer никакими оверлеями (прозрачными или непрозрачными), поскольку OM SDK пометит их как препятствия и снизит видимость.

Требования

Тестирование

Чтобы протестировать Open Measurement с помощью IMA SDK, используйте версию IMA, которая поддерживает OM SDK, и тестовый тег объявления.

В ответе VAST должен быть возвращен параметр <AdVerifications>.

Регистрация помех, связанных с оверлеем элементов управления видео

Элементы управления видео, такие как кнопки паузы или индикаторы выполнения, предоставляют пользователям важную информацию о воспроизведении и позволяют выполнять действия. На мобильных устройствах неточные нажатия и ожидания пользователей привели к тому, что над элементом мультимедиа стали отображаться большие, удобные для сенсорного управления элементы управления. Обычно они появляются и исчезают при нажатии и не видны большую часть времени воспроизведения.

Пример наложения элементов управления видео показан на изображении ниже.

Пример оверлея Open Measurement

При использовании IMA SDK большинство издателей реализуют эти элементы управления, добавляя над контейнером для показа объявлений прозрачную область просмотра. Обычно элементы управления являются дочерними элементами этого представления, которое полностью закрывает видеопроигрыватель. Этот прозрачный оверлей используется для регистрации нажатий и последующего показа элементов управления.

При расчете видимости рекламы с помощью Open Measurement SDK все просмотры, перекрывающие медиаэлемент, считаются препятствиями и снижают показатель видимости. Если прозрачный оверлей для нажатий расположен над всем контейнером объявления, то инвентарь может быть признан полностью невидимым.

В Open Measurement SDK предусмотрено, что элементы управления видео считаются "допустимыми" помехами, которые необходимы для удобства пользователей. После этого они будут исключены из оценки видимости объявлений.

При поддержке IAB и MRC в IMA SDK был добавлен API для регистрации таких оверлеев в Open Measurement SDK. Эти элементы управления должны быть полностью прозрачными оверлеями или небольшими кнопками. Другие представления, не связанные с элементами управления видео, регистрировать не нужно.

Зарегистрируйтесь НЕ регистрируйте
  • Прозрачный оверлей для регистрации нажатий пользователей
  • Временные кнопки
    • Приостановить
    • Воспроизвести
    • Полноэкранный режим
    • Трансляция/AirPlay
    • Свернуть
    • Ход воспроизведения/перемотка
    • Другие действия, связанные с воспроизведением
  • Водяные знаки
  • Всплывающие окна
  • Диал. окна
  • Постоянные кнопки
  • Другие способы маскировки

В приведенном ниже образце кода показано, как зарегистрировать оверлеи элементов управления видео в контейнере для показа объявлений. 

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);
}

Когда препятствия больше не нужны, их можно удалить, вызвав следующий метод: 

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