Klasa GANSearchAdController

Odniesienie do klasy GANSearchAdController

Opis

Pobiera reklamy w wyszukiwarce i udostępnia je klientowi pakietu SDK.

Dziedziczy NSObject.

Podsumowanie metody instancji

(instancetype) - NS_UNAVAILABLE
 
(instancetype) - initWithPublisherID:styleID:options:delegate:
 Inicjuje kontroler reklam. Więcej...
 
(void) - loadAds:
 Asynchronicznie pobiera pierwszą stronę reklam z elementu adRequest i w razie potrzeby kolejne strony. Więcej...
 
(void) - loadMoreAds
 Asynchronicznie pobiera następną stronę reklam z poprzedniego żądania określonego w ostatnim wywołaniu funkcji loadAds:. Więcej...
 
(NSInteger) - adCount
 Zwraca łączną liczbę reklam wczytanych od ostatniego wywołania funkcji loadAds:. Więcej...
 
(GANAdView *) - adView
 Utwórz pusty obiekt adView. Więcej...
 
(void) - populateAdView:identifier:
 Wypełnij parametr adView reklamą określoną przez identyfikator. Więcej...
 
(void) - populateAdView:identifier:completionHandler:
 Wypełnij obiekt adView reklamą określoną przez identyfikator i wywołaj moduł obsługi ukończenia, gdy reklama będzie gotowa do wyświetlenia. Więcej...
 

Podsumowanie usługi

NSString * publisherID
 Identyfikator wydawcy używany na potrzeby żądań reklamy. Więcej...
 
NSString * styleID
 Identyfikator ustawień używany na potrzeby żądań reklamy. Więcej...
 
GANSearchAdControllerOptionsoptions
 Opcje używane w przypadku wszystkich żądań reklamy. Więcej...
 
GANExperimentVariantStatus experimentVariantStatus
 Określa, czy ostatnio wyświetlany styl jest wariantem eksperymentu, grupą kontrolną eksperymentu czy nie został wybrany do eksperymentu. Więcej...
 

Szczegóły metody

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

Inicjuje kontroler reklam.

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

Asynchronicznie pobiera pierwszą stronę reklam z elementu adRequest i w razie potrzeby kolejne strony.

Metodę tę należy wywoływać tylko raz na żądanie. Gdy nowe reklamy zostaną wczytane (lub nie uda się ich wczytać), nastąpi wywołanie GANSearchAdControllerDelegate w wątku głównym.

Parameters
adRequestThe GANSearchAdRequest query.
- (void) loadMoreAds

Asynchronicznie pobiera następną stronę reklam z poprzedniego żądania określonego w ostatnim wywołaniu funkcji loadAds:.

Jeśli wywołanie loadAds: nie zostało odebrane, spowoduje zwrócenie błędu przez interfejs GANSearchAdControllerDelegate. Jeśli istnieje pełna strona reklam, które nie zostały wyświetlone, przedstawiciel również zwróci komunikat o błędzie.

- (NSInteger) adCount

Zwraca łączną liczbę reklam wczytanych od ostatniego wywołania funkcji loadAds:.

- (GANAdView *) adView

Utwórz pusty obiekt adView.

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

Wypełnij parametr adView reklamą określoną przez identyfikator.

  • Jeśli adIdentifier jest nowym identyfikatorem, w widoku pojawi się następna dostępna reklama.
  • Jeśli metoda adIdentifier została już użyta, w widoku wyświetli się ta sama reklama, która została wyświetlona przy pierwszym wywołaniu tej metody z metodą 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 

Wypełnij obiekt adView reklamą określoną przez identyfikator i wywołaj moduł obsługi ukończenia, gdy reklama będzie gotowa do wyświetlenia.

  • Jeśli adIdentifier jest nowym identyfikatorem, w widoku pojawi się następna dostępna reklama.
  • Jeśli metoda adIdentifier została już użyta, w widoku wyświetli się ta sama reklama, która została wyświetlona przy pierwszym wywołaniu tej metody z metodą 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.

Szczegóły nieruchomości

- (NSString*) publisherID
readnonatomiccopy

Identyfikator wydawcy używany na potrzeby żądań reklamy.

- (NSString*) styleID
readnonatomiccopy

Identyfikator ustawień używany na potrzeby żądań reklamy.

- (GANSearchAdControllerOptions*) options
readnonatomicstrong

Opcje używane w przypadku wszystkich żądań reklamy.

- (GANExperimentVariantStatus) experimentVariantStatus
readnonatomicassign

Określa, czy ostatnio wyświetlany styl jest wariantem eksperymentu, grupą kontrolną eksperymentu czy nie został wybrany do eksperymentu.