Gli annunci nativi dispongono di molte funzionalità avanzate che ti consentono di apportare personalizzazioni aggiuntive e offrire la migliore esperienza pubblicitaria possibile. Questa guida illustra come utilizzare le funzionalità avanzate degli annunci nativi.
Prerequisiti
- Integra il formato di annuncio nativo.
Controlli degli asset
Controlli preferiti per le proporzioni dei contenuti multimediali
I controlli delle proporzioni dei contenuti multimediali consentono di specificare una preferenza per le proporzioni dei le creatività degli annunci.
Imposta GADNativeAdMediaAdLoaderOptions mediaAspectRatio
con un GADMediaAspectRatio
.
Se il criterio non viene configurato, l'annuncio restituito può avere qualsiasi formato multimediale.
Se impostato, puoi migliorare l'esperienza utente specificando il parametro il tipo preferito di proporzioni.
L'esempio seguente indica all'SDK di preferire un'immagine o un video di ritorno con un proporzioni specifiche.
GADNativeAdMediaAdLoaderOptions *nativeOption = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOption.mediaAspectRatio = GADMediaAspectRatioAny;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
Controllo del download delle immagini
Il controllo del download delle immagini ti consente di decidere se l'SDK deve restituire asset immagine o solo URI.
ImpostaGADNativeAdImageAdLoaderOptions disableImageLoading
con un valore BOOL
.
Il controllo del download delle immagini è disattivato per impostazione predefinita.
Se questa opzione è disattivata, l'SDK Google Mobile Ads compila sia l'immagine sia l'URI per te.
Se l'opzione è abilitata, l'SDK compila solo l'URI, consentendoti di scaricare le immagini effettive a tua discrezione.
L'esempio seguente indica all'SDK di restituire solo l'URI.
GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.disableImageLoading = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
Controlli del payload delle immagini
Alcuni annunci presentano una serie di immagini anziché una sola. Utilizza questa funzionalità per indicare se la tua app è pronta a mostrare tutte le immagini o solo una.
ImpostaGADNativeAdImageAdLoaderOptions shouldRequestMultipleImages
con un valore BOOL
.
I controlli del payload delle immagini sono disattivati per impostazione predefinita.
Se questa opzione è 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 che è pronta per mostrare tutte le immagini. per tutti gli asset che ne hanno più di uno.
L'esempio seguente indica all'SDK di restituire più asset immagine.
GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.shouldRequestMultipleImages = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
Posizionamenti Scegli Tu!
Controlli di posizione Scegli Tu!
I controlli di posizione di Scegli Tu! ti consentono di scegliere l'angolo in cui visualizzare Icona Scegli Tu!.
Imposta GADNativeAdViewAdOptions preferredAdChoicesPosition
con un valore GADAdChoicesPosition
.
Se il criterio non viene configurato, la posizione dell'icona Scegli Tu! è impostata in alto a destra.
Se impostato, Scegli Tu! viene posizionato nella posizione personalizzata come richiesto.
L'esempio seguente mostra come impostare una posizione dell'immagine AdChoices personalizzata.
GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
Visualizzazione personalizzata di Scegli Tu!
La funzionalità di visualizzazione personalizzata di Scegli Tu! ti consente di posizionare l'icona Scegli Tu! in una posizione personalizzata. È diverso dai controlli della posizione di AdChoices, che consentono di specificare solo uno dei quattro angoli.
Imposta la proprietà GADNativeAd.adChoicesView
con un GADAdChoicesView
prima del rendering e i contenuti di AdChoices verranno visualizzati all'interno di GADAdChoicesView
.
L'esempio seguente mostra come impostare una visualizzazione Scegli Tu! personalizzata. L'icona Scegli Tu! verrà visualizzata all'interno del GADAdChoicesView
.
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {
...
GADAdChoicesView *customAdChoicesView =
[[GADAdChoicesView alloc] initWithFrame: CGRectMake(..., ..., ..., ...)];
[nativeAdView addSubview:customAdChoicesView];
nativeAdView.adChoicesView = customAdChoicesView;
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd;
}
Swift
func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
refreshAdButton.isEnabled = true
...
// Define a custom position for the AdChoices icon.
let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
let customAdChoicesView = GADAdChoicesView(frame: customRect)
nativeAdView.addSubview(customAdChoicesView)
nativeAdView.adChoicesView = customAdChoicesView
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd;
}
Comandi video
Avvia comportamento di disattivazione dell'audio
Il comportamento di inizio con l'audio disattivato ti consente di disattivare o attivare l'audio iniziale di un video.
ImpostaGADVideoOptions startMuted
con un valore BOOL
.
Il comportamento di avvio senza audio è attivo per impostazione predefinita.
Se l'opzione è disattivata, l'app richiede che il video inizi con audio.
Quando questa opzione è attiva, la tua app richiede che il video inizi con l'audio disattivato.
Il seguente esempio mostra come avviare il video con l'audio riattivato.
GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.startMuted = NO;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
Controlli di riproduzione personalizzati
Ciò ti consente di richiedere controlli di input video personalizzati per riprodurre, mettere in pausa o disattivare l'audio video.
ImpostaGADVideoOptions customControlsRequested
con un valore BOOL
.
Il controllo di riproduzione personalizzato è disattivato per impostazione predefinita.
Se questa opzione è disattivata, il video mostrerà i controlli di input visualizzati con l'SDK.
- Una volta attivata, puoi utilizzare
GADVideoController play
,GADVideoController pause
eGADVideoController setMute
per controllare l'annuncio video.
- Se l'annuncio include contenuti video e i controlli personalizzati sono attivati, devi mostrare i controlli personalizzati insieme all'annuncio, in quanto l'annuncio stesso non mostrerà alcun controllo. I controlli possono quindi chiamare i metodi pertinenti su
GADVideoController
.
L'esempio seguente mostra come richiedere un video con controlli di riproduzione personalizzati.
GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.customControlsRequested = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
Verificare se i controlli personalizzati sono attivi
Poiché al momento della richiesta non è noto se l'annuncio restituito consentirà i controlli video personalizzati, devi verificare se sono attivati.
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader
didReceiveNativeAd:(GADNativeAd*)nativeAd {
GADVideoController *videoController = nativeAd.mediaContent.videoController;
BOOL canShowCustomControls = videoController.customControlsEnabled;
}
Swift
func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
let videoController = nativeAd.mediaContent.videoController
let canShowCustomControls = videoController?.customControlsEnabled() == true
}
Visualizzazione di controlli video personalizzati
Per visualizzare i controlli video personalizzati, segui le best practice riportate di seguito:
- Esegui il rendering della visualizzazione dei controlli personalizzati come elemento secondario della visualizzazione dell'annuncio nativo. Questo approccio garantisce che i calcoli aperti per la misurazione e la visibilità considerino i controlli personalizzati come un semplice ostacolo.
- Evita di eseguire il rendering di un overlay invisibile sull'intera visualizzazione dei contenuti multimediali. Gli overlay bloccano i clic nella visualizzazione dei contenuti multimediali, con un impatto negativo sul rendimento degli annunci nativi. Crea invece un overlay piccolo, abbastanza grande da contenere i controlli.
Gesti di clic personalizzati
I gesti di clic personalizzati sono una funzionalità degli annunci nativi che consente di scorrere le visualizzazioni di annuncio per registrate come clic sugli annunci. È progettata per funzionare con le app che utilizzano lo scorrimento gesti per la navigazione dei contenuti. Questa guida spiega come attivare i clic personalizzati gesti per gli annunci nativi.
Inizializzare una GADNativeAdCustomClickGestureOptions
con la direzione di scorrimento selezionata. Devi anche indicare se vuoi che i tocchi siano consentiti come clic.
I gesti di clic personalizzati sono disattivati per impostazione predefinita.
Quando l'opzione è disattivata, solo i tocchi vengono conteggiati come clic.
Quando l'opzione è attiva, i gesti di scorrimento vengono conteggiati come clic e puoi specificare se i tocchi possono essere comunque conteggiati come clic.
L'esempio seguente mostra come implementare un gesto di scorrimento personalizzato verso destra e mantenere il normale comportamento del tocco.
GADNativeAdCustomClickGestureOptions *swipeGestureOptions = [[GADNativeAdCustomClickGestureOptions alloc]
initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
tapsAllowed:YES];
// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
self.adLoader = [[GADAdLoader alloc]
initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ swipeGestureOptions ]];
Ascolta gli eventi relativi ai gesti di scorrimento
Quando viene registrato un clic tramite gesto di scorrimento, l'SDK Google Mobile Ads richiama il metodo
nativeAdDidRecordSwipeGestureClick:
delegato su GADNativeAdDelegate
, oltre all'attuale nativeAdDidRecordClick:
Delegation.
#pragma mark - GADNativeAdDelegate implementation
// Called when a swipe gesture click is recorded.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
NSLog(@"A swipe gesture click has occurred.");
}
// Called when a swipe gesture click or a tap click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
NSLog(@"A swipe gesture click or tap click has occurred.");
}
Mediazione
I gesti di clic personalizzati funzionano solo sugli annunci nativi visualizzati dall'SDK Google Mobile Ads. Le origini annuncio che richiedono SDK di terze parti per il rendering non rispondono all'impostazione delle indicazioni sui clic personalizzate.