Stili nativi

Le impostazioni degli stili nativi consentono a Google Ad Manager di gestire il rendering degli annunci nativi in base agli stili nativi specificati all'interno del prodotto. Innanzitutto, specifica le dimensioni e il targeting. Poi aggiungi HTML, CSS e JavaScript per definire annunci adattabili e produrre una visualizzazione di qualità su tutti gli schermi. Non devi eseguire alcun rendering; Ad Manager applica automaticamente lo stile nativo corretto per la destinazione. Gli stili nativi vengono implementati proprio come gli annunci banner, utilizzando un GAMBannerView. Possono essere utilizzati con dimensioni annuncio fisse determinate in anticipo o con dimensioni annuncio flessibili determinate in fase di runtime.

Prerequisiti

• SDK Google Mobile Ads versione 7.14.0 o successive

Questa guida presuppone una conoscenza pratica dell'SDK Google Mobile Ads. Se non l'hai ancora fatto, consulta la nostra guida Inizia.

Dimensioni fisse

Gli stili nativi con dimensioni fisse ti consentono di controllare la larghezza e l'altezza dell'annuncio nativo. Per impostare una dimensione fissa:

1. Crea un elemento pubblicitario nell'UI di Ad Manager e seleziona una delle dimensioni predefinite dal menu a discesa del campo Size.

2. In Interface Builder, imposta la larghezza e l'altezza di GAMBannerView in modo che corrispondano alle dimensioni predefinite selezionate nel passaggio 1. Puoi visualizzare un elenco delle dimensioni e delle relative costanti GADAdSize nella sezione Dimensioni banner.

L'implementazione di stili nativi con una dimensione fissa è semplice come seguire le istruzioni riportate in La tua prima richiesta di banner, ma ottieni la flessibilità e il controllo su HTML, CSS e JavaScript per dare al tuo annuncio banner un aspetto nativo naturale nella tua app.

Dimensioni flessibili

In alcuni casi, una dimensione fissa potrebbe non essere appropriata. Ad esempio, potresti volere che la larghezza dell'annuncio corrisponda ai contenuti della tua app, ma che la sua altezza si adatti dinamicamente per adattarsi ai contenuti dell'annuncio. Per gestire questo caso, puoi specificare Fluid come dimensioni dell'annuncio nell'interfaccia utente di Ad Manager, il che indica che le dimensioni dell'annuncio vengono determinate in fase di runtime nell'app. L'SDK fornisce una costante speciale GADAdSize, kGADAdSizeFluid, per gestire questo caso. L'altezza dell'annuncio fluido viene determinata dinamicamente in base alla larghezza definita dal publisher, consentendo all'GAMBannerView di regolare la sua altezza in modo che corrisponda a quella della creatività.

Richiesta fluida

A differenza di altri formati degli annunci, la dimensione annuncio kGADAdSizeFluid non ha una larghezza predefinita, quindi assicurati di impostare esplicitamente la larghezza del frame del banner nel codice o in Interface Builder. Se non viene specificata una larghezza, l'SDK imposta per impostazione predefinita l'altezza del banner in base alla larghezza completa del dispositivo.

Se effettui una richiesta multiformato che include kGADAdSizeFluid, l'annuncio restituito viene sempre inserito in un contenitore flessibile e si comporta come un annuncio flessibile. Nel caso in cui in questo contenitore fluido venga restituita una creatività non fluida, l'SDK centra l'annuncio nel contenitore in modo da non dover modificare il vincolo di larghezza ogni volta che viene restituito un nuovo annuncio.

L'implementazione per effettuare una richiesta flessibile di una singola dimensione e di più dimensioni è molto simile; l'unica differenza è che per una richiesta di più dimensioni, devi impostare la proprietà validAdSizes per specificare le dimensioni dell'annuncio valide per la richiesta:

bannerView.validAdSizes = [nsValue(for: AdSizeFluid), nsValue(for: AdSizeBanner)]

_bannerView.validAdSizes = @[ NSValueFromGADAdSize(kGADAdSizeFluid),
                              NSValueFromGADAdSize(kGADAdSizeBanner) ];

Ecco come si presenta l'implementazione completa nel codice:

var bannerView: AdManagerBannerView!

override func viewDidLoad() {
super.viewDidLoad()
  // Create the GAMBannerView and set its width to a width that makes sense for your
  // app. In this example, the width is set to the width of the UIViewController's
  // root view.
  bannerView = AdManagerBannerView(adSize: AdSizeFluid)
  var frameRect = bannerView.frame
  frameRect.size.width = view.bounds.width
  bannerView.frame = frameRect

  // Uncomment this code for a multisize fluid request.
  // bannerView.validAdSizes = [nsValue(for: AdSizeFluid), nsValue(for: AdSizeBanner)]

  bannerView.adUnitID = "YOUR_AD_UNIT_ID"
  bannerView.rootViewController = self

  // Make the ad request.
  bannerView.load(AdManagerRequest())
}

GAMBannerView *_bannerView;

- (void)viewDidLoad {
  [super viewDidLoad];
  // Create the GAMBannerView and set its width to a width that makes sense for your
  // app. In this example, the width is set to the width of the UIViewController's
  // root view.
  _bannerView = [[GAMBannerView alloc] initWithAdSize:kGADAdSizeFluid];
  CGRect frameRect = _bannerView.frame;
  frameRect.size.width = CGRectGetWidth(self.view.bounds);
  _bannerView.frame = frameRect;

  // Uncomment this code for a multisize fluid request.
  // _bannerView.validAdSizes = @[ NSValueFromGADAdSize(kGADAdSizeFluid),
  //                               NSValueFromGADAdSize(kGADAdSizeBanner) ];

  _bannerView.adUnitID = @"YOUR_AD_UNIT_ID";
  _bannerView.rootViewController = self;

  // Make the ad request.
  [_bannerView loadRequest:[GAMRequest request]];
}

Per vedere un'implementazione di esempio delle dimensioni dell'annuncio flessibile di Ad Manager, scarica l'app demo dell'API iOS in Swift o Objective-C.

Scarica la demo dell'API

Protocollo GADAdSizeDelegate

Potresti voler conoscere l'altezza di un banner prima che le dimensioni dell'annuncio cambino. Il callback adView:willChangeAdSizeTo: notifica il suo delegato prima che la visualizzazione del banner cambi nel nuovo GADAdSize. Per ricevere una notifica prima che la visualizzazione del banner cambi in base alle nuove dimensioni dell'annuncio, la tua classe deve essere conforme al protocollo GADAdSizeDelegate.

Ecco un'implementazione di esempio del callback adView:willChangeAdSizeTo: che mostra come ottenere la nuova larghezza e la nuova altezza del banner:

// To be notified before the banner's ad size changes, your view controller class must
// conform to the GADAdSizeDelegate protocol.
bannerView.adSizeDelegate = self

// MARK: - GADAdSizeDelegate

func adView(_ bannerView: BannerView, willChangeAdSizeTo adSize: AdSize) {
  let height = adSize.size.height
  let width = adSize.size.width
}

// To be notified before the banner's ad size changes, your view controller class must
// conform to the GADAdSizeDelegate protocol.
_bannerView.adSizeDelegate = self;

#pragma mark - GADAdSizeDelegate

- (void)adView:(GADBannerView *)bannerView willChangeAdSizeTo:(GADAdSize)adSize {
  CGFloat height = adSize.size.height;
  CGFloat width = adSize.size.width;
}