Attivare Open Measurement

Seleziona la piattaforma: HTML5 Android iOS

L'SDK IMA per Android 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 Android, l'SDK OM incluso analizza automaticamente il tag <AdVerifications> all'interno dei tag annuncio VAST e invia i dati di visibilità ai fornitori di misurazione specificati utilizzando l'API OMID. L'SDK IMA supporta l'SDK OM v1.4, le estensioni GAM AdVerifications su VAST 2+ e il nodo AdVerifications su VAST 4+.Per sfruttare Open Measurement, tieni presente quanto segue:

  • Per utilizzare Open Measurement, devi disporre della versione 3.11.0 o successiva dell'SDK IMA per Android. Tuttavia, l'esempio in questa guida è progettato per la versione più recente dell'SDK e include API introdotte nella versione 3.16.5.

  • Gli annunci devono essere configurati per il traffico <AdVerifications> nel VAST in base alle specifiche VAST 4.1 se si utilizza VAST 4.1 o versioni successive; in caso contrario, deve essere utilizzato <Extension type="AdVerifications">.

  • Evita di coprire il AdDisplayContainer con overlay (trasparenti o opachi), in quanto verranno segnalati come ostruzioni dall'SDK OM e ridurranno la visibilità.

Prerequisiti

Test

Per testare Open Measurement utilizzando l'SDK IMA, utilizza una versione di IMA che supporti l'SDK OM, insieme a un tag annuncio di test.

Dovresti vedere <AdVerifications> restituito nella risposta VAST.

Registra le ostruzioni dell'overlay dei controlli video

I controlli video, come i pulsanti di pausa o le barre di avanzamento, forniscono agli utenti informazioni e azioni essenziali per la riproduzione. Sui dispositivi mobili, i tocchi imprecisi e le aspettative degli utenti hanno reso prassi comune il rendering di controlli grandi e adatti al tocco sull'elemento multimediale. Questi controlli vengono visualizzati e nascosti quando l'utente tocca lo schermo e non sono visibili per la maggior parte del tempo di riproduzione.

Per un esempio di controlli video sovrapposti, vedi la seguente immagine sui controlli di rendering dell'app YouTube:

Immagine di esempio dell&#39;overlay di misurazione aperto

Quando utilizzano l'SDK IMA, la maggior parte dei publisher implementa questi controlli aggiungendo una visualizzazione per lo più trasparente sopra il contenitore di visualizzazione dell'annuncio. In genere, i controlli sono elementi secondari di questa visualizzazione che occludono completamente il video player sottostante. Questa overlay trasparente viene utilizzata per acquisire gli eventi di tocco e poi visualizzare i controlli per gli utenti quando vengono toccati.

Quando viene calcolata la visibilità degli annunci utilizzando l'SDK Open Measurement, tutte le visualizzazioni che si sovrappongono all'elemento multimediale vengono considerate ostruzioni e riducono il tasso di visibilità. Nel caso in cui una sovrapposizione trasparente per il tocco si trovi sopra l'intero contenitore di visualizzazione dell'annuncio, è possibile che l'inventario venga dichiarato completamente non visibile.

L'SDK Open Measurement prevede che i controlli video vengano considerati "ostacoli" essenziali per l'esperienza dell'utente. Una volta registrati come controlli compatibili, questi vengono esclusi dalla misurazione della visibilità degli annunci.

Con il supporto di IAB e MRC, l'SDK IMA introduce un'API per registrare queste sovrapposizioni con l'SDK Open Measurement. Questi controlli devono essere overlay completamente trasparenti o piccoli pulsanti. Qualsiasi altra visualizzazione non correlata ai controlli video non deve essere registrata.

DO register NON registrare
  • Overlay trasparente per acquisire i tocchi dell'utente
  • Pulsanti temporanei
    • Metti in pausa
    • Riproduci
    • Schermo intero
    • Trasmetti/AirPlay
    • Comprimi
    • Avanzamento/Ricerca
    • Altre azioni pertinenti per la riproduzione
  • Filigrane
  • Popup
  • Finestre di dialogo
  • Pulsanti non temporanei
  • Altre visualizzazioni che oscurano

Il seguente codice campione mostra come registrare le overlay dei controlli video nel contenitore di visualizzazione dell'annuncio: 

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}

OpenMeasurementSnippets.java

Una volta terminato, questi ostacoli possono essere rimossi chiamando il seguente metodo: 

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}
OpenMeasurementSnippets.java