在您的 iOS 項目中開始使用 AdMob

本快速入門指南適用於希望使用 AdMob 通過使用 Firebase 構建的應用獲利的發布商和開發人員。如果您不打算在您的應用中包含 Firebase，請訪問獨立的 AdMob 指南。

如果您還沒有，請了解結合使用 AdMob、Firebase 和 Google Analytics 的所有優勢。

在你開始之前

如果您還沒有 Firebase 項目和 Firebase 應用程序，請遵循 Firebase 入門指南：將 Firebase 添加到您的 iOS 項目。
確保在您的 Firebase 項目中啟用了 Google Analytics：
- 如果您要創建新的 Firebase 項目，請在項目創建工作流程中啟用 Google Analytics。
- 如果您有一個未啟用 Google Analytics 的現有 Firebase 項目，您可以從您的 >項目設置的Integrations選項卡中啟用 Google Analytics。
注意：將適用於 Google Analytics 的 Firebase SDK 添加到您的應用程序是可選的，但強烈建議您這樣做。詳細了解為 Google Analytics 添加 Firebase SDK 的好處。

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

將您的應用程序註冊為 AdMob 應用程序。
1. 登錄或註冊AdMob 帳戶。
2. 向 AdMob 註冊您的應用程序。此步驟會創建一個具有唯一AdMob 應用程序 ID的 AdMob 應用程序，您將在本指南的後面部分用到它。
系統會要求您將移動廣告 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 App 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
  }

}

目標-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 產品優化應用中的廣告。
- Remote Config使您能夠更改應用程序的行為和外觀，而無需為無限制的每日活躍用戶免費發布應用程序更新。
- A/B 測試使您能夠測試對應用的 UI、功能或參與活動的更改，以了解它們是否會對您的關鍵指標（如收入和保留率）產生影響，然後再廣泛推廣這些更改。