Включить открытое измерение в IMA

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

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

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

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

Предпосылки

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

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

В ответе VAST вы должны увидеть <AdVerifications> .

Регистрируйте препятствия наложения видеоконтроля

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

Ниже приведен пример элементов управления видео, отображаемых приложением YouTube:

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

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

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

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

НУЖНО зарегистрироваться НЕ регистрируйтесь
  • Прозрачная накладка для захвата нажатий пользователя
  • Кнопки переходного периода
    • Пауза
    • Играть
    • Полноэкранный
    • Трансляция/AirPlay
    • Крах
    • Прогресс/Поиск
    • Другие действия, связанные с воспроизведением
  • Водяные знаки
  • Всплывающие окна
  • Диалоги
  • Непереходные кнопки
  • Другие затемняющие виды

Следующий пример кода демонстрирует, как регистрировать наложения элементов управления видео в контейнере отображения рекламы:

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

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

displayContainer.unregisterAllFriendlyObstructions();