在 iOS 應用程式中加入插頁廣告

Audience Network 可讓您運用 Facebook 廣告，將自己的 iOS 應用程式變成營利來源。插頁廣告是可在應用程式中顯示的全螢幕廣告。請根據本指南顯示此類廣告單位。或者，若您對其他類型的廣告單位感興趣，請參閱可用類型清單。

我們來一起執行以下插頁廣告版位。

步驟 1：載入並顯示插頁廣告檢視畫面

第 2 步：驗證展示及點擊記錄功能

第 3 步：廣告無法顯示時的除錯方式

第 4 步：測試廣告整合

步驟 1：載入並顯示插頁廣告檢視畫面

1. 在您根據 iOS 新手指南建立新專案後，上載 FBAudienceNetwork、宣告 ViewController 有執行 FBInterstitialAdDelegate 協定，並且為插頁廣告單位加入實例變數。
   SwiftObjective-C

   import UIKit
   import FBAudienceNetwork
   
   class ViewController: UIViewController, FBInterstitialAdDelegate {
     private var interstitialAd: FBInterstitialAd?
   }

   #import <UIKit/UIKit.h>
   @import FBAudienceNetwork;
   
   @interface ViewController : UIViewController <FBInterstitialAdDelegate>
   @property (nonatomic, strong) FBInterstitialAd *interstitialAd;
   @end


2. 接下來，在檢視畫面控制器的 viewDidLoad 方法中將廣告物件實例化，並且執行 interstitialAdDidLoad。
   SwiftObjective-C

   override func viewDidLoad() {
     super.viewDidLoad()
   
     // Instantiate an InterstitialAd object.
     // NOTE: the placement ID will eventually identify this as your app. You can ignore it while you are testing
     // and replace it later when you have signed up.
     // While you are using this temporary code you will only get test ads and if you release
     // your code like this to the App Store your users will not receive ads (you will get a 'No Fill' error).
     let interstitialAd = FBInterstitialAd(placementID: "YOUR_PLACEMENT_ID")
     interstitialAd.delegate = self
   
     // For auto play video ads, it's recommended to load the ad at least 30 seconds before it is shown
     interstitialAd.load()
     
     self.interstitialAd = interstitialAd
   }
   
   func interstitialAdDidLoad(_ interstitialAd: FBInterstitialAd) {
     guard interstitialAd.isAdValid else {
       return
     }
     print("Ad is loaded and ready to be displayed")
     interstitialAd.show(fromRootViewController: self)
   }

   - (void)viewDidLoad 
   {
     [super viewDidLoad];
   
     // Instantiate an InterstitialAd object. 
     // NOTE: the placement ID will eventually identify this as your app. You can ignore it while you are testing 
     // and replace it later when you have signed up.
     // While you are using this temporary code you will only get test ads and if you release
     // your code like this to the App Store your users will not receive ads (you will get a 'No Fill' error).
     self.interstitialAd = [[FBInterstitialAd alloc] initWithPlacementID:@"YOUR_PLACEMENT_ID"];
   
     self.interstitialAd.delegate = self;
   
     // For auto play video ads, it's recommended to load the ad at least 30 seconds before it is shown
     [self.interstitialAd loadAd];
   }
   
   - (void)interstitialAdDidLoad:(FBInterstitialAd *)interstitialAd
   {
     NSLog(@"Ad is loaded and ready to be displayed");
   
     if (interstitialAd && interstitialAd.isAdValid) {
       // You can now display the full screen ad using this code:
       [interstitialAd showAdFromRootViewController:self];
     }
   }
   
   

3. 在 YOUR_PLACEMENT_ID 顯示的編號為臨時編號，僅作測試之用。

   若您在實時代碼中使用此臨時編號，用戶將不會收到廣告（而是收到未供應廣告錯誤）。您必須在測試後返回此處，並將此臨時編號替換為實時版位編號。

   請參考 Audience Network 設定，了解產生實時版位編號的方法。

   選擇目標組建作為裝置，然後執行上方的程式碼，您應該就會看到類似以下的內容：
   
   

第 2 步：驗證展示及點擊記錄功能

您也可以選擇新增以下函數，以處理廣告顯示或用戶點擊或關閉廣告的情況。

func interstitialAdWillLogImpression(_ interstitialAd: FBInterstitialAd) {
  print("The user sees the ad")
  // Use this function as indication for a user's impression on the ad.
}

func interstitialAdDidClick(_ interstitialAd: FBInterstitialAd) {
  print("The user clicked on the ad and will be taken to its destination")
  // Use this function as indication for a user's click on the ad.
}

func interstitialAdWillClose(_ interstitialAd: FBInterstitialAd) {
  print("The user clicked on the close button, the ad is just about to close")
  // Consider to add code here to resume your app's flow
}

func interstitialAdDidClose(_ interstitialAd: FBInterstitialAd) {
  print("The user clicked on the close button, the ad is just about to close")
  // Consider to add code here to resume your app's flow
}

- (void)interstitialAdWillLogImpression:(FBInterstitialAd *)interstitialAd 
{
  NSLog(@"The user sees the ad");
  // Use this function as indication for a user's impression on the ad.
}

- (void)interstitialAdDidClick:(FBInterstitialAd *)interstitialAd
{
  NSLog(@"The user clicked on the ad and will be taken to its destination");
  // Use this function as indication for a user's click on the ad.
}

- (void)interstitialAdWillClose:(FBInterstitialAd *)interstitialAd
{
  NSLog(@"The user clicked on the close button, the ad is just about to close");
  // Consider to add code here to resume your app's flow
}

- (void)interstitialAdDidClose:(FBInterstitialAd *)interstitialAd
{
  NSLog(@"Interstitial had been closed");
  // Consider to add code here to resume your app's flow
}

第 3 步：廣告無法顯示時的除錯方式

在您的檢視畫面控制器執行檔案中新增並執行下列函數，以處理廣告載入錯誤。

func interstitialAd(_ interstitialAd: FBInterstitialAd, didFailWithError error: Error) {
  print("Interstitial ad failed to load with error: \(error.localizedDescription)")
}

- (void)interstitialAd:(FBInterstitialAd *)interstitialAd didFailWithError:(NSError *)error
{
  NSLog(@"Interstitial ad failed to load with error: %@", error);
}