Open Measurement

L'SDK IMA per HTML5 include l'SDK Open Measurement (OM), uno standard di settore sviluppato dall'Interactive Advertising Bureau (IAB) per consentire la misurazione della visibilità e della verifica di terze parti. Quando utilizzi l'SDK IMA per HTML5, l'SDK OM incluso analizza automaticamente il tag <AdVerifications> all'interno dei tag annuncio VAST e invia i dati sulla visibilità ai fornitori di servizi di misurazione specificati utilizzando l'API OMID. Facoltativamente, puoi impostare regole di modalità di accesso per ogni richiesta al fine di controllare a quali contenuti può accedere lo script di verifica.

L'SDK IMA supporta la versione 1.4 dell'SDK OM.

Prerequisiti

  • Se utilizzi VAST 4.1 o versioni successive, gli annunci devono essere configurati per fornire la verifica utilizzando <AdVerifications>. Se utilizzi versioni VAST precedenti, gli annunci devono usare <Extension type="AdVerifications">.

  • Se il traffico dei tuoi annunci avviene tramite Ad Manager, configura un fornitore visibilità per la tua rete Ad Manager e assegnalo al tuo elemento pubblicitario. Per ulteriori informazioni, consulta Configurare un fornitore visibilità per la propria rete Ad Manager.

Modalità di accesso

L'SDK OM supporta l'esecuzione di script di verifica in quattro diverse modalità di accesso che controllano l'ambito di accesso dello script di verifica:

  • FULL: lo script di verifica ha accesso diretto alla creatività e alla pagina dell'editore.

  • CREATIVE: lo script di verifica e la creatività vengono esclusi tramite sandbox dalla pagina del publisher. Tuttavia, lo script ha accesso diretto alla creatività.

  • DOMAIN: lo script di verifica è limitato tramite sandbox e non può accedere alla pagina della creatività o del publisher. Tuttavia, lo script viene caricato in modo tale da poter confermare direttamente su quale dominio dell'editore si trova.

  • LIMITED: lo script di verifica è limitato tramite sandbox, non può accedere alla creatività o alla pagina del publisher e non è in grado di confermare direttamente su quale dominio del publisher si trova.

Alcuni fornitori di servizi di visibilità potrebbero non supportare tutte le modalità di accesso. Contatta i tuoi fornitori di visibilità per verificare quali modalità sono supportate.

Impostare le regole della modalità di accesso per una richiesta

Le regole della modalità di accesso devono essere impostate a livello di StreamRequest. Per impostare modalità di accesso diverse per provider di script di verifica diversi, passa un dizionario che mappa ogni OmidVerificationVendor a una delle modalità di accesso elencate sopra. Il campo OmidVerificationVendor.OTHER viene utilizzato per impostare la modalità di accesso predefinita per tutti i fornitori non inclusi esplicitamente nel dizionario. Se non vengono specificate regole per la modalità di accesso, gli script di verifica vengono eseguiti in modalità di accesso LIMITED per i fornitori.

Vedi l'esempio seguente che imposta GOOGLE su google.ima.dai.api.OmidAccessMode.FULL. Per tutti gli altri provider, inclusi quelli elencati in OmidVerificationVendor, viene utilizzato il valore impostato per 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.DOMAIN;

Per implementare la modalità di accesso CREATIVE, devi seguire entrambi i seguenti passaggi:

  1. Esegui la sandbox del tuo video player in un iframe sicuro, isolato dal resto del sito.

  2. Imposta il OmidAccessMode per il tuo partner per la visibilità su FULL.