סקירה כללית
אחזור של מודעות לרשת החיפוש והפיכתן לזמינות ללקוח ה-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 |
מזהה ההגדרות המשמש עבור בקשות להצגת מודעות. עוד... | |
GANSearchAdControllerOptions * | options |
האפשרויות שהמערכת משתמשת בהן לגבי כל הבקשות להצגת מודעות. עוד... | |
GANExperimentVariantStatus | experimentVariantStatus |
אם הסגנון האחרון שהוצג הוא וריאנט של ניסוי, קבוצת בקרה של ניסוי או לא נבחר לניסוי. עוד... | |
פרטי השיטה
- (instancetype) initWithPublisherID: | (NSString *) | publisherID | |
styleID: | (NSString *) | styleID | |
options: | (nullable GANSearchAdControllerOptions *) | options | |
delegate: | (nullable id< GANSearchAdControllerDelegate >) | delegate | |
הפעלה של בקר המודעות.
- Parameters
-
publisherID The publisher id, e.g. "ms-app-pub-9616389000213823". styleID The settings id for the template that will be used to render native ads. options GANSearchAdControllerOptions, such as adTest, and adSafe, etc. delegate GANSearchAdControllerDelegate for receiving notifications when ads are loaded and other events.
- (void) loadAds: | (GANSearchAdRequest *) | adRequest |
אחזור באופן אסינכרוני של הדף הראשון של המודעות עבור adRequest
וכן הדפים הבאים, לפי הצורך.
יש להפעיל את השיטה הזו פעם אחת בלבד לכל בקשה. כשמודעות חדשות ייטענו (או שלא נטענו), תתבצע קריאה ל-GANSearchAdControllerDelegate
ב-thread הראשי.
- Parameters
-
adRequest The 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
-
view The GANAdView to populate. adIdentifier An 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
-
view The GANAdView to populate. adIdentifier An 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. completionHandler The 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.
פרטי הנכס
|
readnonatomiccopy |
מזהה בעל האתר שמשמש לבקשות להצגת מודעות.
|
readnonatomiccopy |
מזהה ההגדרות המשמש עבור בקשות להצגת מודעות.
|
readnonatomicstrong |
האפשרויות שהמערכת משתמשת בהן לגבי כל הבקשות להצגת מודעות.
|
readnonatomicassign |
אם הסגנון האחרון שהוצג הוא וריאנט של ניסוי, קבוצת בקרה של ניסוי או לא נבחר לניסוי.