Apri Measurement nell'SDK IMA

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 sulla visibilità ai fornitori di servizi di misurazione specificati tramite l'API OMID.L'SDK IMA supporta l'SDK OM 1.4, le estensioni GAM AdVerifications su VAST 2 e versioni successive e il nodo AdVerifications su VAST 4 e versioni successive.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 le API introdotte nella versione 3.16.5.

  • Gli annunci devono essere configurati per gestire il traffico di <AdVerifications> nel proprio VAST in base alle specifiche VAST 4.1 se si utilizzano VAST 4.1 e versioni successive; in caso contrario, è necessario utilizzare <Extension type="AdVerifications">.

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

Prerequisiti

Test

Per testare Open Measurement utilizzando l'SDK IMA, utilizza una delle versioni richieste dell'SDK sopra indicate, insieme a un tag annuncio di prova.

Dovresti vedere <AdVerifications> restituito nella risposta VAST.

Registra le ostruzioni degli overlay dei controlli video

I controlli video, come i pulsanti di pausa o le barre di avanzamento, forniscono agli utenti azioni e informazioni di riproduzione essenziali. Sui dispositivi mobili, i tocchi imprecisi e le aspettative degli utenti hanno reso comune la pratica di visualizzare controlli grandi e adatti al tocco sull'elemento multimediale. Questi controlli di solito appaiono e svaniscono al tocco dell'utente e non sono visibili per la maggior parte del tempo di riproduzione.

Di seguito è riportato un esempio di controlli video visualizzati dall'app YouTube:

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

Quando viene calcolata la visibilità dell'annuncio tramite l'SDK Open Measurement, tutte le visualizzazioni che si sovrappongono all'elemento multimediale vengono considerate ostruzioni e riducono il tasso di visibilità. Se un overlay trasparente per i tocchi si trova sopra l'intero contenitore di visualizzazione degli annunci, è possibile che l'inventario venga dichiarato completamente non visibile.

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

Con il supporto di IAB e MRC, l'SDK IMA introduce un'API per registrare questi overlay con l'SDK Open Measurement. Questi controlli devono essere overlay completamente trasparenti o piccoli pulsanti. Eventuali altre visualizzazioni non correlate ai controlli video non devono essere registrate.

Registrazione DO NON registrarti
  • Overlay trasparente per catturare i tocchi dell'utente
  • Pulsanti temporanei
    • Metti in pausa
    • Riproduci
    • Schermo intero
    • Trasmissione/AirPlay
    • Comprimi
    • Avanzamento/ricerca
    • Altre azioni pertinenti alla riproduzione
  • Filigrane
  • Popup
  • Finestre di dialogo
  • Pulsanti non temporanei
  • Altre visualizzazioni che offuscano

Il seguente codice di esempio illustra come registrare gli overlay dei controlli video nel contenitore di visualizzazione dell'annuncio: 

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

Quando hai finito, puoi rimuovere queste ostruzioni chiamando il seguente metodo: 

displayContainer.unregisterAllFriendlyObstructions();