Banner adattivi incorporati

I banner adattivi consentono di specificare la larghezza di un annuncio per determinare la dimensione ottimale dell'annuncio. I banner adattivi massimizzano anche il rendimento ottimizzando le dimensioni dell'annuncio per ogni dispositivo. Questo approccio offre opportunità di miglioramento delle prestazioni.

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 occupare l'intero schermo o un'altezza massima specificata.

I banner adattivi in linea vengono inseriti nei contenuti scorrevoli, ad esempio:

Prima di iniziare

Prima di continuare, assicurati di avere quanto segue:

• L'SDK Google Mobile Ads 8.10.0 o versioni successive.
• Hai completato la guida introduttiva Annunci banner.

Implementare i banner adattivi

A differenza dei banner adattivi ancorati, i banner adattatori in linea vengono caricati utilizzando le dimensioni di un banner adattivo in linea. Per creare una dimensione dell'annuncio adattabile in linea, svolgi quanto segue:

1. Ottieni la larghezza del dispositivo in uso o imposta la tua larghezza se non vuoi utilizzare la larghezza intera dello schermo.
2. Utilizza i metodi statici appropriati per la classe delle dimensioni dell'annuncio, ad esempio GADCurrentOrientationInlineBannerAdSizeWithWidth(CGFloat width) per ottenere un oggetto con dimensioni dell'annuncio adattivo in linea per l'orientamento scelto.
3. Se vuoi limitare l'altezza del banner, utilizza il metodo statico GADInlineAdaptiveBannerAdSizeWithWidthAndMaxHeight(CGFloat width, CGFloat maxHeight) .

L'esempio seguente mostra questi passaggi:

Swift

// Step 1: Create an inline adaptive banner ad size. This size is used to
// request your adaptive banner. You can pass in the width of the device, or
// set your own width. This example sets a static width.
let adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(320)
// Step 2: Create banner with the inline size and set ad unit ID.
let bannerView = GAMBannerView(adSize: adSize)
bannerView.adUnitID = "<var>ad unit ID</var>"
bannerView.rootViewController = self

// For Ad Manager, the `adSize` property is used for the adaptive banner ad
// size. The `validAdSizes` property is used as normal for the supported
// reservation sizes for the ad placement.
bannerView.validAdSizes = [NSValueFromGADAdSize(GADAdSizeBanner)]

// Step 3: Load an ad.
let request = GAMRequest()
bannerView.load(request)
// TODO: Insert banner view in table view or scroll view, etc.

Objective-C

// Step 1: Create an inline adaptive banner ad size. This size is used to
// request your adaptive banner. You can pass in the width of the device, or set
// your own width. This example sets a static width.
GADAdSize *adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(320);
// Step 2: Create banner with the inline size and set ad unit ID.
GAMBannerView bannerView = [[GAMBannerView alloc] initWithAdSize:adSize];
bannerView.adUnitID = @"<var>ad unit ID</var>";
bannerView.rootViewController = self;

// For Ad Manager, the adSize property is used for the adaptive banner ad size.
// The validAdSizes property is used as normal for the supported reservation
// sizes for the ad placement. This is optional and only needed if you wish to
// support reservation ad sizes.
bannerView.validAdSizes = @[ NSValueFromGADAdSize(GADAdSizeBanner) ];

// Step 3: Load an ad.
GAMRequest *request = [GAMRequest request];
[bannerView loadRequest:request];
// TODO: Insert banner view in table view or scroll view, etc.

Importante: le dimensioni degli annunci basati su prenotazione di Ad Manager possono essere pubblicati nella stessa area annuncio degli annunci con dimensioni banner adattivi. Per utilizzare i banner adattivi con gli annunci di prenotazione di Ad Manager nella stessa area annuncio, sono necessarie due modifiche. Innanzitutto, imposta adSize sulle dimensioni adattive. In secondo luogo, imposta validAdSizes su un array di dimensioni contenente tutte le dimensioni degli annunci basati su prenotazione che vuoi pubblicare nell'area annuncio adattabile.

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

• Le dimensioni dei banner adattivi in linea funzionano al meglio se utilizzi l'intera larghezza disponibile. Nella maggior parte dei casi, queste dimensioni corrispondono alla larghezza dello schermo del dispositivo in uso o alla larghezza totale 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 lavorare con le dimensioni dinamiche. Ulteriori informazioni.

Orientare le dimensioni del banner adattivo in linea

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

• GADPortraitInlineAdaptiveBannerAdSizeWithWidth(CGFloat width)

• GADLandscapeInlineAdaptiveBannerAdSizeWithWidth(CGFloat width)

Se la tua app supporta le visualizzazioni sia verticale che orizzontale e vuoi precaricare un annuncio banner adattivo nell'orientamento corrente, utilizza GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(CGFloat width) Questo metodo carica un annuncio nell'orientamento corrente.

Limita altezza del banner adattivo in linea

Per impostazione predefinita, i banner adattivi in linea creati senza un valore maxHeight hanno un valore maxHeight uguale all'altezza del dispositivo. Per limitare l'altezza del banner adattivo in linea, utilizza il metodo GADInlineAdaptiveBannerAdSizeWithWidthAndMaxHeight(CGFloat width, CGFloat maxHeight).

Risorse aggiuntive

Esempi su GitHub

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

Swift Objective-C