Clase GANSearchAdController

Referencia de la clase GANSearchAdController

Descripción general

Recupera anuncios de búsqueda y los pone a disposición del cliente del SDK.

Hereda NSObject.

Resumen del método de instancia

(instancetype) - NS_UNAVAILABLE
 
(instancetype) - initWithPublisherID:styleID:options:delegate:
 Inicializa el controlador de anuncios. Más...
 
(void) - loadAds:
 Recupera, de forma asíncrona, la primera página de anuncios para la adRequest determinada y las páginas posteriores, según sea necesario. Más...
 
(void) - loadMoreAds
 Recupera de forma asíncrona la siguiente página de anuncios para la solicitud anterior especificada por la última llamada a loadAds:. Más...
 
(NSInteger) - adCount
 Muestra la cantidad total de anuncios cargados desde la llamada más reciente a loadAds:. Más...
 
(GANAdView *) - adView
 Crea un objeto adView vacío. Más...
 
(void) - populateAdView:identifier:
 Propaga una adView con el anuncio especificado por el identificador. Más...
 
(void) - populateAdView:identifier:completionHandler:
 Propaga una adView con el anuncio especificado por el identificador y llama al controlador de finalización cuando el anuncio esté listo para mostrarse. Más...
 

Resumen de la propiedad

NSString * publisherID
 Es el ID de publicador que se usa para las solicitudes de anuncios. Más...
 
NSString * styleID
 Es el ID de configuración que se usa para las solicitudes de anuncios. Más...
 
GANSearchAdControllerOptionsoptions
 Son las opciones que se usan para todas las solicitudes de anuncios. Más...
 
GANExperimentVariantStatus experimentVariantStatus
 Indica si el estilo publicado más recientemente es una variante de experimento o un control de experimento, o bien si no se seleccionó para un experimento. Más...
 

Detalle del método

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

Inicializa el controlador de anuncios.

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, de forma asíncrona, la primera página de anuncios para la adRequest determinada y las páginas posteriores, según sea necesario.

Se debe llamar a este método solo una vez por solicitud. Cuando se carguen nuevos anuncios (o no se carguen), se llamará a GANSearchAdControllerDelegate en el subproceso principal.

Parameters
adRequestThe GANSearchAdRequest query.
- (void) loadMoreAds

Recupera de forma asíncrona la siguiente página de anuncios para la solicitud anterior especificada por la última llamada a loadAds:.

Si no se llamó a loadAds:, se mostrará un error a través de GANSearchAdControllerDelegate. Si hay una página completa de anuncios que no se mostraron, también se le mostrará un error al delegado.

- (NSInteger) adCount

Muestra la cantidad total de anuncios cargados desde la llamada más reciente a loadAds:.

- (GANAdView *) adView

Crea un objeto adView vacío.

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

Propaga una adView con el anuncio especificado por el identificador.

  • Si adIdentifier es un identificador nuevo, la vista mostrará el siguiente anuncio disponible.
  • Si ya se usó adIdentifier, la vista mostrará el mismo anuncio que mostró la primera vez que se llamó a este método 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 

Propaga una adView con el anuncio especificado por el identificador y llama al controlador de finalización cuando el anuncio esté listo para mostrarse.

  • Si adIdentifier es un identificador nuevo, la vista mostrará el siguiente anuncio disponible.
  • Si ya se usó adIdentifier, la vista mostrará el mismo anuncio que mostró la primera vez que se llamó a este método 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.

Detalles de la propiedad

- (NSString*) publisherID
readnonatomiccopy

Es el ID de publicador que se usa para las solicitudes de anuncios.

- (NSString*) styleID
readnonatomiccopy

Es el ID de configuración que se usa para las solicitudes de anuncios.

- (GANSearchAdControllerOptions*) options
readnonatomicstrong

Son las opciones que se usan para todas las solicitudes de anuncios.

- (GANExperimentVariantStatus) experimentVariantStatus
readnonatomicassign

Indica si el estilo publicado más recientemente es una variante de experimento o un control de experimento, o bien si no se seleccionó para un experimento.