Opzioni degli annunci nativi

L'ultimo parametro incluso nella creazione di GADAdLoader è un array opzionale di oggetti. Questa sezione descrive queste opzioni.

Veloce

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Obiettivo-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions contiene proprietà relative alle immagini negli annunci nativi. Le app possono controllare il modo in cui un GADAdLoader gestisce le risorse immagine creando un oggetto GADNativeAdImageAdLoaderOptions , impostandone le proprietà ( disableImageLoading , preferredImageOrientation e shouldRequestMultipleImages ) e passandolo durante l'inizializzazione.

GADNativeAdImageAdLoaderOptions ha le seguenti proprietà:

disableImageLoading
Gli asset immagine per gli annunci nativi vengono restituiti tramite istanze di GADNativeAdImage , che contiene le proprietà image e imageURL . Se disableImageLoading è impostato su false , che è l'impostazione predefinita ( NO in Objective-C), l'SDK recupererà automaticamente le risorse dell'immagine e popolerà sia l' image che le proprietà imageURL per te. Se è impostato su true (o YES in Objective-C), l'SDK popolerà solo imageURL , consentendoti di scaricare le immagini effettive a tua discrezione. Utilizzare la mainImage mainImage di GADMediaContent per impostare l'immagine per la visualizzazione multimediale durante il download manuale delle immagini.
preferredImageOrientation

Alcune creatività hanno più immagini disponibili per adattarsi a diversi orientamenti del dispositivo. Le app possono richiedere immagini per un orientamento particolare impostando questa proprietà su una delle costanti di orientamento:

  • GADNativeAdImageAdLoaderOptionsOrientationAny
  • GADNativeAdImageAdLoaderOptionsOrientationLandscape
  • GADNativeAdImageAdLoaderOptionsOrientationPortrait

    Se usi preferredImageOrientation per specificare una preferenza per l'orientamento dell'immagine orizzontale o verticale, l'SDK inserirà le immagini corrispondenti a tale orientamento prima negli array di risorse immagine e dopo di esse collocherà le immagini non corrispondenti. Poiché alcuni annunci avranno un solo orientamento disponibile, i publisher dovrebbero assicurarsi che le loro app siano in grado di gestire sia le immagini orizzontali che quelle verticali.

    Se questo metodo non viene chiamato, verrà utilizzato il valore predefinito di GADNativeAdImageAdLoaderOptionsOrientationAny .

shouldRequestMultipleImages

Alcuni asset di immagini conterranno una serie di immagini anziché solo una. Impostando questo valore su true, la tua app indica che è pronta per visualizzare tutte le immagini per tutte le risorse che ne hanno più di una. Impostandolo su false (impostazione predefinita), l'app indica all'SDK di fornire solo la prima immagine per tutte le risorse che contengono una serie.

Se nessun oggetto GADAdLoaderOptions viene passato durante l'inizializzazione di un GADAdLoader , verrà utilizzato il valore predefinito per ciascuna opzione.

GADNativeAdViewAdOptions

Gli oggetti GADNativeAdViewAdOptions vengono utilizzati per indicare le preferenze su come le visualizzazioni degli annunci nativi devono rappresentare gli annunci. Hanno un'unica proprietà: preferredAdChoicesPosition , che puoi utilizzare per specificare la posizione in cui deve essere posizionata l'icona AdChoices. L'icona può apparire in qualsiasi angolo dell'annuncio e per impostazione predefinita GADAdChoicesPositionTopRightCorner . I possibili valori per questa proprietà sono:

  • GADAdChoicesPositionTopRightCorner
  • GADAdChoicesPositionTopLeftCorner
  • GADAdChoicesPositionBottomRightCorner
  • GADAdChoicesPositionBottomLeftCorner

Ecco un esempio che mostra come posizionare l'icona AdChoices nell'angolo in alto a sinistra di un annuncio:

Veloce

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Obiettivo-C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

Opzioni GADVideo

Gli oggetti GADVideoOptions vengono utilizzati per indicare come devono essere visualizzate le risorse video native. Offrono un'unica proprietà: startMuted .

Questo valore booleano indica se le risorse video devono iniziare la riproduzione in uno stato disattivato. Il valore predefinito è true .

GADMultipleAdsAdLoaderOptions

Gli oggetti GADMultipleAdsAdLoaderOptions consentono ai publisher di indicare a un caricatore di annunci di caricare più annunci in un'unica richiesta. Gli annunci caricati in questo modo sono garantiti per essere unici. GADMultipleAdsAdLoaderOptions ha una singola proprietà, numberOfAds , che rappresenta il numero di annunci che il caricatore di annunci deve tentare di restituire per la richiesta. Per impostazione predefinita, questo valore è uno ed è limitato a un massimo di cinque (anche se un'app richiede più annunci, ne verranno restituiti al massimo cinque). Il numero effettivo di annunci restituiti non è garantito, ma sarà compreso tra zero e numberOfAds .

GADNativeAdMediaAdLoaderOptions

Per utilizzare questa funzione, includi la classe GADNativeAdMediaAdLoaderOptions nell'array di opzioni annuncio nativo nell'inizializzazione di GADAdLoader .

Gli oggetti GADNativeAdMediaAdLoaderOptions consentono di selezionare le preferenze per le proporzioni dei media. L'opzione viene applicata sia all'immagine che al video. Questa classe ha una proprietà: mediaAspectRatio , che puoi usare per specificare le proporzioni multimediali supportate. I possibili valori per questa proprietà sono:

Obiettivo-C Veloce
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

Se si mediaAspectRatio su una di queste opzioni, verranno restituiti solo gli annunci con contenuti multimediali con le proporzioni specificate. Se questa proprietà non è impostata in modo esplicito, il valore sarà predefinito su GADMediaAspectRatioUnknown e non verranno applicate restrizioni sulle proporzioni.