Tùy chọn quảng cáo gốc

Thông số cuối cùng đã bao gồm trong quá trình tạo GADAdLoader là một mảng các đối tượng tùy chọn. Mục này mô tả các tùy chọn đó.

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions chứa các thuộc tính liên quan đến hình ảnh trong Quảng cáo gốc nâng cao. Các ứng dụng có thể kiểm soát cách GADAdLoader xử lý nội dung hình ảnh Quảng cáo gốc nâng cao bằng cách tạo đối tượng GADNativeAdImageAdLoaderOptions, cài đặt thuộc tính (disableImageLoading, preferredImageOrientation và shouldRequestMultipleImages), rồi chuyển đối tượng đó trong quá trình khởi tạo.

GADNativeAdImageAdLoaderOptions có các thuộc tính sau:

disableImageLoading
Nội dung hình ảnh cho quảng cáo gốc được trả về thông qua các bản sao của GADNativeAdImage có chứa các thuộc tính image và imageURL. Nếu disableImageLoading được đặt thành false, vốn là giá trị mặc định (giá trị này là NO trong Objective-C), thì SDK sẽ tự động tìm nạp nội dung hình ảnh, cũng như điền cả thuộc tính image và imageURL cho bạn. Nếu được đặt thành true (hoặc YES trong Objective-C), thì SDK sẽ chỉ điền imageURL, cho phép bạn tải các hình ảnh thực nếu muốn. Hãy sử dụng thuộc tính mainImage của GADMediaContent để cài đặt hình ảnh cho chế độ xem nội dung khi tải ảnh xuống theo cách thủ công.
preferredImageOrientation

Một số quảng cáo có sẵn nhiều hình ảnh để khớp với nhiều hướng của thiết bị. Các ứng dụng có thể yêu cầu hiển thị hình ảnh theo một hướng cụ thể bằng cách đặt thuộc tính này thành một trong các hằng số quy định hướng:

  • GADNativeAdImageAdLoaderOptionsOrientationAny
  • GADNativeAdImageAdLoaderOptionsOrientationLandscape

  • GADNativeAdImageAdLoaderOptionsOrientationPortrait

    Nếu bạn sử dụng preferredImageOrientation để chỉ định một tùy chọn cho hướng hình ảnh ngang hoặc dọc, thì SDK sẽ đặt các hình ảnh phù hợp với hướng đó ở đầu mảng nội dung hình ảnh và đặt các hình ảnh không phù hợp theo sau. Do một số quảng cáo chỉ có một hướng duy nhất nên nhà xuất bản cần đảm bảo rằng các ứng dụng của mình có khả năng xử lý được cả hình ảnh ngang và hình ảnh dọc.

    Nếu phương thức này không được gọi, hệ thống sẽ sử dụng giá trị mặc định của GADNativeAdImageAdLoaderOptionsOrientationAny.

shouldRequestMultipleImages

Một số nội dung hình ảnh chứa một loạt hình ảnh thay vì chỉ một hình ảnh. Khi đặt giá trị này thành true, ứng dụng của bạn cho biết rằng ứng dụng đã sẵn sàng hiển thị tất cả hình ảnh cho mọi nội dung có nhiều hình ảnh. Khi đặt giá trị này thành false (mặc định), ứng dụng của bạn chỉ thị cho SDK chỉ cung cấp hình ảnh đầu tiên cho mọi nội dung có chứa loạt hình ảnh.

Nếu không có đối tượng GADAdLoaderOptions nào được chuyển vào khi khởi chạy GADAdLoader, hệ thống sẽ sử dụng giá trị mặc định cho mỗi tùy chọn.

GADNativeAdViewAdOptions

Các đối tượng GADNativeAdViewAdOptions dùng để chỉ định các tùy chọn về cách chế độ xem quảng cáo gốc sẽ hiển thị quảng cáo. Các đối tượng này có một thuộc tính duy nhất: preferredAdChoicesPosition. Bạn có thể sử dụng thuộc tính này để chỉ định vị trí đặt biểu tượng Lựa chọn quảng cáo. Biểu tượng này có thể xuất hiện ở bất kỳ góc nào của quảng cáo và mặc định là GADAdChoicesPositionTopRightCorner. Thuộc tính này có thể có các giá trị sau:

  • GADAdChoicesPositionTopRightCorner
  • GADAdChoicesPositionTopLeftCorner
  • GADAdChoicesPositionBottomRightCorner
  • GADAdChoicesPositionBottomLeftCorner

Dưới đây là ví dụ cho thấy cách đặt biểu tượng Lựa chọn quảng cáo ở góc trên cùng bên trái của quảng cáo:

Swift

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GADVideoOptions

Các đối tượng GADVideoOptions dùng để cho biết cách hiển thị nội dung video gốc. Các đối tượng này cung cấp một thuộc tính duy nhất: startMuted.

Boolean này sẽ cho biết liệu nội dung video có bắt đầu phát lại ở trạng thái tắt tiếng hay không. Giá trị mặc định là true.

GADMultipleAdsAdLoaderOptions

Các đối tượng GADMultipleAdsAdLoaderOptions cho phép nhà xuất bản ra chỉ thị cho trình tải quảng cáo tải nhiều quảng cáo trong một yêu cầu. Các quảng cáo được tải theo cách này sẽ đảm bảo là không trùng lặp. GADMultipleAdsAdLoaderOptions có một thuộc tính duy nhất, numberOfAds, biểu thị số lượng quảng cáo mà trình tải quảng cáo nên cố gắng trả về cho yêu cầu. Theo mặc định, giá trị này là 1 và giới hạn tối đa là 5 quảng cáo (ngay cả khi ứng dụng yêu cầu nhiều quảng cáo, thì hệ thống cũng chỉ trả về tối đa là 5 quảng cáo). Số lượng quảng cáo thực tế được trả về sẽ không được đảm bảo, nhưng sẽ nằm trong khoảng từ 0 đến numberOfAds.

GADNativeAdMediaAdLoaderOptions

Để sử dụng tính năng này, hãy đưa lớp GADNativeAdMediaAdLoaderOptions vào trong mảng tùy chọn quảng cáo gốc trong quá trình khởi tạo GADAdLoader.

Đối tượng GADNativeAdMediaAdLoaderOptions cho phép bạn chọn tùy chọn tỷ lệ khung hình cho nội dung nghe nhìn. Tùy chọn này được áp dụng cho cả hình ảnh và video. Lớp này có một thuộc tính: mediaAspectRatio. Bạn có thể sử dụng thuộc tính này để chỉ định tỷ lệ khung hình cho nội dung nghe nhìn được hỗ trợ. Thuộc tính này có thể có các giá trị sau:

Objective-CSwift
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

Khi bạn đặt mediaAspectRatio thành một trong các tùy chọn sau, hệ thống sẽ chỉ trả về các quảng cáo chứa nội dung nghe nhìn có tỷ lệ khung hình được chỉ định. Nếu thuộc tính này không được cài đặt một cách rõ ràng, thì giá trị sẽ được mặc định là GADMediaAspectRatioUnknown và không áp dụng giới hạn nào đối với tỷ lệ khung hình.