Classe GANSearchAdController

Référence de la classe GANSearchAdController

Présentation

Récupère les annonces sur le Réseau de Recherche et les met à la disposition du client du SDK.

Hérite du NSObject.

Résumé des méthodes d'instance

(instancetype) - NS_UNAVAILABLE
 
(instancetype) - initWithPublisherID:styleID:options:delegate:
 Initialise le contrôleur d'annonces. Plus...
 
(void) - loadAds:
 Récupère, de manière asynchrone, la première page d'annonces pour le adRequest donné et les pages suivantes selon les besoins. Plus...
 
(void) - loadMoreAds
 Récupère, de manière asynchrone, la page d'annonces suivante pour la requête précédente spécifiée par le dernier appel à loadAds:. Plus...
 
(NSInteger) - adCount
 Renvoie le nombre total d'annonces chargées depuis l'appel le plus récent à loadAds:. Plus...
 
(GANAdView *) - adView
 Créez un adView vide. Plus...
 
(void) - populateAdView:identifier:
 Renseignez un élément adView avec l'annonce spécifiée par l'identifiant. Plus...
 
(void) - populateAdView:identifier:completionHandler:
 Renseignez une adView avec l'annonce spécifiée par l'identifiant et appelez le gestionnaire d'achèvement lorsque l'annonce est prête à être affichée. Plus...
 

Résumé de la propriété

NSString * publisherID
 Référence éditeur utilisée pour les demandes d'annonces. Plus...
 
NSString * styleID
 Identifiant des paramètres utilisé pour les demandes d'annonces. Plus...
 
GANSearchAdControllerOptionsoptions
 Options utilisées pour toutes les demandes d'annonces. Plus...
 
GANExperimentVariantStatus experimentVariantStatus
 Indique si le dernier style diffusé est une variante de test, un groupe de contrôle ou n'a pas été sélectionné pour un test. Plus...
 

Détails sur la méthode

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

Initialise le contrôleur d'annonces.

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

Récupère, de manière asynchrone, la première page d'annonces pour le adRequest donné et les pages suivantes selon les besoins.

Cette méthode ne doit être appelée qu'une seule fois par requête. Lorsque de nouvelles annonces sont chargées (ou ne se chargent pas), GANSearchAdControllerDelegate est appelé dans le thread principal.

Parameters
adRequestThe GANSearchAdRequest query.
- (void) loadMoreAds

Récupère, de manière asynchrone, la page d'annonces suivante pour la requête précédente spécifiée par le dernier appel à loadAds:.

Si loadAds: n'a pas été appelé, une erreur est renvoyée via GANSearchAdControllerDelegate. Si une page entière d'annonces n'a pas été affichée, le délégué renverra également une erreur.

- (NSInteger) adCount

Renvoie le nombre total d'annonces chargées depuis l'appel le plus récent à loadAds:.

- (GANAdView *) adView

Créez un adView vide.

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

Renseignez un élément adView avec l'annonce spécifiée par l'identifiant.

  • Si adIdentifier est un nouvel identifiant, la vue affiche la prochaine annonce disponible.
  • si adIdentifier a déjà été utilisé, la vue affichera l'annonce qui a été diffusée la première fois que cette méthode a été appelée avec 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 

Renseignez une adView avec l'annonce spécifiée par l'identifiant et appelez le gestionnaire d'achèvement lorsque l'annonce est prête à être affichée.

  • Si adIdentifier est un nouvel identifiant, la vue affiche la prochaine annonce disponible.
  • si adIdentifier a déjà été utilisé, la vue affichera l'annonce qui a été diffusée la première fois que cette méthode a été appelée avec 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.

Détails de la propriété

- (NSString*) publisherID
readnonatomiccopy

Référence éditeur utilisée pour les demandes d'annonces.

- (NSString*) styleID
readnonatomiccopy

Identifiant des paramètres utilisé pour les demandes d'annonces.

- (GANSearchAdControllerOptions*) options
readnonatomicstrong

Options utilisées pour toutes les demandes d'annonces.

- (GANExperimentVariantStatus) experimentVariantStatus
readnonatomicassign

Indique si le dernier style diffusé est une variante de test, un groupe de contrôle ou n'a pas été sélectionné pour un test.