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 hanno un'altezza variabile e possono comprendere l'intero schermo o un'altezza massima specificata.

Puoi inserire 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, completa i seguenti passaggi:

  1. Ottieni la larghezza del dispositivo in uso o imposta la tua larghezza se non vuoi utilizzare la larghezza completa 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 funzionano meglio quando si utilizza la larghezza disponibile completa. Nella maggior parte dei casi, questa dimensione è la larghezza completa dello schermo del dispositivo in uso o la larghezza completa dei contenuti principali 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.
  • Potresti dover aggiornare o creare nuovi elementi pubblicitari per utilizzare le dimensioni adattive. Scopri di più.

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 pari 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