רמת GANSearchAdController

חומר עזר לסיווג GANSearchAdController

סקירה כללית

אחזור של מודעות לרשת החיפוש והפיכתן לזמינות ללקוח ה-SDK.

יורש את NSObject.

סיכום שיטות של מכונה

(instancetype) - NS_UNAVAILABLE
 
(instancetype) - initWithPublisherID:styleID:options:delegate:
 הפעלה של בקר המודעות. עוד...
 
(void) - loadAds:
 אחזור באופן אסינכרוני של הדף הראשון של המודעות עבור adRequest וכן הדפים הבאים, לפי הצורך. עוד...
 
(void) - loadMoreAds
 מאחזרת באופן אסינכרוני את הדף הבא של מודעות עבור הבקשה הקודמת שצוינה בקריאה האחרונה אל loadAds:. עוד...
 
(NSInteger) - adCount
 הפונקציה מחזירה את המספר הכולל של מודעות שנטענו מהשיחה האחרונה ל-loadAds:. עוד...
 
(GANAdView *) - adView
 יוצרים adView ריק. עוד...
 
(void) - populateAdView:identifier:
 לאכלס adView במודעה שצוינה באמצעות המזהה. עוד...
 
(void) - populateAdView:identifier:completionHandler:
 אכלוס של adView במודעה שצוינה באמצעות המזהה וקריאה ל-handler להשלמה כשהמודעה מוכנה להצגה. עוד...
 

סיכום הנכס

NSString * publisherID
 מזהה בעל האתר שמשמש לבקשות להצגת מודעות. עוד...
 
NSString * styleID
 מזהה ההגדרות המשמש עבור בקשות להצגת מודעות. עוד...
 
GANSearchAdControllerOptionsoptions
 האפשרויות שהמערכת משתמשת בהן לגבי כל הבקשות להצגת מודעות. עוד...
 
GANExperimentVariantStatus experimentVariantStatus
 אם הסגנון האחרון שהוצג הוא וריאנט של ניסוי, קבוצת בקרה של ניסוי או לא נבחר לניסוי. עוד...
 

פרטי השיטה

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

הפעלה של בקר המודעות.

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

אחזור באופן אסינכרוני של הדף הראשון של המודעות עבור adRequest וכן הדפים הבאים, לפי הצורך.

יש להפעיל את השיטה הזו פעם אחת בלבד לכל בקשה. כשמודעות חדשות ייטענו (או שלא נטענו), תתבצע קריאה ל-GANSearchAdControllerDelegate ב-thread הראשי.

Parameters
adRequestThe GANSearchAdRequest query.
- (void) loadMoreAds

מאחזרת באופן אסינכרוני את הדף הבא של מודעות עבור הבקשה הקודמת שצוינה בקריאה האחרונה אל loadAds:.

אם לא בוצעה קריאה ל-loadAds:, תוחזר שגיאה דרך GANSearchAdControllerDelegate. אם יש דף מלא של מודעות שלא הוצגו, פעולה זו תחזיר גם שגיאה לאדם שהעניק לו את הגישה.

- (NSInteger) adCount

הפונקציה מחזירה את המספר הכולל של מודעות שנטענו מהשיחה האחרונה ל-loadAds:.

- (GANAdView *) adView

יוצרים adView ריק.

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

לאכלס adView במודעה שצוינה באמצעות המזהה.

  • אם adIdentifier הוא מזהה חדש, בתצוגה תוצג המודעה הזמינה הבאה.
  • אם כבר נעשה שימוש ב-adIdentifier, בתצוגה תוצג אותה מודעה שהוצגה בפעם הראשונה שבה בוצעה קריאה לשיטה הזו באמצעות 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 

אכלוס של adView במודעה שצוינה באמצעות המזהה וקריאה ל-handler להשלמה כשהמודעה מוכנה להצגה.

  • אם adIdentifier הוא מזהה חדש, בתצוגה תוצג המודעה הזמינה הבאה.
  • אם כבר נעשה שימוש ב-adIdentifier, בתצוגה תוצג אותה מודעה שהוצגה בפעם הראשונה שבה בוצעה קריאה לשיטה הזו באמצעות 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.

פרטי הנכס

- (NSString*) publisherID
readnonatomiccopy

מזהה בעל האתר שמשמש לבקשות להצגת מודעות.

- (NSString*) styleID
readnonatomiccopy

מזהה ההגדרות המשמש עבור בקשות להצגת מודעות.

- (GANSearchAdControllerOptions*) options
readnonatomicstrong

האפשרויות שהמערכת משתמשת בהן לגבי כל הבקשות להצגת מודעות.

- (GANExperimentVariantStatus) experimentVariantStatus
readnonatomicassign

אם הסגנון האחרון שהוצג הוא וריאנט של ניסוי, קבוצת בקרה של ניסוי או לא נבחר לניסוי.