在您的 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。
注意：將適用於 Google Analytics 的 Firebase SDK 添加到您的應用是可選的，但強烈建議您這樣做。詳細了解添加適用於 Google Analytics 的 Firebase SDK 的優勢。

第 1 步：在 AdMob 帳戶中設置您的應用

將您的應用註冊為 AdMob 應用。
1. 登錄或註冊AdMob 帳戶。
2. 向 AdMob 註冊您的應用。此步驟將創建一個帶有唯一AdMob 應用 ID 的AdMob 應用，您將在本指南的後面部分用到該 ID。
系統會要求您將移動廣告 SDK 添加到您的應用中。在本指南的後面部分中查找有關此任務的詳細說明。
將您的 AdMob 應用鏈接到您的 Firebase 應用。
此步驟是可選的，但強烈建議這樣做。詳細了解啟用用戶指標並將 AdMob 應用關聯到 Firebase 的好處。
在 AdMob 帳戶的應用信息中心中完成以下兩個步驟：
1. 啟用用戶指標以允許 AdMob 處理並顯示您 AdMob 帳戶中的精選分析數據。這也是將 AdMob 應用鏈接到 Firebase 所必需的設置。
2. 將您的 AdMob 應用鏈接到現有的 Firebase 項目和 Firebase 應用。
  確保您輸入的捆綁包 ID 與您為 Firebase 應用輸入的捆綁包 ID 相同。在 >項目設置的您的應用卡中找到您的 Firebase 應用的捆綁包 ID。

第 2 步：將您的 AdMob 應用 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：添加並初始化移動廣告 SDK

將 Google 移動廣告 SDK 的依賴項添加到項目的 Podfile 中：
```
pod 'Google-Mobile-Ads-SDK'
```
加載廣告之前，請調用GADMobileAds.sharedInstance上的startWithCompletionHandler:方法。
此調用會初始化 SDK，並在初始化完成後（或 30 秒超時後）回調完成處理程序。僅調用此方法一次並儘早調用，最好是在應用程序啟動時但在初始化 Firebase 之後。
警告：移動廣告 SDK 或中介合作夥伴 SDK 可能會在調用startWithCompletionHandler:時預加載廣告。如果您需要在加載廣告之前執行任何操作，請確保在初始化移動廣告 SDK 之前執行此操作。以下是初始化之前可能需要執行的一些操作示例：
- 獲得歐洲經濟區 (EEA) 用戶的同意
- 設置任何特定於請求的標誌（例如tagForChildDirectedTreatment或tag_for_under_age_of_consent ）
請參閱AdMob 文檔了解更多信息。
以下是如何在AppDelegate中調用startWithCompletionHandler:方法的示例：
迅速
```
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 步：查看用戶指標和分析數據

初始化後，移動廣告 SDK 會自動開始記錄應用程序中的分析事件和用戶屬性。您無需向應用添加任何額外代碼或實施任何廣告即可查看此數據。您可以在此處查看此分析數據：

在 AdMob 帳戶的用戶指標卡（主頁或應用程序信息中心）中，您可以查看從收集的分析數據中得出的精選用戶指標，例如平均會話持續時間、 ARPU和保留率。
在 Firebase 控制台的Analytics儀表板中，您可以查看關鍵指標的聚合統計數據和摘要。如果您添加適用於 Google Analytics 的 Firebase SDK ，您還可以在 Firebase 控制台中標記廣告系列的轉化並構建自定義受眾群體。

請注意，為了更好地表示ARPU和ARPPU指標，您可能希望在這些指標的收入計算中包含來自名為ecommerce_purchase的分析自定義事件的數據（了解操作方法）。

第 5 步：（可選）使用 Google Analytics 和 Firebase 的更多功能

利用更多機會和功能來提高應用貨幣化和用戶參與度：

添加並使用適用於 Google Analytics 的 Firebase SDK
- 在您的應用程序中實現自定義事件日誌記錄。
- 標記自定義廣告活動的轉化。
- 在ARPU和ARPPU指標的收入計算中包含ecommerce_purchase事件數據。
要了解更多信息，請訪問將Google Analytics 和 Firebase 與 AdMob 應用結合使用的指南。
在您的應用中使用其他 Firebase 產品
添加適用於 Google Analytics 的 Firebase SDK 後，可以使用其他 Firebase 產品來優化應用中的廣告。
- 遠程配置使您能夠更改應用程序的行為和外觀，而無需為無限的每日活躍用戶免費發布應用程序更新。
- A/B 測試使您能夠測試應用程序 UI、功能或參與活動的更改，以了解它們是否對您的關鍵指標（例如收入和保留率）產生影響，然後再廣泛推廣更改。