El SDK de IMA para HTML5 incluye el SDK de Open Measurement (OM), un estándar de la industria desarrollado por el Interactive Advertising Bureau (IAB) para habilitar la medición de visibilidad y verificación de terceros. Cuando se usa el SDK de IMA para HTML5, el SDK de OM incluido analiza automáticamente la etiqueta <AdVerifications> dentro de las etiquetas de anuncios de VAST y envía datos de visibilidad a los proveedores de medición especificados con la API de OMID. De manera opcional, puedes establecer reglas de modo de acceso para cada solicitud para controlar el contenido al que puede acceder la secuencia de comandos de verificación.
El SDK de IMA admite el SDK de OM v1.4.
Requisitos previos
Si usas VAST 4.1 o una versión posterior, los anuncios deben configurarse para proporcionar la verificación con
<AdVerifications>. Si se usan versiones anteriores de VAST, los anuncios deben usar<Extension type="AdVerifications">.Si tus anuncios se publican a través de Ad Manager, configura un proveedor de visibilidad para tu red de Ad Manager y asígnale ese proveedor a tu línea de pedido. Para obtener más información, consulta Configura un proveedor de visibilidad para tu red de Ad Manager.
Modos de acceso
El SDK de OM admite la ejecución de secuencias de comandos de verificación en cuatro modos de acceso diferentes, que controlan el acceso que puede tener la secuencia de comandos de verificación:
FULL: La secuencia de comandos de verificación tiene acceso directo a la creatividad y a la página del publicador.CREATIVE: La secuencia de comandos de verificación y la creatividad se encuentran en una zona de pruebas de la página del publicador. Sin embargo, la secuencia de comandos tiene acceso directo a la creatividad.DOMAIN: La secuencia de comandos de verificación está en zona de pruebas y no puede acceder a la página de la creatividad ni del publicador. Sin embargo, la secuencia de comandos se carga de manera tal que puede confirmar directamente en qué dominio del publicador se encuentra.LIMITED: La secuencia de comandos de verificación está en la zona de pruebas y no puede acceder a la página del publicador ni de la creatividad, ni confirmar directamente en qué dominio del publicador se encuentra.
Es posible que algunos proveedores de visibilidad no admitan todos los modos de acceso. Comunícate con tus proveedores de visibilidad para verificar qué modos son compatibles.
Cómo establecer las reglas de modo de acceso para una solicitud
Las reglas de modo de acceso deben establecerse a nivel deAdsRequest. Para establecer diferentes modos de acceso para diferentes proveedores de secuencias de comandos de verificación, pasa un diccionario que asigne cada OmidVerificationVendor a uno de los modos de acceso mencionados anteriormente. El campo OmidVerificationVendor.OTHER se usa para establecer el modo de acceso predeterminado para todos los proveedores que no se incluyen de forma explícita en el diccionario. Si no se especifican reglas de modo de acceso, las secuencias de comandos de verificación se ejecutan en el modo de acceso LIMITED para los proveedores.
Consulta el siguiente ejemplo, que establece GOOGLE en google.ima.OmidAccessMode.FULL. Todos los demás proveedores, incluidos los que se enumeran en OmidVerificationVendor, usan la configuración predeterminada de OmidVerificationVendor.OTHER.
request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
= google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
= google.ima.OmidAccessMode.DOMAIN;
Para implementar el modo de acceso CREATIVE, debes seguir estos dos pasos:
Usa la zona de pruebas para tu reproductor de video en un iframe seguro, aislado del resto del sitio.
Establece el
OmidAccessModede tu socio de visibilidad enFULL.