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. Quảng cáo này hiển thị bằng cách sử dụng chính các lớp mà bạn đã dùng trong bảng phân cảnh, và có thể được định dạng để phù hợp với kiểu 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 chứa các thành phần của quảng cáo đó, sau đó ứng dụng (thay vì SDK Google Ads cho thiết bị di động) sẽ chịu trách nhiệm hiển thị các thành phần đó.

Nói chung, có hai bước để triển khai thành công quảng cáo gốc: Tải quảng cáo bằng SDK rồi 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:

/21775744923/example/native

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 mã này trong ứng dụng của mình khi lập trình, chạy 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 bài viết Quảng cáo thử nghiệm.

Tải quảng cáo

Quảng cáo gốc được tải bằng lớp GADAdLoader. Lớp này sẽ gửi thông báo đến thực thể đại diện theo giao thức GADAdLoaderDelegate.

Ngoài định dạng quảng cáo gốc do hệ thống xác định, bạn cũng có thể tạo định dạng quảng cáo gốc tuỳ chỉnh của riêng mình để sử dụng cho quảng cáo gốc được bán trực tiếp. Định dạng quảng cáo gốc tuỳ chỉnh cho phép bạn chuyển dữ liệu có cấu trúc tuỳ ý đến ứng dụng của mình. Các quảng cáo này do lớp GADCustomNativeAd biểu thị.

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

Trước khi tải 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:

Swift

adLoader = GADAdLoader(adUnitID: "/21775744923/example/native",
    // The UIViewController parameter is optional.
    rootViewController: rootViewController,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/21775744923/example/native"
    // 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 một hoặc nhiều hằng số sau:

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

Triển khai đại biểu của trình tải quảng cáo

Thực thể uỷ quyền 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 sẽ gửi một thông báo đến thực thể đại diện khi quảng cáo gốc đã tải xong.

Swift

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

Objective-C

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

Giao thức GADCustomNativeAdLoaderDelegate bao gồm một thông báo được gửi tới thực thể đại diện khi quảng cáo mẫu tuỳ chỉnh đã tải xong.

Swift

func adLoader(_ adLoader: GADAdLoader,
  Receive customNativeAd: GADCustomNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *) customNativeAd;

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

Mẹo: Bạn có thể sử dụng lệnh gọi tải quảng cáo để tạo bộ nhớ đệm của quảng cáo được tải trước trước khi bạn dự định hiển thị quảng cáo, nhờ đó quảng cáo có thể hiển thị mà không có độ trễ khi cần. Vì quảng cáo hết hạn sau một giờ, nên bạn nên xoá bộ nhớ đệm này và tải lại bằng quảng cáo mới mỗi giờ.

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:

Swift

adLoader.load(GAMRequest())

Objective-C

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

Phương thức loadRequest: trong GADAdLoader chấp nhận các đối tượng GAMRequest giống với đối tượng của quảng cáo 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.

Lưu ý: Ad Manager không hỗ trợ tải nhiều quảng cáo bằng GADMultipleAdsAdLoaderOptions và chỉ trả về một quảng cáo nếu được sử dụng.

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 đó thông qua các lệnh gọi tới:

• 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 đó.

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.

Swift

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

Objective-C

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

Cảnh báo: Bạn không nên tìm cách tải quảng cáo mới từ phương thức uỷ quyền adLoader:didFailToReceiveAdWithError:. Nếu bạn phải tải quảng cáo từ adLoader:didFailToReceiveAdWithError:, hãy hạn chế số lần thử tải lại quảng cáo để tránh việc liên tục không thực hiện được yêu cầu quảng cáo trong những trường hợp như khả năng kết nối mạng bị hạn chế.

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 có liên quan đến các lượt tương tác với quảng cáo gốc, hãy đặt thuộc tính uỷ quyền của quảng cáo gốc:

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

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

Swift

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.
}

Objective-C

- (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 theo các quy tắc sau 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 trước, hãy xoá bộ nhớ đệm và 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:.

• Chỉ lưu quảng cáo gốc vào bộ nhớ đệm khi 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

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. Hãy xem Hướng dẫn về Quảng cáo gốc nâng cao của chúng tôi để biết cách thực hiện.