Classe GANSearchAdController

Riferimento alla classe GANSearchAdController

Panoramica

Recupera gli annunci della rete di ricerca e li rende disponibili per il client dell'SDK.

Eredita NSObject.

Riepilogo del metodo di istanza

(instancetype) - NS_UNAVAILABLE
 
(instancetype) - initWithPublisherID:styleID:options:delegate:
 Inizializza il controller degli annunci. Altro...
 
(void) - loadAds:
 Recupera, in modo asincrono, la prima pagina di annunci per il adRequest specificato e le pagine successive, se necessario. Altro...
 
(void) - loadMoreAds
 Recupera in modo asincrono la pagina successiva di annunci per la richiesta precedente specificata dall'ultima chiamata a loadAds:. Altro...
 
(NSInteger) - adCount
 Restituisce il numero totale di annunci caricati dalla chiamata più recente a loadAds:. Altro...
 
(GANAdView *) - adView
 Crea un adView vuoto. Altro...
 
(void) - populateAdView:identifier:
 Completa un adView con l'annuncio specificato dall'identificatore. Altro...
 
(void) - populateAdView:identifier:completionHandler:
 Compila un adView con l'annuncio specificato dall'identificatore e chiama il gestore di completamento quando l'annuncio è pronto per essere visualizzato. Altro...
 

Riepilogo proprietà

NSString * publisherID
 L'ID publisher utilizzato per le richieste di annunci. Altro...
 
NSString * styleID
 L'ID impostazioni utilizzato per le richieste di annunci. Altro...
 
GANSearchAdControllerOptionsoptions
 Le opzioni utilizzate per tutte le richieste di annunci. Altro...
 
GANExperimentVariantStatus experimentVariantStatus
 Se lo stile pubblicato più di recente è una variante dell'esperimento, un controllo dell'esperimento o non è stato selezionato per un esperimento. Altro...
 

Dettaglio metodo

- (instancetype) initWithPublisherID: (NSString *)  publisherID
styleID: (NSString *)  styleID
options: (nullable GANSearchAdControllerOptions *)  options
delegate: (nullable id< GANSearchAdControllerDelegate >)  delegate 

Inizializza il controller degli annunci.

Parameters
publisherIDThe publisher id, e.g. "ms-app-pub-9616389000213823".
styleIDThe settings id for the template that will be used to render native ads.
optionsGANSearchAdControllerOptions, such as adTest, and adSafe, etc.
delegateGANSearchAdControllerDelegate for receiving notifications when ads are loaded and other events.
- (void) loadAds: (GANSearchAdRequest *)  adRequest

Recupera, in modo asincrono, la prima pagina di annunci per il adRequest specificato e le pagine successive, se necessario.

Questo metodo deve essere chiamato una sola volta per richiesta. Quando vengono caricati nuovi annunci (o non vengono caricati), GANSearchAdControllerDelegate viene chiamato nel thread principale.

Parameters
adRequestThe GANSearchAdRequest query.
- (void) loadMoreAds

Recupera in modo asincrono la pagina successiva di annunci per la richiesta precedente specificata dall'ultima chiamata a loadAds:.

Se loadAds: non è stato chiamato, verrà restituito un errore tramite GANSearchAdControllerDelegate. Se è presente una pagina intera di annunci che non sono stati mostrati, il delegato restituirà un errore.

- (NSInteger) adCount

Restituisce il numero totale di annunci caricati dalla chiamata più recente a loadAds:.

- (GANAdView *) adView

Crea un adView vuoto.

- (void) populateAdView: (GANAdView *)  view
identifier: (NSString *)  adIdentifier 

Completa un adView con l'annuncio specificato dall'identificatore.

  • Se adIdentifier è un nuovo identificatore, la visualizzazione mostrerà il successivo annuncio disponibile.
  • Se adIdentifier è già stato utilizzato, la visualizzazione mostrerà lo stesso annuncio mostrato la prima volta che questo metodo è stato chiamato con adIdentifier.
    Parameters
    viewThe GANAdView to populate.
    adIdentifierAn ad identifier used to identify this ad. This can be any NSString. Each unique string will be assigned to the next available ad until ads are exhausted.
- (void) populateAdView: (GANAdView *)  view
identifier: (NSString *)  adIdentifier
completionHandler: (GANAdViewPopulatedCompletionHandler)  completionHandler 

Compila un adView con l'annuncio specificato dall'identificatore e chiama il gestore di completamento quando l'annuncio è pronto per essere visualizzato.

  • Se adIdentifier è un nuovo identificatore, la visualizzazione mostrerà il successivo annuncio disponibile.
  • Se adIdentifier è già stato utilizzato, la visualizzazione mostrerà lo stesso annuncio mostrato la prima volta che questo metodo è stato chiamato con adIdentifier.
    Parameters
    viewThe GANAdView to populate.
    adIdentifierAn ad identifier used to identify this ad. This can be any NSString. Each unique string will be assigned to the next available ad until ads are exhausted.
    completionHandlerThe completion handler to be called when the ad view is ready to be displayed. Ad specific data will provided such as the height of the ad view.

Dettagli della proprietà

- (NSString*) publisherID
readnonatomiccopy

L'ID publisher utilizzato per le richieste di annunci.

- (NSString*) styleID
readnonatomiccopy

L'ID impostazioni utilizzato per le richieste di annunci.

- (GANSearchAdControllerOptions*) options
readnonatomicstrong

Le opzioni utilizzate per tutte le richieste di annunci.

- (GANExperimentVariantStatus) experimentVariantStatus
readnonatomicassign

Se lo stile pubblicato più di recente è una variante dell'esperimento, un controllo dell'esperimento o non è stato selezionato per un esperimento.