Annunci banner adattivi in linea

I banner adattivi ti consentono di specificare la larghezza di un annuncio per determinare le dimensioni ottimali dell'annuncio per ogni dispositivo. A differenza dei banner adattivi ancorati, i banner adattivi in linea sono più grandi, più alti e non utilizzano altezze fisse. I banner adattivi in linea hanno un'altezza variabile. Questi banner potrebbero occupare l'intero schermo o un'altezza massima specificata da te.

Questa guida illustra come creare banner adattivi in linea e impostarne le dimensioni.

L'immagine seguente mostra i banner adattivi in linea nei contenuti a scorrimento:

Prima di iniziare

Prima di continuare, assicurati di configurare gli annunci banner.

Per visualizzare un esempio completo di banner adattivo in linea, scarica la seguente app di esempio:

• Java
• Kotlin

Implementa i banner adattivi in linea

Per implementare i banner adattivi in linea, imposta le dimensioni dell'annuncio, crea una richiesta di annuncio e carica l'annuncio.

Per ridimensionare un banner adattivo in linea, determina la larghezza dell'annuncio. Gli approcci più comuni includono:

• Utilizzo della larghezza a schermo intero.
• Utilizzando la larghezza del layout principale contenente l'annuncio.
• Regolazione della larghezza per tenere conto delle aree sicure del dispositivo.

Quando crei l'oggetto della dimensione dell'annuncio, utilizza questa larghezza calcolata.

L'esempio seguente imposta le dimensioni dell'annuncio, crea una richiesta di annuncio e carica l'annuncio:

private fun loadInlineAdaptiveBannerAd(adView: AdView, activity: Activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val bannerWidth = 320
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth)
  val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.d(TAG, "Inline adaptive banner ad loaded.")
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Inline adaptive banner ad failed to load: $adError")
      }
    },
  )
}
BannerSnippets.kt

private void loadInlineAdaptiveBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  int bannerWidth = 320;
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth);
  BannerAdRequest adRequest = new BannerAdRequest.Builder(AD_UNIT_ID, adSize).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd bannerAd) {
          Log.d(TAG, "Inline adaptive banner ad loaded.");
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Inline adaptive banner ad failed to load: " + adError);
        }
      });
}
BannerSnippets.java

Sostituisci AD_UNIT_ID con l'ID unità pubblicitaria.

Imposta una dimensione dell'annuncio inferiore o uguale alle dimensioni dello schermo del dispositivo. Per determinare le dimensioni massime dello schermo, utilizza il metodo Resources.getDisplayMetrics. Le dimensioni dell'oggetto AdSize utilizzano pixel indipendenti dalla densità (dp). Quando esegui il confronto, converti le dimensioni dello schermo da pixel a dp. Per i dettagli sui vincoli di dimensione, consulta Requisiti relativi alle dimensioni delle richieste di annunci.

Imposta il layout del banner adattivo in linea

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

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

Se la tua app supporta le visualizzazioni verticale e orizzontale e vuoi precaricare un annuncio banner adattivo nel layout corrente, utilizza il metodo AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width). Questo metodo carica un annuncio nel layout corrente.

Limita l'altezza dei banner adattivi in linea

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