Utilizzare i banner adattivi in linea per i banner scorrevoli

Seleziona la piattaforma: Android (beta) Nuovo Android iOS Flutter

I banner adattivi ti consentono di specificare la larghezza di un annuncio per determinare le dimensioni ottimali dell'annuncio. I banner adattivi massimizzano anche il rendimento ottimizzando le dimensioni dell'annuncio per ogni dispositivo. Questo approccio offre opportunità di miglioramento del 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 sono di altezza variabile e possono comprendere l'intero schermo o un'altezza massima specificata.

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

Diagramma che mostra le differenze tra i banner adattivi e i banner adattivi in linea

Prima di iniziare

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

Implementare i banner adattivi in linea

Per creare una dimensione dell'annuncio adattivo in linea, procedi nel seguente modo:

  1. Ottieni la larghezza del dispositivo in uso o imposta la tua larghezza se non vuoi utilizzare l'intera larghezza 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. Per ottenere un oggetto di dimensioni dell'annuncio adattivo in linea per l'orientamento scelto, utilizza un metodo statico nella classe delle dimensioni dell'annuncio:

    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 i seguenti punti:

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

Orientare le dimensioni dei banner adattivi in linea

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

Se la tua app supporta sia le visualizzazioni in verticale che in 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 di cui è stata creata un'istanza senza un valore maxHeight hanno un valore maxHeight uguale all'altezza del dispositivo. Per limitare l'altezza dei banner adattivi 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