Quảng cáo gốc

Quảng cáo gốc là thành phần quảng cáo hiển thị cho người dùng thông qua các thành phần giao diện người dùng vốn có của nền tảng. Các ứng dụng đó sẽ xuất hiện bằng cách sử dụng cùng một lớp mà bạn đã sử dụng trong bảng phân cảnh của bạn và có thể được định dạng cho phù hợp với thiết kế trực quan của ứng dụng.

Khi một quảng cáo gốc tải, ứng dụng của bạn sẽ nhận được một đối tượng quảng cáo có chứa các thành phần của quảng cáo đó. và ứng dụng—thay vì SDK quảng cáo trên thiết bị di động của Google—khi đó chịu trách nhiệm hiển thị các quảng cáo đó.

Nói chung, có hai phần để triển khai thành công quảng cáo gốc: Tải quảng cáo bằng SDK, sau đó hiển thị nội dung quảng cáo trong ứng dụng của bạn.

Trang này cho biết cách sử dụng SDK để tải quảng cáo gốc.

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

• Xem hết hướng dẫn Bắt đầu sử dụng.

Luôn thử nghiệm bằng quảng cáo thử nghiệm

Khi tạo và thử nghiệm ứng dụng, hãy nhớ sử dụng quảng cáo thử nghiệm thay vì quảng cáo đang chạy trong thực tế.

Cách dễ nhất để tải quảng cáo thử nghiệm là sử dụng mã đơn vị quảng cáo thử nghiệm dành riêng cho quảng cáo gốc trên iOS:

ca-app-pub-3940256099942544/3986624511

Mã này được định cấu hình đặc biệt để trả về quảng cáo thử nghiệm cho mọi yêu cầu và bạn có thể sử dụng nó trong ứng dụng của riêng bạn khi lập trình, thử nghiệm và gỡ lỗi. Bạn chỉ cần thay thế mã này bằng mã đơn vị quảng cáo của mình trước khi xuất bản ứng dụng.

Để biết thêm thông tin về cách hoạt động của quảng cáo thử nghiệm của SDK Quảng cáo của Google trên thiết bị di động, hãy xem Quảng cáo thử nghiệm.

Tải quảng cáo

Quảng cáo gốc được tải bằng GADAdLoader để gửi thông báo cho người được uỷ quyền theo GADAdLoaderDelegate giao thức.

Khởi chạy trình tải quảng cáo

Trước khi có thể tải một quảng cáo, bạn phải khởi chạy trình tải quảng cáo. Mã sau đây minh hoạ cách khởi chạy GADAdLoader:

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    // The UIViewController parameter is optional.
    rootViewController: rootViewController,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    // The UIViewController parameter is nullable.
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

Bạn cần có một mã đơn vị quảng cáo (có thể dùng mã thử nghiệm), các hằng số để chuyển vào mảng adTypes nhằm chỉ định các định dạng quảng cáo gốc mà bạn muốn yêu cầu và bất kỳ tuỳ chọn nào bạn muốn đặt trong thông số options. Bạn có thể tìm thấy danh sách các giá trị có thể sử dụng cho thông số options trong trang Đặt các tuỳ chọn quảng cáo gốc.

Mảng adTypes phải chứa hằng số này :

• GADAdLoaderAdTypeNative

Triển khai thực thể uỷ quyền của trình tải quảng cáo

Đại biểu của trình tải quảng cáo cần triển khai các giao thức dành riêng cho loại quảng cáo của bạn. Đối với quảng cáo gốc, giao thức GADNativeAdLoaderDelegate bao gồm một thông báo được gửi tới đại biểu khi quảng cáo gốc đã tải.

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

Yêu cầu quảng cáo

Sau khi bạn khởi chạy GADAdLoader, hãy gọi phương thức loadRequest: để yêu cầu quảng cáo:

adLoader.load(GADRequest())

[self.adLoader loadRequest:[GADRequest request]];

Chiến lược phát hành đĩa đơn loadRequest: phương thức trong GADAdLoader chấp nhận tương tự GADRequest làm biểu ngữ và quảng cáo xen kẽ. Bạn có thể sử dụng các đối tượng yêu cầu để thêm thông tin nhắm mục tiêu, giống như cách bạn thực hiện với các loại quảng cáo khác.

Tải nhiều quảng cáo (không bắt buộc)

Để tải nhiều quảng cáo trong một yêu cầu, hãy đặt GADMultipleAdsAdLoaderOptions khi khởi tạo GADAdLoader.

let multipleAdOptions = GADMultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5;
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    // The UIViewController parameter is optional.
    rootViewController: self,
    adTypes: [ .native ],
    options: [ multipleAdOptions ])

GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
    [[GADMultipleAdsAdLoaderOptions alloc] init];
multipleAdsOptions.numberOfAds = 5;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    // The UIViewController parameter is nullable.
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ multipleAdsOptions ]];

Số lượng quảng cáo trên mỗi yêu cầu được giới hạn ở mức 5 và hệ thống không đảm bảo rằng SDK sẽ trả về đúng số lượng quảng cáo được yêu cầu.

Tất cả quảng cáo của Google được trả về sẽ khác nhau, mặc dù quảng cáo từ khoảng không quảng cáo được đặt trước hoặc người mua bên thứ ba không được đảm bảo là duy nhất.

Không sử dụng lớp GADMultipleAdsAdLoaderOptions nếu bạn đang sử dụng tính năng dàn xếp, vì yêu cầu cho nhiều quảng cáo gốc hiện không hoạt động đối với ID đơn vị quảng cáo đã được định cấu hình cho dàn xếp.

Xác định thời điểm quá trình tải hoàn tất

Sau khi gọi loadRequest:, một ứng dụng có thể nhận được kết quả của yêu cầu bằng cách sử dụng cuộc gọi đến:

• adLoader:didFailToReceiveAdWithError: trong GADAdLoaderDelegate
• adLoader:didReceiveNativeAd: trong GADNativeAdLoaderDelegate

Việc yêu cầu một quảng cáo sẽ tạo ra một lệnh gọi đến một trong những phương thức đó.

Việc yêu cầu nhiều quảng cáo sẽ dẫn đến ít nhất một lệnh gọi lại đến các phương thức trên, nhưng không nhiều hơn số lượng quảng cáo tối đa đã yêu cầu.

Ngoài ra, GADAdLoaderDelegate còn cung cấp adLoaderDidFinishLoading . Phương thức uỷ quyền này cho biết rằng một trình tải quảng cáo đã hoàn tất quá trình tải quảng cáo và không có lỗi hoặc quảng cáo nào khác được báo cáo cho yêu cầu. Dưới đây là ví dụ về cách sử dụng phương thức này khi tải nhiều quảng cáo gốc cùng một lúc:

class ViewController: UIViewController, GADNativeAdLoaderDelegate {

  var adLoader: GADAdLoader!

  override func viewDidLoad() {
    super.viewDidLoad()

    let multipleAdOptions = GADMultipleAdsAdLoaderOptions()
    multipleAdOptions.numberOfAds = 5;
    adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
        // The UIViewController parameter is optional.
        rootViewController: rootViewController,
        adTypes: [ .native ],
        options: [ multipleAdOptions ])

    adLoader.delegate = self
    adLoader.load(GADRequest())
  }

  func adLoader(_ adLoader: GADAdLoader,
       didReceive nativeAd: GADNativeAd) {
    // A native ad has loaded, and can be displayed.
  }

  func adLoaderDidFinishLoading(_ adLoader: GADAdLoader) {
    // The adLoader has finished loading ads, and a new request can be sent.
  }

}

@interface ViewController () <GADNativeAdLoaderDelegate, GADVideoControllerDelegate>
@property(nonatomic, strong) GADAdLoader *adLoader;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  GADMultipleAdsAdLoaderOptions *multipleAdsOptions =
      [[GADMultipleAdsAdLoaderOptions alloc] init];
  multipleAdsOptions.numberOfAds = 5;
  self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
      // The UIViewController parameter is nullable.
      rootViewController:rootViewController
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ multipleAdsOptions ]];

  self.adLoader.delegate = self;
  [self.adLoader loadRequest:[GADRequest request]];
}

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd {
  // A native ad has loaded, and can be displayed.
}

- (void)adLoaderDidFinishLoading:(GADAdLoader *) adLoader {
  // The adLoader has finished loading ads, and a new request can be sent.
}

@end

Xử lý các yêu cầu không thành công

Các giao thức nói trên mở rộng giao thức GADAdLoaderDelegate để xác định thông báo sẽ được gửi khi quảng cáo tải không thành công.

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

Nhận thông báo về các sự kiện quảng cáo gốc

Để nhận thông báo về những sự kiện liên quan đến lượt tương tác với quảng cáo gốc, hãy đặt thực thể đại diện thuộc tính của quảng cáo gốc:

nativeAd.delegate = self

nativeAd.delegate = self;

Sau đó, hãy triển khai GADNativeAdDelegate để nhận các lệnh gọi uỷ quyền sau:

func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

Các phương pháp hay nhất

Hãy tuân thủ các quy tắc này khi tải quảng cáo.

• Các ứng dụng sử dụng quảng cáo gốc trong danh sách phải lưu trước danh sách quảng cáo vào bộ nhớ đệm.

• Khi lưu quảng cáo vào bộ nhớ đệm, hãy xoá bộ nhớ đệm rồi tải lại sau một giờ.

• Đừng gọi lại loadRequest: trên GADAdLoader cho đến khi yêu cầu trước đó tải xong, như được biểu thị bằng adLoaderDidFinishLoading:.

• Giới hạn chỉ lưu quảng cáo gốc vào bộ nhớ đệm ở những nội dung cần thiết. Ví dụ: khi lưu vào bộ nhớ đệm trước, chỉ lưu vào bộ nhớ đệm những quảng cáo hiển thị ngay trên màn hình. Quảng cáo gốc chiếm nhiều bộ nhớ và việc lưu quảng cáo gốc vào bộ nhớ đệm mà không huỷ bỏ các quảng cáo đó sẽ dẫn đến việc sử dụng bộ nhớ quá mức.

• Huỷ quảng cáo gốc khi không còn sử dụng.

Hiển thị quảng cáo của bạn

Sau khi bạn đã tải quảng cáo, tất cả công việc còn lại là hiển thị quảng cáo cho người dùng. Chuyển đến Quảng cáo gốc nâng cao hướng dẫn để xem cách thực hiện.