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

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

IMA SDK для HTML5 включает в себя Open Measurement (OM) SDK — отраслевой стандарт, разработанный Interactive Advertising Bureau (IAB) для обеспечения возможности измерения видимости и проверки сторонними сервисами. При использовании IMA SDK для HTML5 включенный OM SDK автоматически анализирует тег <AdVerifications> в рекламных тегах VAST и отправляет данные о видимости указанным поставщикам услуг измерения с помощью API OMID. При желании можно установить правила режима доступа для каждого запроса, чтобы контролировать, к какому контенту может получить доступ скрипт проверки.

IMA SDK поддерживает OM SDK версии 1.4.

Предварительные требования

  • При использовании VAST 4.1 или более поздней версии, объявления должны быть настроены на предоставление подтверждения с помощью <AdVerifications> . При использовании более ранних версий VAST объявления должны использовать <Extension type="AdVerifications"> .

  • Если ваши объявления размещаются через Ad Manager, настройте поставщика видимости для вашей сети Ad Manager и назначьте этого поставщика видимости вашему товару. Для получения дополнительной информации см. раздел «Настройка поставщика видимости для вашей сети Ad Manager» .

режимы доступа

OM SDK поддерживает запуск скриптов проверки в четырех различных режимах доступа, которые определяют, к чему может получить доступ скрипт проверки:

  • FULL : Скрипт проверки имеет прямой доступ к странице с рекламным материалом и странице издателя.

  • CREATIVE : Скрипт проверки и креативный материал изолированы от страницы издателя. Однако скрипт имеет прямой доступ к креативному материалу.

  • LIMITED : Скрипт проверки работает в изолированной среде и не может получить доступ к странице с креативом или издателем, а также не может напрямую подтвердить, на каком домене издателя он находится.

Некоторые поставщики услуг по обеспечению видимости могут не поддерживать все режимы доступа. Свяжитесь со своим поставщиком услуг по обеспечению видимости, чтобы уточнить, какие режимы поддерживаются. Ранее IMA поддерживала режим доступа DOMAIN , теперь по умолчанию используется режим LIMITED .

Задайте правила режима доступа для запроса.

Правила режима доступа должны быть заданы на уровне StreamRequest . Чтобы задать разные режимы доступа для разных поставщиков скриптов проверки, передайте словарь, который сопоставляет каждый OmidVerificationVendor с одним из перечисленных выше режимов доступа. Поле OmidVerificationVendor.OTHER используется для установки режима доступа по умолчанию для всех поставщиков, которые явно не включены в словарь. Если правила режима доступа не указаны, скрипты проверки выполняются в режиме LIMITED доступа для поставщиков.

См. следующий пример, в котором для параметра GOOGLE установлено значение google.ima.dai.api.OmidAccessMode.FULL . Для всех остальных поставщиков, включая перечисленных в OmidVerificationVendor , по умолчанию используется значение, заданное в параметре OmidVerificationVendor.OTHER .

request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.GOOGLE]
    = google.ima.dai.api.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.dai.api.OmidVerificationVendor.OTHER]
    = google.ima.dai.api.OmidAccessMode.LIMITED;

Для активации режима доступа CREATIVE необходимо выполнить оба следующих шага:

  1. Изолируйте свой видеоплеер в защищенном iframe, внедрив его в остальную часть сайта.

  2. Установите для вашего партнера по обеспечению видимости значение OmidAccessMode равным FULL .