IMA SDK для HTML5 включает в себя Open Measurement (OM) SDK — отраслевой стандарт, разработанный Бюро интерактивной рекламы (IAB) для обеспечения возможности стороннего измерения видимости и проверки. При использовании IMA SDK для HTML5 входящий в комплект OM SDK автоматически анализирует тег <AdVerifications> в рекламных тегах VAST и отправляет данные о видимости указанным поставщикам измерений с помощью API OMID. При желании вы можете установить правила режима доступа для каждого запроса, чтобы контролировать, к какому содержимому может получить доступ сценарий проверки.
IMA SDK поддерживает OM SDK v1.4.
Предварительные условия
При использовании VAST 4.1 или более поздней версии объявления должны быть настроены для обеспечения проверки с помощью
<AdVerifications>. При использовании предыдущих версий VAST объявления должны использовать<Extension type="AdVerifications">.Если ваши объявления размещаются через Менеджер рекламы, настройте поставщика видимости для своей сети Менеджера рекламы и назначьте этого поставщика видимости своей позиции. Дополнительную информацию см. в разделе Настройка поставщика видимости для вашей сети Менеджера рекламы .
Режимы доступа
OM SDK поддерживает запуск сценариев проверки в четырех различных режимах доступа, которые контролируют объем доступа сценария проверки:
FULL: скрипт проверки имеет прямой доступ к креативу и странице издателя.CREATIVE: сценарий проверки и объявление изолированы от страницы издателя. Однако скрипт имеет прямой доступ к креативу.DOMAIN: скрипт проверки находится в изолированной программной среде и не имеет доступа к объявлению или странице издателя. Однако скрипт загружается таким образом, что может напрямую подтвердить, в каком домене издателя он находится.LIMITED: сценарий проверки находится в изолированной программной среде и не может получить доступ к объявлению или странице издателя, а также не может напрямую подтвердить, в каком домене издателя он находится.
Некоторые поставщики видимости могут не поддерживать все режимы доступа. Свяжитесь с поставщиками видимости, чтобы узнать, какие режимы поддерживаются.
Установите правила режима доступа для запроса
Правила режима доступа должны быть установлены на уровнеAdsRequest . Чтобы установить разные режимы доступа для разных поставщиков сценариев проверки, передайте словарь, который сопоставляет каждый OmidVerificationVendor с одним из режимов доступа, перечисленных выше. Поле OmidVerificationVendor.OTHER используется для установки режима доступа по умолчанию для всех поставщиков, не включенных явно в словарь. Если правила режима доступа не указаны, сценарии проверки выполняются в режиме LIMITED доступа для поставщиков. См. следующий пример, в котором для GOOGLE устанавливается значение google.ima.OmidAccessMode.FULL . Все остальные поставщики, включая перечисленных в OmidVerificationVendor , по умолчанию используют настройку OmidVerificationVendor.OTHER .
request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
= google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
= google.ima.OmidAccessMode.DOMAIN;
Чтобы реализовать режим доступа CREATIVE , необходимо выполнить оба следующих шага:
Поместите свой видеоплеер в защищенный iframe, изолированный от остальной части вашего сайта.
Установите для
OmidAccessModeвашего партнера по видимости значениеFULL.