在 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 帳戶中設定應用程式

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。

重要事項： 自 Google Mobile Ads SDK 7.42.0 起，您必須執行這個步驟。如果您未新增這個 Info.plist 項目，應用程式會當機並顯示以下訊息："The Google Mobile Ads SDK was initialized incorrectly."

您可以透過程式設計進行此變更：

<!-- 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 之後。

   警告：在呼叫 startWithCompletionHandler: 時，Mobile Ads SDK 或中介服務合作夥伴 SDK 可能會預先載入廣告。如果您需要在載入廣告前採取任何動作，請務必在初始化 Mobile Ads SDK 之前完成。以下列舉一些可能需要在初始化前執行的動作：

   • 取得歐洲經濟區 (EEA) 使用者的同意聲明
   • 設定任何要求專屬的標記 (例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent)

   詳情請參閱 AdMob 說明文件。

   以下範例說明如何在 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 就會自動開始記錄應用程式中的數據分析事件和使用者屬性。您無須在應用程式中新增任何額外程式碼或導入廣告，即可查看這類資料。您可以透過下列方式查看這些數據分析資料：

• 在 AdMob 帳戶的「使用者指標」資訊卡 (首頁或「應用程式」資訊主頁) 中，您可以查看從收集到的分析資料衍生而來的使用者指標，例如平均工作階段時間、ARPU 和回訪率。

• 在 Firebase 主控台的 Analytics 資訊主頁中，您可以查看匯總統計資料和重點指標摘要。如果您為 Google Analytics 新增 Firebase SDK，也可以在 Firebase 控制台標示廣告活動的轉換，並建立自訂目標對象。

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

資料通常會在一小時內顯示，最長可能要 48 小時。

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

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

• 為 Google Analytics 新增及使用 Firebase SDK

  • 在應用程式中實作自訂事件記錄功能。

  • 為自訂廣告活動標示轉換。

  • 在ARPU 和 ARPPU 指標的收益計算中納入 ecommerce_purchase 事件資料。

  如需更多資訊，請參閱搭配 AdMob 應用程式使用 Google Analytics 和 Firebase 的指南。

• 在應用程式中使用其他 Firebase 產品

  新增 Google Analytics 專用 Firebase SDK 後，請使用其他 Firebase 產品來改善應用程式中的廣告。

  • Remote Config 可讓您免費變更應用程式的行為和外觀，且無須發布應用程式更新，並可讓無限數量的每日活躍使用者存取。

  • A/B Testing 可讓您測試對應用程式使用者介面、功能或參與度廣告活動所做的變更，以在廣泛實作之前，瞭解變更是否確實能對關鍵指標 (例如收益和留存率) 發揮效用。

• 提升應用程式的廣告營利成效

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

  • 測試採用新的廣告格式 (總覽 | 導入)。

  • 最佳化廣告放送頻率 (總覽 | 導入)。

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

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

橫幅

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

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

導入橫幅廣告

插頁式

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

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

導入插頁式廣告

原生

可自訂的廣告，符合應用程式外觀和風格

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

導入原生進階廣告

獎勵廣告

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

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

導入獎勵廣告

導入獎勵廣告 (新版 API)