Kiểu gốc

Lưu ý: Kiểu gốc sử dụng HTML và CSS mà bạn định cấu hình trong Google Ad Manager. Nếu bạn đang tìm cách hiển thị quảng cáo trong ứng dụng của riêng mình bằng cách sử dụng đối tượng gốc, vui lòng xem Quảng cáo gốc nâng cao.

Cài đặt kiểu gốc cho phép Google Ad Manager xử lý hiển thị quảng cáo gốc dựa trên kiểu mà bạn chỉ định trong sản phẩm. Trước tiên, hãy chỉ định kích thước và tiêu chí nhắm mục tiêu. Sau đó, thêm HTML, CSS và JavaScript để xác định quảng cáo thích ứng và tạo ra hình ảnh chất lượng hiển thị trên tất cả các màn hình. Bạn không cần làm gì bất kỳ kết xuất nào; Ad Manager tự động áp dụng kiểu gốc phù hợp cho đích đến. Kiểu gốc được triển khai giống như quảng cáo biểu ngữ, thông qua một GAMBannerView. Có thể dùng với một quảng cáo cố định kích thước được xác định trước hoặc kích thước quảng cáo linh hoạt được xác định trong thời gian chạy.

Điều kiện tiên quyết

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 7.14.0 trở lên

Hướng dẫn này giả định rằng bạn đã có kiến thức nhất định về cách sử dụng SDK Quảng cáo của Google trên thiết bị di động. Nếu bạn chưa làm như vậy, hãy cân nhắc xem qua Hướng dẫn Bắt đầu sử dụng.

Kích thước cố định

Kiểu gốc có kích thước cố định cho phép bạn kiểm soát chiều rộng và chiều cao của quảng cáo gốc. Để đặt kích thước cố định, hãy làm theo các bước sau:

1. Tạo một mục hàng trong giao diện người dùng Ad Manager và chọn một trong các kích thước xác định trước từ trình đơn thả xuống của trường Size.

2. Trong Trình tạo giao diện, hãy đặt chiều rộng và chiều cao của GAMBannerView để khớp với kích thước xác định trước bạn đã chọn ở bước 1. Bạn có thể thấy một danh sách kích thước và hằng số GADAdSize tương ứng của chúng trong Biểu ngữ kích thước .

Việc triển khai kiểu gốc với kích thước cố định cũng đơn giản như sau hướng dẫn trong Biểu ngữ đầu tiên của bạn , nhưng bạn có được sự linh hoạt và quyền kiểm soát đối với HTML, CSS và JavaScript để mang lại giao diện gốc tự nhiên cho quảng cáo biểu ngữ trong ứng dụng của bạn.

Kích thước linh hoạt

Trong một số trường hợp, kích thước cố định có thể không hợp lý. Ví dụ: bạn có thể muốn chiều rộng của quảng cáo phù hợp với nội dung ứng dụng, nhưng cần chiều cao của quảng cáo để điều chỉnh một cách linh hoạt cho phù hợp với nội dung của quảng cáo. Để xử lý trường hợp này, bạn có thể chỉ định Fluid làm kích thước quảng cáo trong giao diện người dùng Ad Manager. chỉ định rằng kích thước của quảng cáo được xác định tại thời gian chạy trong ứng dụng. SDK cung cấp một hằng số GADAdSize đặc biệt, kGADAdSizeFluid! để xử lý trường hợp này. Chiều cao kích thước quảng cáo linh hoạt được xác định động dựa trên chiều rộng do nhà xuất bản xác định, cho phép GAMBannerView! để điều chỉnh chiều cao cho phù hợp với chiều cao của quảng cáo.

Yêu cầu linh hoạt

Không giống như các định dạng quảng cáo khác, kích thước quảng cáo kGADAdSizeFluid không có chiều rộng được xác định trước, nên hãy nhớ đặt khung của biểu ngữ một cách rõ ràng trong mã hoặc trong Trình tạo giao diện. Nếu chiều rộng không được chỉ định, theo mặc định, SDK sẽ đặt chiều cao của biểu ngữ dựa trên chiều rộng của thiết bị.

Nếu bạn đưa ra một yêu cầu nhiều kích thước bao gồm kGADAdSizeFluid, quảng cáo trả về luôn được đặt bên trong một vùng chứa linh hoạt và hoạt động như một quảng cáo linh hoạt. Trong trường hợp mẫu quảng cáo không linh hoạt được trả về trong vùng chứa linh hoạt này, SDK sẽ căn giữa quảng cáo trong vùng chứa để bạn không phải sửa đổi giới hạn chiều rộng mỗi khi quảng cáo mới được trả về.

Việc triển khai để tạo một kích thước duy nhất và một kích thước linh hoạt đa kích thước yêu cầu rất giống nhau; điểm khác biệt duy nhất là đối với quảng cáo nhiều kích thước theo yêu cầu, bạn sẽ đặt thuộc tính validAdSizes để chỉ định quảng cáo kích thước hợp lệ cho yêu cầu quảng cáo:

Swift

bannerView.validAdSizes = [NSValueFromGADAdSize(kGADAdSizeFluid),
                           NSValueFromGADAdSize(kGADAdSizeBanner)]

Objective-C

_bannerView.validAdSizes = @[ NSValueFromGADAdSize(kGADAdSizeFluid),
                              NSValueFromGADAdSize(kGADAdSizeBanner) ];

Dưới đây là toàn bộ quy trình triển khai trong mã:

Swift

var bannerView: GAMBannerView!

override func viewDidLoad() {
  super.viewDidLoad()
  // Create the GAMBannerView and set its width to a width that makes sense for your
  // app. In this example, the width is set to the width of the UIViewController's
  // root view.
  bannerView = GAMBannerView(adSize: kGADAdSizeFluid)
  var frameRect = bannerView.frame
  frameRect.size.width = view.bounds.width
  bannerView.frame = frameRect

  // Uncomment this code for a multisize fluid request.
  // bannerView.validAdSizes = [NSValueFromGADAdSize(kGADAdSizeFluid),
  //                            NSValueFromGADAdSize(kGADAdSizeBanner)]

  bannerView.adUnitID = "YOUR_AD_UNIT_ID"
  bannerView.rootViewController = self

  // Make the ad request.
  bannerView.load(GAMRequest())
}

Objective-C

GAMBannerView *_bannerView;

- (void)viewDidLoad {
  [super viewDidLoad];
  // Create the GAMBannerView and set its width to a width that makes sense for your
  // app. In this example, the width is set to the width of the UIViewController's
  // root view.
  _bannerView = [[GAMBannerView alloc] initWithAdSize:kGADAdSizeFluid];
  CGRect frameRect = _bannerView.frame;
  frameRect.size.width = CGRectGetWidth(self.view.bounds);
  _bannerView.frame = frameRect;

  // Uncomment this code for a multisize fluid request.
  // _bannerView.validAdSizes = @[ NSValueFromGADAdSize(kGADAdSizeFluid),
  //                               NSValueFromGADAdSize(kGADAdSizeBanner) ];

  _bannerView.adUnitID = @"YOUR_AD_UNIT_ID";
  _bannerView.rootViewController = self;

  // Make the ad request.
  [_bannerView loadRequest:[GAMRequest request]];
}

Để xem ví dụ về cách triển khai kích thước quảng cáo Linh hoạt trong Ad Manager, tải ứng dụng iOS API Demo xuống trong Swift hoặc Target-C.

Tải bản minh hoạ API xuống

Giao thức GADAdSizeDelegate

Bạn có thể muốn biết chiều cao của biểu ngữ trước khi kích thước quảng cáo thay đổi. Lệnh gọi lại adView:willChangeAdSizeTo: sẽ thông báo cho người được uỷ quyền trước chế độ xem biểu ngữ sẽ thay đổi thành GADAdSize mới. Sẽ được thông báo trước chế độ xem biểu ngữ sẽ thay đổi thành kích thước quảng cáo mới, thì lớp của bạn phải tuân theo giao thức GADAdSizeDelegate.

Dưới đây là ví dụ về cách triển khai adView:willChangeAdSizeTo: lệnh gọi lại cho biết cách lấy chiều rộng và chiều cao mới của biểu ngữ:

Swift

// To be notified before the banner's ad size changes, your view controller class must
// conform to the GADAdSizeDelegate protocol.
bannerView.adSizeDelegate = self

// MARK: - GADAdSizeDelegate

func adView(_ bannerView: GADBannerView, willChangeAdSizeTo adSize: GADAdSize) {
  let height = adSize.size.height
  let width = adSize.size.width
}

Objective-C

// To be notified before the banner's ad size changes, your view controller class must
// conform to the GADAdSizeDelegate protocol.
_bannerView.adSizeDelegate = self;

#pragma mark - GADAdSizeDelegate

- (void)adView:(GADBannerView *)bannerView willChangeAdSizeTo:(GADAdSize)adSize {
  CGFloat height = adSize.size.height;
  CGFloat width = adSize.size.width;
}