接入 AdMob Banner 的步驟其實不多,多數時間花在處理 framework 依賴與編譯設定上。以下是最精簡的流程。
AdMob 依賴多個系統 framework,缺少任何一個都會在連結階段失敗:
· CoreMedia
· CoreTelephony
· AudioToolbox
· MediaPlayer
· MessageUI
· StoreKit
· EventKitUI
· EventKit
· AdSupport
· SystemConfiguration
· QuartzCore
· CFNetwork
· Security
· libz / libsqlite3
AdSupport 特別提醒:這個庫與 IDFA(廣告識別碼)相關,在 App Store 提交時必須於「Advertising Identifier」欄位如實回答是否使用 IDFA。填寫不正確會導致審核被拒甚至下架,這是最常見的退審原因之一,務必與法務/產品確認後再勾選。
把下載的 Google Mobile Ads SDK 加入專案,建議使用 CocoaPods 管理,可避免手動處理依賴:
pod 'Google-Mobile-Ads-SDK'
#import "GADBannerView.h" @interface MyViewController () <GADBannerViewDelegate> @property (nonatomic, strong) GADBannerView *bannerView; @end
self.bannerView = [[GADBannerView alloc]
initWithFrame:CGRectMake(0,
self.view.frame.size.height - 50,
GAD_SIZE_320x50.width,
GAD_SIZE_320x50.height)];
// 換成你在 AdMob 後台建立的廣告單元 ID
self.bannerView.adUnitID = @"ca-app-pub-XXXXXXXXXXXXXXXX/XXXXXXXXXX";
self.bannerView.rootViewController = self;
self.bannerView.delegate = self;
[self.view addSubview:self.bannerView];
GADRequest *request = [GADRequest request];
// 若為測試環境,請加入測試裝置 ID,避免測試時產生無效曝光
request.testDevices = @[kGADSimulatorID];
[self.bannerView loadRequest:request];
在 Build Settings 中找到 Other Linker Flags,加入 -ObjC。這一步是必要的,因為 SDK 中的 Objective-C 類別與 category 若沒有這個旗標,會在執行期出現 unrecognized selector 而崩潰。
執行後應在畫面底部看到測試廣告。若出現空白,優先檢查兩件事:adUnitID 是否正確、以及網路是否可用。
1. 測試廣告與正式廣告務必分開。用自己的正式 adUnitID 做測試會被判定為無效曝光(invalid traffic),情節嚴重者帳號會被停權。開發階段請一律使用測試 ID 或加入 testDevices。
2. 使用 GADBannerViewDelegate 掌握狀態。實作下面幾個方法,才能知道廣告是真的曝光還是靜默失敗:
- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
NSLog(@"廣告載入成功");
}
- (void)bannerView:(GADBannerView *)bannerView
didFailToReceiveAdWithError:(NSError *)error {
NSLog(@"廣告載入失敗:%@", error.localizedDescription);
}
常見的失敗碼包括 kGADAdErrorNoFill(暫無可投放廣告)與網路錯誤,前者屬正常現象,可考慮退避重試。
3. 骨架佔位避免版面跳動。廣告非同步載入,若在成功後才插入視圖,會造成 UI 跳動。建議先配置固定高度的容器,再於 bannerViewDidReceiveAd: 中顯示。
4. App Transport Security。若使用舊版 SDK 或廣告來源含 HTTP 內容,需在 Info.plist 設定 ATS 例外,否則請求會被系統阻擋。
5. 隱私合規。歐盟地區需實作 UMP 同意管理(Consent Mode / GDPR),美國部分州亦需處理。這不只是技術問題,也是上架的強制要求;此外,App Store 的隱私營養標籤需如實揭露廣告相關的資料蒐集行為。
6. 兒童導向應用。若 App 主要對象為 13 歲以下兒童,必須遵守 Families 政策並停用個人化廣告,設定方式與一般 Banner 不同,請務必先查閱官方最新文件。