L'SDK Google Mobile Ads ora supporta la versione beta di MRAID 3, basata sul supporto esistente di MRAID 2, che consente agli inserzionisti di pubblicare creatività MRAID 3 per i publisher Ad Manager. Questa guida chiarisce i dettagli di implementazione di MRAID che non erano chiari e aperti all'interpretazione nella specifica MRAID v3. Il pubblico di destinazione è costituito dagli autori delle creatività MRAID v3.
Prerequisiti
I publisher devono pubblicare:
- Google Play Services 15.0.0 o versioni successive per MRAID v3
- Google Play Services 7.8 o versioni successive per MRAID v2
Approfondimenti utili
Se non hai dimestichezza con MRAID, scopri di più nella pagina MRAID dell'IAB. Puoi anche scaricare il documento Definizioni di MRAID v3, che fornisce dettagli su tutti i parametri discussi di seguito, nonché il post del blog IAB su MRAID v3.
Dettagli sull'implementazione di MRAID v3 (beta)
Visibilità - evento exposureChange
Questo evento è supportato e consigliamo di utilizzare un ascoltatore per il nuovo eventoexposureChange anziché per l'evento viewableChange deprecato.
Anche il metodo mraid.isViewable() è deprecato. Tuttavia, questi metodi ritirati continueranno a essere supportati per mantenere la compatibilità con le versioni precedenti.
La definizione dell'evento exposureChange viene inviata ogni volta che la visualizzazione dell'annuncio cambia. L'SDK dispone di un meccanismo di polling per evitare di generare troppi eventi.
Lo stato iniziale viene inviato in modo asincrono dopo che l'annuncio ha registrato un ascoltatore.
Il callback include il parametro exposed_percentage, che è un numero con virgola mobile compreso tra 0.0 e 100.0.
Per esempi di utilizzo, consulta la specifica MRAID 3.
Rilevamento e inizializzazione di MRAID e attributi MRAID_ENV
L'SDK è conforme al protocollo di inizializzazione come definito nella specifica MRAID v3.
Nell'oggetto MRAID_ENV, l'SDK non invia IDFA, limitAdTracking,
ID app o COPPA (che sono facoltativi). Fornisce tutte le variabili obbligatorie
nell'oggetto MRAID_ENV, tra cui la versione MRAID, il nome dell'SDK e la versione dell'SDK.
Misurazione dell'udibilità
Viene introdotto un nuovo evento (audioVolumeChange) per identificare se l'audio può essere sentito e quando cambia il volume.
L'evento audioVolumeChange ha un unico parametro: volume_percentage.
Il valore è la percentuale del volume massimo di riproduzione audio. Si tratta di un
numero con rappresentazione in virgola mobile compreso tra 0.0 e 100.0 (0.0 se la riproduzione
non è consentita) o null se non è possibile determinare il volume.
Per esempi di utilizzo, consulta la specifica MRAID 3.
mraid.getLocation()
Poiché mraid.getLocation() non è supportato, viene sempre restituito -1.
mraid.unload()
Questo metodo può essere chiamato in qualsiasi momento e l'SDK reagisce chiudendo l'annuncio, disallocando le risorse e poi rimuovendo la visualizzazione web o sostituendola con un altro documento o un nuovo annuncio.
Quando la creatività chiama unload(), il livello nativo risponde come segue per i diversi tipi di creatività:
| Tipo | Comportamento di unload() |
|---|---|
| Banner | Crea una nuova richiesta di annuncio con gli stessi parametri di richiesta dell'annuncio corrente. |
| Interstitial | Chiudi l'interstitial. |
VPAID (Video Player Ad Interface Definition)
L'SDK Google Mobile Ads non supporta VPAID. mraid.supports('vpaid')
restituisce false.
mraid.useCustomClose()
mraid.useCustomClose() potrebbe non essere supportato, a seconda del formato e del tipo di creatività.
Dettagli sull'implementazione di MRAID v2
mraid.getVersion()
mraid.getVersion() non restituisce 2.0 finché la creatività non è stata caricata. Non controllare la versione MRAID se mraid.getState() restituisce loading.
mraid.resize()
Quando viene chiamato mraid.resize(), il banner originale viene sostituito con l'immagine dello screenshot del banner. Questo è evidente se l'annuncio ridimensionato
non copre lo spazio pubblicitario originale.
Inoltre, gli annunci ridimensionati non rispettano il frame del banner originale. Se un banner viene inserito in una visualizzazione scorrevole, l'annuncio ridimensionato non scorre con il banner.
mraid.setResizeProperties()
Tutte le chiamate a mraid.setResizeProperties() devono contenere un elenco completo delle proprietà obbligatorie. Se le proprietà di ridimensionamento non sono valide, verranno ripristinate quelle predefinite e tutte le chiamate successive a mraid.resize() non andranno a buon fine finché non verrà richiamata nuovamente mraid.setResizeProperties() con parametri validi.
mraid.getMaxSize()
mraid.getMaxSize() deve essere utilizzato solo per determinare le dimensioni massime degli annunci ridimensionati. Per determinare le dimensioni di un annuncio espandibile, utilizza mraid.getScreenSize().
mraid.setOrientationProperties()
Quando chiami mraid.setOrientationProperties() con la proprietà allowOrientationChange impostata su true, l'impostazione della proprietà forceOrientation non avrà alcun effetto.
Per le creatività che vogliono forzare l'orientamento, imposta allowOrientationChange su
false.
mraid.isViewable()
Se una visualizzazione copre un annuncio altrimenti visibile, verrà comunque restituito mraid.isViewable().true I contenuti dell'app non devono coprire gli annunci visibili.
mraid.getCurrentPosition()
Quando un annuncio espandibile in due parti è in stato espanso, una chiamata a
mraid.getCurrentPosition() sul primo componente restituirà le dimensioni dello schermo.
mraid.storePicture()
Affinché un'app supporti mraid.storePicture(), deve includere l'autorizzazione android.permission.WRITE_EXTERNAL_STORAGE.