原生廣告

原生廣告是透過平台原生的 UI 元件向使用者顯示的廣告素材資源。這些圖表會以您在分鏡腳本中使用的類別顯示,也可以根據應用程式的視覺設計調整格式。

原生廣告載入時,應用程式會收到包含素材資源的廣告物件和應用程式 (而非 Google Mobile Ads SDK),就會負責顯示這些廣告。

大致來說,成功導入原生廣告分為兩個部分:使用 SDK 載入廣告,然後在應用程式中顯示廣告素材。

本頁面說明如何使用 SDK 載入 原生廣告

必要條件

一律使用測試廣告進行測試

建構及測試應用程式時,請務必使用測試廣告,而非正式版廣告。

想要載入測試廣告,最簡單的方法是針對 iOS 上的原生廣告使用專屬的測試廣告單元 ID:

/6499/example/native

系統已針對每項請求傳回測試廣告,而您可以將廣告用於自己的應用程式,同時對編寫、測試及偵錯時使用。但請注意,請務必先替換成自己的廣告單元 ID,再發布應用程式。

如要進一步瞭解 Google Mobile Ads SDK 測試廣告的運作方式,請參閱「測試廣告」一文。

載入廣告

原生廣告會透過 GADAdLoader 類別載入,這個類別會根據 GADAdLoaderDelegate 通訊協定,將訊息傳送給委派代表。

除了系統定義的原生格式之外,您也可以建立自己的自訂原生廣告格式,以供直接銷售的原生廣告使用。自訂原生廣告格式可讓您將任意結構化資料傳送至應用程式,這些廣告是以 GADCustomNativeAd 類別表示。

初始化廣告載入器

您必須先初始化廣告載入器,才能載入廣告。以下程式碼示範如何初始化 GADAdLoader

Swift

adLoader = GADAdLoader(adUnitID: "/6499/example/native",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/6499/example/native"
    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: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

Objective-C

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

GADCustomNativeAdLoaderDelegate 通訊協定包含一則訊息,系統會在載入自訂範本廣告時傳送給委派代表。

Swift

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

Objective-C

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

請求廣告

GADAdLoader 初始化後,請呼叫其 loadRequest: 方法來請求廣告:

Swift

adLoader.load(GAMRequest())

Objective-C

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

GADAdLoader 中的 loadRequest: 方法接受與橫幅廣告和插頁式廣告相同的 GAMRequest 物件。您可以使用要求物件來新增指定目標資訊,就像其他廣告類型一樣。

正在判斷載入完成的時間

應用程式呼叫 loadRequest: 後,可以利用呼叫以下功能取得要求的結果:

收到單一廣告的要求時,系統會對上述其中一種方法發出一次呼叫。

處理失敗的要求

上述通訊協定會擴充 GADAdLoaderDelegate 通訊協定,定義廣告無法載入時所傳送的訊息。

Swift

public func adLoader(_ adLoader: GADAdLoader,
    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: 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.
}

最佳做法

載入廣告時,請遵守這些規則。

  • 如果應用程式在清單中使用原生廣告,則應預先快取廣告清單。

  • 預先快取廣告時,請清除快取,並在一小時後重新載入。

  • 除非先前的要求完成載入,否則請勿在 GADAdLoader 上再次呼叫 loadRequest:,如 adLoaderDidFinishLoading: 所示。

顯示廣告

廣告載入完畢後,剩下的就是向使用者顯示廣告。 操作方法請參閱原生進階指南