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 <AdVerifications> tag all'interno dei tag dell'annuncio VAST e invia i dati sulla visibilità a i fornitori di misurazione specificati utilizzando l'API OMID. L'SDK IMA supporta l'SDK OM v1.4, le estensioni AdVerifications di GAM su VAST 2+ e il nodo AdVerifications su VAST 4+.Per usufruire di Open Measurement, tieni presente i seguenti punti:

  • Per utilizzare Open Measurement, devi avere la versione 3.11.0 o successive 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.

  • Se utilizzi VAST 4.1 o versioni successive, gli annunci devono essere configurati per il trafficking di <AdVerifications> nel VAST in base alle specifiche di VAST 4.1. In caso contrario, deve essere utilizzato <Extension type="AdVerifications">.

  • Evita di coprire AdDisplayContainer con overlay (trasparenti o opachi), in quanto questi verranno contrassegnati 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 supporta l'SDK OM, insieme a un tag dell'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 di riproduzione essenziali. Sui dispositivi mobili, i tocchi imprecisi e le aspettative degli utenti hanno reso pratica comune il rendering di controlli di grandi dimensioni e touch-friendly sull'elemento multimediale. Questi controlli di solito vengono visualizzati e scompaiono quando l'utente tocca lo schermo e non sono visibili per la maggior parte del tempo di riproduzione.

Per un esempio di overlay dei controlli video, vedi l'immagine seguente sull'app YouTube che esegue il rendering dei controlli:

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 sopra il contenitore di visualizzazione dell'annuncio che è per lo più trasparente. In genere, i controlli sono elementi secondari di questa visualizzazione che occlude completamente il video player sottostante. Questo overlay trasparente viene utilizzato per acquisire gli eventi di tocco e quindi eseguire il rendering dei controlli per gli utenti quando vengono toccati.

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

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

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

REGISTRA 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 alla riproduzione
  • Filigrane
  • Popup
  • Finestre di dialogo
  • Pulsanti non temporanei
  • Altre visualizzazioni che oscurano

Il seguente codice campione mostra 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);

Al termine, queste ostruzioni possono essere rimosse chiamando il seguente metodo: 

displayContainer.unregisterAllFriendlyObstructions();