Lớp GANSearchAdController

Tài liệu tham khảo về lớp GANSearchAdController

Tổng quan

Truy xuất quảng cáo tìm kiếm và cung cấp các quảng cáo đó cho ứng dụng khách của SDK.

Kế thừa NSObject.

Tóm tắt phương thức thực thể

(instancetype) - NS_UNAVAILABLE
 
(instancetype) - initWithPublisherID:styleID:options:delegate:
 Khởi động trình kiểm soát quảng cáo. Xem thêm...
 
(void) - loadAds:
 Truy xuất không đồng bộ trang đầu tiên của quảng cáo cho adRequest đã cho và các trang tiếp theo nếu cần. Xem thêm...
 
(void) - loadMoreAds
 Truy xuất không đồng bộ trang tiếp theo của quảng cáo cho yêu cầu trước đó được chỉ định bởi lệnh gọi gần đây nhất đến loadAds:. Xem thêm...
 
(NSInteger) - adCount
 Trả về tổng số quảng cáo đã tải từ lệnh gọi gần đây nhất đến loadAds:. Xem thêm...
 
(GANAdView *) - adView
 Tạo adView trống. Xem thêm...
 
(void) - populateAdView:identifier:
 Điền quảng cáo do giá trị nhận dạng chỉ định vào adView. Xem thêm...
 
(void) - populateAdView:identifier:completionHandler:
 Điền quảng cáo do giá trị nhận dạng chỉ định vào adView và gọi trình xử lý hoàn thành khi quảng cáo đã sẵn sàng để hiển thị. Xem thêm...
 

Tóm tắt về thuộc tính

NSString * publisherID
 Mã nhà xuất bản dùng cho các yêu cầu quảng cáo. Xem thêm...
 
NSString * styleID
 Mã chế độ cài đặt được dùng cho các yêu cầu quảng cáo. Xem thêm...
 
GANSearchAdControllerOptionsoptions
 Các lựa chọn được sử dụng cho tất cả yêu cầu quảng cáo. Xem thêm...
 
GANExperimentVariantStatus experimentVariantStatus
 Liệu kiểu được phân phát gần đây nhất là biến thể thử nghiệm, đối chứng thử nghiệm hay không được chọn cho thử nghiệm. Xem thêm...
 

Chi tiết phương pháp

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

Khởi động trình kiểm soát quảng cáo.

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

Truy xuất không đồng bộ trang đầu tiên của quảng cáo cho adRequest đã cho và các trang tiếp theo nếu cần.

Bạn chỉ nên gọi phương thức này một lần cho mỗi yêu cầu. Khi quảng cáo mới được tải (hoặc không tải được), GANSearchAdControllerDelegate sẽ được gọi trên luồng chính.

Parameters
adRequestThe GANSearchAdRequest query.
- (void) loadMoreAds

Truy xuất không đồng bộ trang tiếp theo của quảng cáo cho yêu cầu trước đó được chỉ định bởi lệnh gọi gần đây nhất đến loadAds:.

Nếu loadAds: không được gọi, thao tác này sẽ trả về một lỗi thông qua GANSearchAdControllerDelegate. Nếu có toàn bộ trang quảng cáo chưa được hiển thị, thao tác này cũng sẽ trả về lỗi cho thực thể đại diện.

- (NSInteger) adCount

Trả về tổng số quảng cáo đã tải từ lệnh gọi gần đây nhất đến loadAds:.

- (GANAdView *) adView

Tạo adView trống.

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

Điền quảng cáo do giá trị nhận dạng chỉ định vào adView.

  • nếu adIdentifier là giá trị nhận dạng mới, chế độ xem sẽ hiển thị quảng cáo có sẵn tiếp theo.
  • nếu đã sử dụng adIdentifier, khung hiển thị sẽ cho thấy cùng một quảng cáo đã hiển thị vào lần đầu tiên phương thức này được gọi bằng 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 

Điền quảng cáo do giá trị nhận dạng chỉ định vào adView và gọi trình xử lý hoàn thành khi quảng cáo đã sẵn sàng để hiển thị.

  • nếu adIdentifier là giá trị nhận dạng mới, chế độ xem sẽ hiển thị quảng cáo có sẵn tiếp theo.
  • nếu đã sử dụng adIdentifier, khung hiển thị sẽ cho thấy cùng một quảng cáo đã hiển thị vào lần đầu tiên phương thức này được gọi bằng 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.

Chi tiết về cơ sở lưu trú

- (NSString*) publisherID
readnonatomiccopy

Mã nhà xuất bản dùng cho các yêu cầu quảng cáo.

- (NSString*) styleID
readnonatomiccopy

Mã chế độ cài đặt được dùng cho các yêu cầu quảng cáo.

- (GANSearchAdControllerOptions*) options
readnonatomicstrong

Các lựa chọn được sử dụng cho tất cả yêu cầu quảng cáo.

- (GANExperimentVariantStatus) experimentVariantStatus
readnonatomicassign

Liệu kiểu được phân phát gần đây nhất là biến thể thử nghiệm, đối chứng thử nghiệm hay không được chọn cho thử nghiệm.