Banner adattivi incorporati

I banner adattivi consentono di specificare la larghezza di un annuncio per determinare le dimensioni ottimali dell'annuncio. I banner adattivi massimizzano il rendimento ottimizzando le dimensioni dell'annuncio per ogni dispositivo. Questo approccio offre opportunità per migliorare il rendimento.

Rispetto ai banner adattivi ancorati, i banner adattivi in linea sono più grandi, più alti e utilizzano altezze variabili anziché fisse. I banner adattivi in linea hanno un'altezza variabile e possono occupare l'intero schermo o un'altezza massima che specifichi.

Posiziona i banner adattivi in linea nei contenuti scorrevoli, ad esempio:

Prima di iniziare

Prima di continuare, assicurati di aver completato la guida introduttiva Annunci banner.

Implementare i banner adattivi

A differenza dei banner adattivi ancorati, i banner adattivi in linea vengono caricati utilizzando una dimensione adattiva in linea. Per creare una dimensione dell'annuncio adattabile in linea, completa i seguenti passaggi:

1. Ottieni la larghezza del dispositivo in uso o imposta la tua larghezza se non vuoi utilizzare la larghezza massima dello schermo.

   Kotlin

   private val adWidth: Int
     get() {
       val displayMetrics = resources.displayMetrics
       val adWidthPixels =
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
           val windowMetrics: WindowMetrics = this.windowManager.currentWindowMetrics
           windowMetrics.bounds.width()
         } else {
           displayMetrics.widthPixels
         }
       val density = displayMetrics.density
       return (adWidthPixels / density).toInt()
     }
   MainActivity.kt

   Java

   public int getAdWidth() {
     DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
     int adWidthPixels = displayMetrics.widthPixels;
   
     if (VERSION.SDK_INT >= VERSION_CODES.R) {
       WindowMetrics windowMetrics = this.getWindowManager().getCurrentWindowMetrics();
       adWidthPixels = windowMetrics.getBounds().width();
     }
   
     float density = displayMetrics.density;
     return (int) (adWidthPixels / density);
   }
   MainActivity.java

2. Utilizza i metodi statici appropriati nella classe delle dimensioni dell'annuncio, ad esempio AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) per ottenere un oggetto delle dimensioni dell'annuncio adattivo in linea per l'orientamento scelto.

   Kotlin

   val adView = AdView(this@MainActivity)
   adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, adWidth))
   MainActivity.kt

   Java

   final AdView adView = new AdView(MainActivity.this);
   adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, getAdWidth()));
   MainActivity.java

Quando implementi i banner adattivi nella tua app, tieni presente quanto segue:

• Le dimensioni dei banner adattivi in linea si adattano meglio quando viene utilizzata l'intera larghezza disponibile. Nella maggior parte dei casi, questa dimensione è la larghezza massima dello schermo del dispositivo in uso o del contenuto principale del banner. Devi conoscere la larghezza della visualizzazione da inserire nell'annuncio, la larghezza del dispositivo, la larghezza dei contenuti principali e le aree sicure applicabili.

Orientare le dimensioni del banner adattivo in linea

Per precaricare un annuncio banner adattivo in linea per un orientamento specifico, utilizza i seguenti metodi:

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

Se la tua app supporta sia la visualizzazione verticale che orizzontale e vuoi precaricare un annuncio banner adattivo nell'orientamento corrente, utilizza AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) Questo metodo carica un annuncio nell'orientamento corrente.

Limitare l'altezza dei banner adattivi in linea

Per impostazione predefinita, i banner adattivi in linea istanziati senza un valore maxHeight hanno un valore maxHeight pari all'altezza del dispositivo. Per limitare l'altezza del banner adattivo in linea, utilizza il metodo AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).

Risorse aggiuntive

Esempi su GitHub

Scarica l'applicazione di esempio per vedere i banner adattivi in linea in azione.

Java Kotlin