在 iOS 專案中開始使用 AdMob

本快速入門指南適用於想使用 AdMob 為採用 Firebase 建構的應用程式創造收益的發布商和開發人員。如果您不打算在應用程式中加入 Firebase，請改為參閱 獨立 AdMob 指南。

如果您尚未使用 AdMob、Firebase 和 Google Analytics 搭配使用，請參閱這篇文章，瞭解相關的所有優點。

事前準備

  • 如果您還沒有 Firebase 專案和 Firebase 應用程式，請按照 Firebase 入門指南操作：將 Firebase 新增至 iOS 專案。

  • 確認已在 Firebase 專案中啟用 Google Analytics：

    • 如果您要建立新的 Firebase 專案，請在專案建立工作流程中啟用 Google Analytics。

    • 如果您現有的 Firebase 專案未啟用 Google Analytics，可以前往 >「專案設定」的「整合」分頁標籤啟用 Google Analytics。

步驟 1：在 AdMob 帳戶中設定應用程式

  1. 將應用程式註冊為 AdMob 應用程式。

    1. 登入或註冊 AdMob 帳戶。

    2. 使用 AdMob 註冊應用程式。這個步驟會建立 AdMob 應用程式，並提供您稍後在本指南中需要的專屬 AdMob 應用程式 ID。

    系統會要求您將 Mobile Ads SDK 新增至應用程式。請參閱本指南稍後的部分，瞭解這項工作的詳細操作說明。

  2. 將 AdMob 應用程式連結至 Firebase 應用程式。

    這是選用步驟，但強烈建議執行。進一步瞭解啟用使用者指標和將 AdMob 應用程式連結至 Firebase 的優點。

    在 AdMob 帳戶的「應用程式」資訊主頁中完成下列兩個步驟：

    1. 啟用使用者指標，讓 AdMob 在您的 AdMob 帳戶中處理及顯示精選的數據分析資料。您也必須設定此選項，才能將 AdMob 應用程式連結至 Firebase。

    2. 將 AdMob 應用程式連結至現有的 Firebase 專案和 Firebase 應用程式。

      請務必輸入與 Firebase 應用程式相同的軟體包 ID。您可以在 > 專案設定 的「您的應用程式」資訊卡中找到 Firebase 應用程式的軟體包 ID。

步驟 2：將 AdMob App ID 新增至 Info.plist 檔案

在應用程式的 Info.plist 檔案中，新增 GADApplicationIdentifier 索引鍵，並將字串值設為 AdMob 應用程式 ID。

您可以透過程式輔助方式進行此變更：

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

或者，您也可以在屬性清單編輯器中編輯：

屬性清單編輯器

步驟 3：新增及初始化 Mobile Ads SDK

  1. 將 Google Mobile Ads SDK 的依附元件新增至專案的 Podfile：

    pod 'Google-Mobile-Ads-SDK'

  2. 在載入廣告之前，請對 GADMobileAds.sharedInstance 呼叫 startWithCompletionHandler: 方法。

    這個呼叫會初始化 SDK，並在初始化完成後 (或 30 秒逾時後) 回呼完成處理常式。請盡可能提早呼叫這個方法一次，理想情況是在應用程式啟動時，但在初始化 Firebase 之後。

    以下範例說明如何在 AppDelegate 中呼叫 startWithCompletionHandler: 方法：

    Swift

    import Firebase
import GoogleMobileAds
...

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    // Use Firebase library to configure APIs.
    FirebaseApp.configure()

    // Initialize the Google Mobile Ads SDK.
    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }

}

    Objective-C

    @import Firebase;
@import GoogleMobileAds;
...

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Use Firebase library to configure APIs.
  [FIRApp configure];
  // Initialize the Google Mobile Ads SDK.
  [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
  return YES;
}

@end

步驟 4：查看使用者指標和數據分析資料

初始化完成後，Mobile Ads SDK 就會自動開始記錄應用程式中的數據分析事件和使用者屬性。您無須在應用程式中新增任何額外程式碼或導入廣告，即可查看這類資料。您可以透過下列方式查看這些數據分析資料：

請注意，為更準確呈現ARPU 和 ARPPU 指標，您可能需要在這些指標的收益計算中納入名為 ecommerce_purchase 的 Analytics 自訂事件資料 (瞭解如何操作)。

步驟 5： (選用) 使用 Google Analytics 和 Firebase 的更多功能

善用更多商機和功能，提升應用程式營利成效和使用者參與度：

  • 最佳化應用程式的廣告營利

    請向一小部分使用者試用不同的廣告格式或設定，然後根據資料做出決定，決定是否為所有使用者導入廣告。如要進一步瞭解，請參閱下列教學課程：

步驟 6：選擇要在應用程式中導入的廣告格式

AdMob 提供多種不同的廣告格式，方便您選擇最適合應用程式使用者體驗的格式。按一下廣告格式的按鈕，即可在 AdMob 說明文件中查看詳細的導入操作說明。

這類矩形廣告會顯示在裝置畫面頂端或底部

使用者與應用程式互動時，橫幅廣告會停留在畫面上，且經過一段時間後會自動重新整理。如果您是行動廣告新手，不妨從這裡開始。

導入橫幅廣告

插頁式

全螢幕廣告會覆蓋應用程式的介面，直到使用者關閉為止

插頁式廣告最適合用於應用程式執行流程中的自然暫停點，例如遊戲關卡之間，或任務完成後。

導入插頁式廣告

原生

配合應用程式外觀和風格自訂廣告

原生廣告是以元件為基礎的廣告格式。您可以決定原生廣告的顯示方式和位置，讓版面配置與應用程式設計更加一致。您可以自行選擇字型、顏色和其他詳細資料，打造自然不顯眼的廣告呈現方式，為使用者帶來更豐富的體驗。

導入原生進階廣告

獎勵廣告

在使用者看完短片、與可試玩廣告及問卷調查互動後提供獎勵的廣告

獎勵廣告 (或稱「獎勵制廣告」) 可協助您透過免費遊戲玩家營利。

導入獎勵廣告 導入獎勵廣告 (新版 API)