Classe GANSearchAdController

Referência de classe GANSearchAdController

Informações gerais

Recupera os anúncios da rede de pesquisa e os disponibiliza para o cliente do SDK.

Herda o NSObject.

Resumo do método de instância

(instancetype) - NS_UNAVAILABLE
 
(instancetype) - initWithPublisherID:styleID:options:delegate:
 Inicializa o controlador de anúncios. Mais...
 
(void) - loadAds:
 Recupera, de maneira assíncrona, a primeira página de anúncios para o adRequest especificado e as páginas subsequentes, conforme necessário. Mais...
 
(void) - loadMoreAds
 Recupera de maneira assíncrona a próxima página de anúncios da solicitação anterior especificada pela última chamada para loadAds:. Mais...
 
(NSInteger) - adCount
 Retorna o número total de anúncios carregados da chamada mais recente para loadAds:. Mais...
 
(GANAdView *) - adView
 Crie um adView vazio. Mais...
 
(void) - populateAdView:identifier:
 Preencha uma adView com o anúncio especificado pelo identificador. Mais...
 
(void) - populateAdView:identifier:completionHandler:
 Preencha um adView com o anúncio especificado pelo identificador e chame o gerenciador de conclusão quando o anúncio estiver pronto para ser exibido. Mais...
 

Resumo da propriedade

NSString * publisherID
 O ID do editor usado para solicitações de anúncios. Mais...
 
NSString * styleID
 O ID das configurações usado para solicitações de anúncios. Mais...
 
GANSearchAdControllerOptionsoptions
 As opções usadas para todas as solicitações de anúncios. Mais...
 
GANExperimentVariantStatus experimentVariantStatus
 Indica se o estilo veiculado mais recentemente é uma variante do experimento, um controle de experimento ou não foi selecionado para um experimento. Mais...
 

Detalhes dos métodos

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

Inicializa o controlador de anúncios.

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 maneira assíncrona, a primeira página de anúncios para o adRequest especificado e as páginas subsequentes, conforme necessário.

Esse método deve ser chamado apenas uma vez por solicitação. Quando novos anúncios forem carregados (ou falharem), o GANSearchAdControllerDelegate será chamado na linha de execução principal.

Parameters
adRequestThe GANSearchAdRequest query.
- (void) loadMoreAds

Recupera de maneira assíncrona a próxima página de anúncios da solicitação anterior especificada pela última chamada para loadAds:.

Se loadAds: não tiver sido chamado, um erro será retornado pelo GANSearchAdControllerDelegate. Se houver uma página inteira de anúncios que não foram exibidos, isso também retornará um erro para o delegado.

- (NSInteger) adCount

Retorna o número total de anúncios carregados da chamada mais recente para loadAds:.

- (GANAdView *) adView

Crie um adView vazio.

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

Preencha uma adView com o anúncio especificado pelo identificador.

  • Se adIdentifier for um novo identificador, a visualização vai mostrar o próximo anúncio disponível.
  • Se adIdentifier já tiver sido usado, a visualização vai mostrar o mesmo anúncio exibido na primeira vez que esse método foi chamado com 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 

Preencha um adView com o anúncio especificado pelo identificador e chame o gerenciador de conclusão quando o anúncio estiver pronto para ser exibido.

  • Se adIdentifier for um novo identificador, a visualização vai mostrar o próximo anúncio disponível.
  • Se adIdentifier já tiver sido usado, a visualização vai mostrar o mesmo anúncio exibido na primeira vez que esse método foi chamado com 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.

Detalhe da propriedade

- (NSString*) publisherID
readnonatomiccopy

O ID do editor usado para solicitações de anúncios.

- (NSString*) styleID
readnonatomiccopy

O ID das configurações usado para solicitações de anúncios.

- (GANSearchAdControllerOptions*) options
readnonatomicstrong

As opções usadas para todas as solicitações de anúncios.

- (GANExperimentVariantStatus) experimentVariantStatus
readnonatomicassign

Indica se o estilo veiculado mais recentemente é uma variante do experimento, um controle de experimento ou não foi selecionado para um experimento.