คลาส GANSearchAdController

การอ้างอิงคลาส GANSearchAdController

ภาพรวม

ดึงข้อมูลโฆษณา Search และทำให้พร้อมใช้งานสำหรับลูกค้าของ 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 ด้วยโฆษณาที่ระบุโดยตัวระบุ และเรียกตัวแฮนเดิลการทำงานที่เสร็จสมบูรณ์เมื่อโฆษณาพร้อมแสดง เพิ่มเติม...
 

สรุปพร็อพเพอร์ตี้

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 ในเทรดหลัก

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 ด้วยโฆษณาที่ระบุโดยตัวระบุ และเรียกตัวแฮนเดิลการทำงานที่เสร็จสมบูรณ์เมื่อโฆษณาพร้อมแสดง

  • หาก 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

ดูว่าสไตล์ที่แสดงล่าสุดเป็นตัวแปรการทดสอบ ตัวควบคุมการทดสอบ หรือไม่ได้รับเลือกสำหรับการทดสอบ