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 không bắt buộc. 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ý tài sản hình ảnh nâng cao của Quảng cáo gốc nâng cao bằng cách tạo đối tượng GADNativeAdImageAdLoaderOptions, đặt thuộc tính của đối tượng đó (disableImageLoading, preferredImageOrientation, và shouldRequestMultipleImages), và đưa đối tượng đó vào thời điểm khởi chạy.

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

disableImageLoading

Tài sản hình ảnh cho quảng cáo gốc được trả về thông qua 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, giá trị mặc định (NO trong Objective-C), SDK sẽ tự động tìm nạp tài sản hình ảnh, đồng thời điền cả hai thuộc tính image và imageURL cho bạn. Nếu được đặt thành true (hoặc YES trong Objective-C), SDK sẽ chỉ điền imageURL, cho phép bạn tùy ý tải hình ảnh thực tế xuống. Sử dụng thuộc tính mainImage của GADMediaContent để đặt hình ảnh cho chế độ xem nội dung nghe nhìn khi tải hình ả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 các hướng khác nhau 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 tùy chọn cho hướng hình ảnh ngang hoặc dọc, SDK sẽ đặt các hình ảnh phù hợp với hướng đó ở đầu mảng tài sản 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 bạn không gọi phương thức này, hệ thống sẽ sử dụng giá trị mặc định của GADNativeAdImageAdLoaderOptionsOrientationAny.

shouldRequestMultipleImages

Một số tài sản 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 tài sản 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ỉ dẫn SDK chỉ cung cấp hình ảnh đầu tiên cho mọi tài sản có chứa chuỗi 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 của mỗi tùy chọn.

GADNativeAdViewAdOptions

Các đối tượng GADNativeAdViewAdOptions dùng để cho biết các lựa 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 được dùng để cho biết cách hiển thị tài sản 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 tài sản video có bắt đầu phát ở trạng thái tắt tiếng hay không. Giá trị mặc định là true.

GADMultipleAdsAdLoaderOptions

Đối tượng GADMultipleAdsAdLoaderOptions cho phép nhà xuất bản ra lệnh cho trình tải quảng cáo tải nhiều quảng cáo trong một yêu cầu. 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 là numberOfAds. Thuộc tính này biểu thị số lượng quảng cáo mà trình tải quảng cáo sẽ 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 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 lựa 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-C	Swift
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 đặt rõ ràng, thì giá trị sẽ được mặc định là GADMediaAspectRatioUnknown và không có quy định giới hạn nào áp dụng cho tỷ lệ khung hình.