Opzioni per gli annunci nativi

Gli annunci nativi offrono molte funzioni avanzate che consentono di aggiungere personalizzazioni e offrire la migliore esperienza pubblicitaria possibile. Questa guida mostra come usare 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.

Importante: l'utilizzo di questa API non garantisce che tutte le creatività degli annunci soddisfino la preferenza specificata.

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 gli asset immagine o solo gli URI vengono restituiti dall'SDK.

Imposta GADNativeAdImageAdLoaderOptions 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 payload immagine

Alcuni annunci presentano una serie di immagini anziché una sola. Usa questa funzione per indicare se l'app è pronta per visualizzare tutte le immagini o solo una.

Imposta GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages con un valore BOOL.

• I controlli del payload per le immagini sono disattivati per impostazione predefinita.

• Se disattivata, l'app indica all'SDK di fornire solo la prima immagine di tutti 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 GADAdChoicesPosition valore.

• 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 la posizione di un'immagine Scegli Tu! 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 Scegli Tu!

Avviso: l'accesso a questa funzionalità è limitato. Per richiedere l'accesso, contatta il tuo account manager.

La visualizzazione personalizzata di Scegli Tu! ti consente di posizionare l'icona Scegli Tu! in una una località personalizzata. Questo è diverso dai controlli di posizione Scegli Tu!, che permette di specificare uno dei quattro angoli.

Imposta la GADNativeAd.adChoicesView proprietà con GADAdChoicesView prima del rendering e i contenuti Scegli Tu! verranno visualizzati all'interno GADAdChoicesView.

L'esempio seguente mostra come impostare una visualizzazione Scegli Tu! personalizzata. La L'icona Scegli Tu! verrà visualizzata all'interno di 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

Questo comportamento consente di disattivare o attivare l'audio di avvio di un video.

Imposta GADVideoOptions 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 impostazione è 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

Avviso: l'accesso a questa funzionalità è limitato. Per richiedere l'accesso, contatta il tuo account manager.

Ciò ti consente di richiedere controlli di input video personalizzati per riprodurre, mettere in pausa o disattivare l'audio video.

Imposta GADVideoOptions 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.

• Quando l'opzione è attiva, puoi usare GADVideoController play , GADVideoController pause e GADVideoController setMute per controllare l'annuncio video.

• Se l'annuncio dispone di contenuti video e i controlli personalizzati sono attivi, quindi mostra i controlli personalizzati insieme all'annuncio, in quanto quest'ultimo non mostrerà automaticamente. I controlli possono quindi chiamare i metodi pertinenti sulla 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é non è noto al momento della richiesta se l'annuncio restituito consentirà controlli video personalizzati, devi verificare se sono attivati dei controlli personalizzati.

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
}

Gesti di clic personalizzati

Avviso: l'accesso a questa funzionalità è limitato. Per richiedere l'accesso, contatta il tuo account manager.

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 per a destra e conserva 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 ]];

Avviso: se il tuo account non è abilitato per i gesti di clic personalizzati, le richieste di annunci restituirà un "no-fill".

Ascolta gli eventi dei 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 per gli annunci nativi che Google Mobile Viene eseguito il rendering dell'SDK per gli annunci. Origini annuncio che sono necessari SDK di terze parti per rendering, non rispondere all'impostazione personalizzata delle indicazioni stradali per i clic.