Opzioni per gli annunci nativi

Seleziona la piattaforma:Android iOS

Gli annunci nativi hanno molte funzionalità avanzate che ti consentono di apportare personalizzazioni aggiuntive e creare la migliore esperienza pubblicitaria possibile. Questa guida mostra come utilizzare le funzionalità avanzate degli annunci nativi.

Prerequisiti

Controlli degli asset

Questa sezione descrive in dettaglio come personalizzare gli asset delle creatività negli annunci nativi. Hai la possibilità di specificare un formato preferito per gli asset multimediali e la modalità di download e visualizzazione degli asset immagine.

Controlli delle proporzioni dei contenuti multimediali preferiti

I controlli delle proporzioni dei contenuti multimediali ti consentono di specificare una preferenza per le proporzioni delle creatività pubblicitarie.

Imposta GADNativeAdMediaAdLoaderOptions mediaAspectRatio con un GADMediaAspectRatio.

  • Se non è impostato, l'annuncio restituito può avere qualsiasi formato multimediale.

  • Se impostato, potrai migliorare l'esperienza utente specificando il tipo di proporzioni preferito.

L'esempio seguente indica all'SDK di preferire un'immagine o un video di ritorno con proporzioni specifiche.

Swift

let nativeOptions = NativeAdMediaAdLoaderOptions()
nativeOptions.mediaAspectRatio = .any

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdMediaAdLoaderOptions *nativeOptions = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOptions.mediaAspectRatio = GADMediaAspectRatioAny;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Sostituisci nativeAdUnitID con l'ID unità pubblicitaria.

Controllo del download delle immagini

Il controllo del download delle immagini ti consente di decidere se l'SDK deve restituire gli asset immagine o solo gli URI.

Imposta GADNativeAdImageAdLoaderOptions disableImageLoading con un valore BOOL.

  • Il controllo del download delle immagini è disattivato per impostazione predefinita.

  • Se disattivata, l'SDK Google Mobile Ads compila sia l'immagine sia l'URI.

  • Se abilitato, l'SDK compila solo l'URI, consentendoti di scaricare le immagini effettive a tua discrezione.

Il seguente esempio indica all'SDK di restituire solo l'URI.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.disableImageLoading = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Controlli del payload dell'immagine

Alcuni annunci hanno una serie di immagini anziché una sola. Utilizza questa funzionalità per indicare se la tua app è pronta a visualizzare tutte le immagini o solo una.

  • I controlli del payload dell'immagine sono disattivati per impostazione predefinita.

  • Se disattivata, l'app indica all'SDK di fornire solo la prima immagine per gli asset che contengono una serie.

  • Se attivata, la tua app indica di essere pronta a visualizzare tutte le immagini per gli asset che ne hanno più di una.

L'esempio seguente indica all'SDK di restituire più asset immagine.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.shouldRequestMultipleImages = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Posizionamenti di Scegli Tu!

Questa sezione descrive in dettaglio come posizionare l'overlay AdChoices. Hai la possibilità di impostare il posizionamento in uno dei quattro angoli o di eseguirne il rendering all'interno di una visualizzazione personalizzata.

Controlli della posizione di Scegli Tu!

I controlli della posizione AdChoices ti consentono di scegliere l'angolo in cui visualizzare l'icona Scegli Tu!.

Imposta GADNativeAdViewAdOptions preferredAdChoicesPosition con un valore GADAdChoicesPosition.

  • Se non è impostata, la posizione dell'icona Scegli Tu! è in alto a destra.

  • Se impostato, AdChoices viene posizionato nella posizione personalizzata come richiesto.

L'esempio seguente mostra come impostare una posizione personalizzata per l'immagine AdChoices.

Swift

let nativeOptions = NativeAdViewAdOptions()
nativeOptions.preferredAdChoicesPosition = .topRightCorner

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopRightCorner;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Visualizzazione personalizzata di Scegli Tu!

La funzionalità di visualizzazione personalizzata Scegli Tu! ti consente di posizionare l'icona Scegli Tu! in una posizione personalizzata. Questi controlli sono diversi da quelli per la posizione di AdChoices, che consentono di specificare solo uno dei quattro angoli.

Imposta la proprietà GADNativeAd.adChoicesView con un GADAdChoicesView prima del rendering e il rendering dei contenuti di Scelte pubblicitarie viene eseguito all'interno di GADAdChoicesView.

L'esempio seguente mostra come impostare una visualizzazione personalizzata di Scelte pubblicitarie. L'icona Scegli Tu! viene visualizzata all'interno di GADAdChoicesView:

Swift

private func createAdChoicesView(nativeAdView: NativeAdView) {
  // Define a custom position for the AdChoices icon.
  let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
  let customAdChoicesView = AdChoicesView(frame: customRect)
  nativeAdView.addSubview(customAdChoicesView)
  nativeAdView.adChoicesView = customAdChoicesView
}
NativeAdOptionsSnippets.swift

Objective-C

- (void)createAdChoicesViewWithNativeAdView:(GADNativeAdView *)nativeAdView {
  // Define a custom position for the AdChoices icon.
  CGRect customRect = CGRectMake(100, 100, 15, 15);
  GADAdChoicesView *customAdChoicesView = [[GADAdChoicesView alloc] initWithFrame:customRect];
  [nativeAdView addSubview:customAdChoicesView];
  nativeAdView.adChoicesView = customAdChoicesView;
}
NativeAdOptionsSnippets.m

Comandi video

Questa sezione descrive in dettaglio come personalizzare l'esperienza di riproduzione per gli annunci video. Hai la possibilità di impostare lo stato di disattivazione audio iniziale e implementare controlli di riproduzione personalizzati.

Avvia comportamento di disattivazione

Il comportamento di avvio con audio disattivato ti consente di disattivare o attivare l'audio iniziale di un video.

Imposta GADVideoOptions startMuted con un valore BOOL.

  • Il comportamento di avvio con audio disattivato è attivo per impostazione predefinita.

  • Se disattivata, l'app richiede che il video inizi con l'audio.

  • Se attivata, l'app richiede che la riproduzione del video inizi con l'audio disattivato.

L'esempio seguente mostra come avviare il video con l'audio riattivato.

Swift

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.startMuted = NO;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Controlli di riproduzione personalizzati

In questo modo, puoi richiedere controlli di input video personalizzati per riprodurre, mettere in pausa o disattivare l'audio del video.

Imposta GADVideoOptions customControlsRequested con un valore BOOL.

  • I controlli di riproduzione personalizzati sono disattivati per impostazione predefinita.

  • Se disattivata, il video mostrerà i controlli di input visualizzati dall'SDK.

Se l'annuncio include contenuti video e i controlli personalizzati sono attivati, devi visualizzare i controlli personalizzati insieme all'annuncio, in quanto l'annuncio non mostra alcun controllo. I controlli possono quindi chiamare i metodi pertinenti sul

GADVideoController.

L'esempio seguente mostra come richiedere un video con controlli di riproduzione personalizzati.

Swift

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.customControlsRequested = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Controllare se i controlli personalizzati sono attivi

Poiché al momento della richiesta non è noto se l'annuncio restituito consentirà controlli video personalizzati, devi verificare se questi sono attivati.

Swift

private func checkCustomControlsEnabled(nativeAd: NativeAd) -> Bool {
  let videoController = nativeAd.mediaContent.videoController
  return videoController.areCustomControlsEnabled
}
NativeAdOptionsSnippets.swift

Objective-C

- (BOOL)checkCustomControlsEnabledWithNativeAd:(GADNativeAd *)nativeAd {
  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  return videoController.customControlsEnabled;
}
NativeAdOptionsSnippets.m

Visualizzare i controlli video personalizzati

Visualizza i controlli video personalizzati utilizzando le seguenti best practice:

  1. Esegui il rendering della visualizzazione dei controlli personalizzati come elemento secondario della visualizzazione dell'annuncio nativo. Questo approccio consente ai calcoli della visibilità di Open Measurement di considerare i controlli personalizzati come un'ostruzione amichevole.
  2. Evita di eseguire il rendering di una sovrapposizione invisibile sull'intera visualizzazione dei contenuti multimediali. Le overlay bloccano i clic sulla visualizzazione dei contenuti multimediali, influendo negativamente sul rendimento degli annunci nativi. Crea invece una piccola overlay abbastanza grande da contenere i controlli.

Gesti di clic personalizzati

I gesti di clic personalizzati sono una funzionalità degli annunci nativi che consente di registrare gli scorrimenti sulle visualizzazioni degli annunci come clic sugli annunci. È progettato per funzionare con le app che utilizzano i gesti di scorrimento per la navigazione dei contenuti. Questa guida mostra come attivare i gesti di clic personalizzati sui tuoi annunci nativi.

Inizializza un'istanza di GADNativeAdCustomClickGestureOptions con la direzione di scorrimento selezionata. Devi anche indicare se vuoi che i tocchi vengano consentiti come clic.

  • I gesti di clic personalizzati sono disattivati per impostazione predefinita.

  • Se disattivata, solo i tocchi verranno conteggiati come clic.

  • Se l'opzione è abilitata, i gesti di scorrimento vengono conteggiati come clic e puoi specificare se i tocchi possono comunque essere conteggiati come clic.

Il seguente esempio mostra come implementare un gesto di scorrimento personalizzato verso destra e preserva il normale comportamento di tocco.

Swift

let swipeGestureOptions = NativeAdCustomClickGestureOptions(
  swipeGestureDirection: .right,
  tapsAllowed: true)

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [swipeGestureOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdCustomClickGestureOptions *swipeGestureOptions =
    [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ swipeGestureOptions ]];
NativeAdOptionsSnippets.m

Ascolta gli eventi di scorrimento

Quando viene registrato un clic con scorrimento, l'SDK Google Mobile Ads richiama il metodo delegato nativeAdDidRecordSwipeGestureClick: su GADNativeAdDelegate , oltre al metodo delegato nativeAdDidRecordClick: esistente.

Swift

// Called when a swipe gesture click is recorded, as configured in
// NativeAdCustomClickGestureOptions.
func nativeAdDidRecordSwipeGestureClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click has occurred.")
}

// Called when a swipe gesture click or a tap click is recorded.
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click or tap click has occurred.")
}
NativeAdOptionsSnippets.swift

Objective-C

// Called when a swipe gesture click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}
NativeAdOptionsSnippets.m

Mediazione

I gesti di clic personalizzati funzionano solo sugli annunci nativi di cui esegue il rendering l'SDK Google Mobile Ads. Le origini annuncio che richiedono SDK di terze parti per il rendering non rispondono all'impostazione delle indicazioni personalizzate per i clic.