原生廣告是透過平台原生 UI 元件向使用者顯示的廣告素材資源。這些檢視區塊會使用您在情節提要中已使用的相同類別顯示,並可設定格式,與應用程式的視覺設計相符。
載入原生廣告時,應用程式會收到含有廣告素材的廣告物件,並由應用程式 (而非 Google Mobile Ads SDK) 負責顯示廣告素材。
廣義來說,成功導入原生廣告的流程分為兩個部分: 使用 SDK 載入廣告,然後在應用程式中顯示廣告內容。
本頁面說明如何使用 SDK 載入原生廣告。
必要條件
- 完成入門指南。
一律使用測試廣告進行測試
建構及測試應用程式時,請務必使用測試廣告,而非實際的正式廣告。
如要載入測試廣告,最簡單的方法是使用專為 iOS 原生廣告提供的測試廣告單元 ID:
ca-app-pub-3940256099942544/3986624511
這個 ID 經過特別設定,可針對每項要求傳回測試廣告,您可以在編寫、測試及偵錯時,在自己的應用程式中使用這個 ID。發布應用程式前,請務必將其替換為您自己的廣告單元 ID。
如要進一步瞭解 Google Mobile Ads SDK 測試廣告的運作方式,請參閱「測試廣告」。
載入廣告
系統會載入原生廣告,並使用 GADAdLoader
類別,根據 GADAdLoaderDelegate
通訊協定將訊息傳送至委派對象。
初始化廣告載入器
您必須先初始化廣告載入器,才能載入廣告。
下列程式碼示範如何初始化 GADAdLoader
:
Swift
adLoader = AdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
// The UIViewController parameter is optional.
rootViewController: rootViewController,
adTypes: [ .native ],
options: [ ... ad loader options objects ... ])
adLoader.delegate = self
Objective-C
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;
您需要廣告單元 ID (可以使用測試 ID)、要傳遞至 adTypes
陣列的常數 (指定要要求哪些原生格式),以及要在 options
參數中設定的任何選項。如要查看 options
參數的可能值清單,請參閱「設定原生廣告選項」頁面。
adTypes
陣列應包含這個常數:
實作廣告載入器委派
廣告載入器委派必須實作廣告類型專屬的通訊協定。
如果是原生廣告,GADNativeAdLoaderDelegate
通訊協定會包含訊息,在原生廣告載入時傳送至委派項目。
Swift
public func adLoader(_ adLoader: AdLoader,
didReceive nativeAd: NativeAd)
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader
didReceiveNativeAd:(GADNativeAd *)nativeAd;
請求廣告
初始化 GADAdLoader
後,請呼叫其 loadRequest:
方法來要求廣告:
Swift
adLoader.load(Request())
Objective-C
[self.adLoader loadRequest:[GADRequest request]];
GADAdLoader
中的 loadRequest:
方法接受與橫幅和插頁式廣告相同的 GADRequest
物件。您可以像使用其他廣告類型一樣,使用要求物件新增指定目標資訊。
載入多則廣告 (選用)
如要在單一要求中載入多個廣告,請在初始化 GADAdLoader
時設定 GADMultipleAdsAdLoaderOptions
物件。
Swift
let multipleAdOptions = MultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5;
adLoader = AdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
// The UIViewController parameter is optional.
rootViewController: self,
adTypes: [ .native ],
options: [ multipleAdOptions ])
Objective-C
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 ]];
每個請求最多可傳回五則廣告,且 SDK 不保證會傳回所請求的確切廣告數量。
系統傳回的 Google 廣告都會彼此不同,但無法保證預訂廣告空間或第三方買家的廣告是獨一無二。
如果您使用中介服務,請勿使用 GADMultipleAdsAdLoaderOptions
類別,因為目前為已設定中介服務的廣告單元 ID 提出多個原生廣告的要求時,系統不會運作。
判斷載入作業何時完成
應用程式呼叫 loadRequest:
後,即可透過下列呼叫取得要求結果:
adLoader:didFailToReceiveAdWithError:
位於GADAdLoaderDelegate
adLoader:didReceiveNativeAd:
位於GADNativeAdLoaderDelegate
如果要求單一廣告,系統會對其中一個方法發出一次呼叫。
如果要求多個廣告,系統至少會對上述方法執行一次回呼,但不會超過要求的廣告數量上限。
此外,GADAdLoaderDelegate
也提供 adLoaderDidFinishLoading
回呼。這個委派方法表示廣告載入器已完成載入廣告,且不會再回報其他廣告或錯誤。以下範例說明如何一次載入多個原生廣告時使用這項功能:
Swift
class ViewController: UIViewController, NativeAdLoaderDelegate {
var adLoader: GADAdLoader!
override func viewDidLoad() {
super.viewDidLoad()
let multipleAdOptions = MultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5;
adLoader = AdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
// The UIViewController parameter is optional.
rootViewController: rootViewController,
adTypes: [ .native ],
options: [ multipleAdOptions ])
adLoader.delegate = self
adLoader.load(Request())
}
func adLoader(_ adLoader: AdLoader,
didReceive nativeAd: NativeAd) {
// A native ad has loaded, and can be displayed.
}
func adLoaderDidFinishLoading(_ adLoader: AdLoader) {
// The adLoader has finished loading ads, and a new request can be sent.
}
}
Objective-C
@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
處理失敗的要求
上述通訊協定會擴充 GADAdLoaderDelegate
通訊協定,後者定義廣告無法載入時傳送的訊息。
Swift
public func adLoader(_ adLoader: AdLoader,
didFailToReceiveAdWithError error: NSError)
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader
didFailToReceiveAdWithError:(NSError *)error;
接收原生廣告事件通知
如要接收與原生廣告互動相關的事件通知,請設定原生廣告的委派屬性:
Swift
nativeAd.delegate = self
Objective-C
nativeAd.delegate = self;
然後實作
GADNativeAdDelegate
,接收下列委派呼叫:
Swift
func nativeAdDidRecordImpression(_ nativeAd: NativeAd) {
// The native ad was shown.
}
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
// The native ad was clicked on.
}
func nativeAdWillPresentScreen(_ nativeAd: NativeAd) {
// The native ad will present a full screen view.
}
func nativeAdWillDismissScreen(_ nativeAd: NativeAd) {
// The native ad will dismiss a full screen view.
}
func nativeAdDidDismissScreen(_ nativeAd: NativeAd) {
// The native ad did dismiss a full screen view.
}
func nativeAdWillLeaveApplication(_ nativeAd: NativeAd) {
// 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.
}
最佳做法
載入廣告時,請遵守下列規則。
在清單中使用原生廣告的應用程式,應預先快取廣告清單。
預先快取廣告時,請清除快取,並在一小時後重新載入。
在
GADAdLoader
上,請勿再次呼叫loadRequest:
,直到先前的要求完成載入為止 (如adLoaderDidFinishLoading:
所示)。限制原生廣告快取,只快取必要的項目。舉例來說,預先快取時,只快取螢幕上立即顯示的廣告。原生廣告的記憶體用量很大,如果快取原生廣告而不加以銷毀,就會導致記憶體用量過高。
不再使用原生廣告時,請將其銷毀。
顯示廣告
載入廣告後,您只需要向使用者顯示廣告即可。 如要瞭解如何操作,請參閱原生進階指南。