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

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

В IMA SDK для iOS входит Open Measurement (OM) SDK – отраслевой стандарт, разработанный Бюро интерактивной рекламы (IAB) и позволяющий сторонним сервисам отслеживать видимость и проверять показы. При использовании IMA SDK для iOS включенный в него 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 для iOS версии 3.9.0 или более поздней.

  • Объявления должны быть настроены так, чтобы в их коде 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
    • Свернуть
    • Ход воспроизведения/перемотка
    • Другие действия, связанные с воспроизведением
  • Водяные знаки
  • Всплывающие окна
  • Диал. окна
  • Постоянные кнопки
  • Другие способы маскировки

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

UIView *myTransparentTapOverlay = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 250)];
UIButton *myPauseButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 50, 10)];
// Replace myTransparentTapOverlay and myPauseButton with your own elements
// that function as video control 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];

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

Objective-C 

- (void)unregisterObstructionsForContainer:(IMAAdDisplayContainer *)displayContainer {
    // This removes all previously registered friendly obstructions from the container.
    [displayContainer unregisterAllFriendlyObstructions];
}

Swift 

func unregisterObstructions(displayContainer: IMAAdDisplayContainer) {
  // This removes all previously registered friendly obstructions from the container.
  displayContainer.unregisterAllFriendlyObstructions()
}