將 Google Mobile Ads SDK 整合至 Flutter 應用程式,是顯示廣告及賺取收益的第一步。整合 SDK 後,您就可以繼續導入一或多種支援的廣告格式。
必要條件
- Flutter 3.27.0 以上版本
- Android
- 最新版 Android Studio
- iOS
- 最新版 Xcode (已啟用指令列工具)
匯入 Mobile Ads SDK
- 在 Flutter 專案中加入 Google Mobile Ads SDK for Flutter 外掛程式。
平台專屬設定
Android
更新 AndroidManifest.xml
AndroidManifest.xml
中必須包含 AdMob 應用程式 ID。否則會導致應用程式啟動時當機。
將 AdMob 應用程式 ID (顯示於 AdMob 網頁介面) 加入應用程式的 android/app/src/main/AndroidManifest.xml
檔案,方法是加入名稱為 com.google.android.gms.ads.APPLICATION_ID
的 <meta-data>
標記。在 android:value
中插入自己的應用程式 ID,並以半形引號括住,如下所示:
<manifest>
<application>
<!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
<meta-data
android:name="com.google.android.gms.ads.APPLICATION_ID"
android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
<application>
<manifest>
在 Dart 程式碼中初始化外掛程式時,請使用相同的 value
。
如要進一步瞭解如何設定 AndroidManifest.xml
和應用程式 ID,請參閱 Android 指南。
iOS
更新 Info.plist
在應用程式的 ios/Runner/Info.plist
檔案中,新增 GADApplicationIdentifier
索引鍵,並將 AdMob 應用程式 ID 的字串值設為該索引鍵,如AdMob 網頁介面所示:
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>
您必須在 Dart 程式碼中初始化外掛程式時傳遞相同的值。
如要進一步瞭解如何設定 Info.plist
和應用程式 ID,請參閱 iOS 指南。
初始化 Mobile Ads SDK
在載入廣告之前,請透過呼叫 MobileAds.instance.initialize()
讓應用程式初始化 Mobile Ads SDK,這會初始化 SDK,並在初始化完成或 30 秒逾時後傳回 Future
。盡快呼叫 initialize()
。
// Initialize the Mobile Ads SDK.
MobileAds.instance.initialize();
選取廣告格式
匯入 Mobile Ads SDK 後,即可導入廣告。AdMob 提供多種不同的廣告格式,您可以選擇最適合應用程式使用者體驗的格式。
橫幅廣告
這類矩形廣告會顯示在裝置畫面頂端或底部。使用者與應用程式互動時,橫幅廣告會停留在畫面上,且經過一段時間後會自動重新整理。如果您是行動廣告新手,不妨從這裡開始。
插頁式
全螢幕廣告會覆蓋應用程式的介面,直到使用者關閉為止。插頁式廣告最適合用於應用程式執行流程中的自然暫停時間,例如遊戲關卡之間或完成任務後。
原生
這類可自訂廣告能完美融入應用程式的設計與內容。廣告出現的方式和位置都由您決定,因此能讓廣告和應用程式設計的版面配置更加協調。
已獲得獎勵
在使用者看完短片、與可試玩廣告及問卷調查互動後提供獎勵的廣告。適合用來透過免付費玩遊戲的使用者營利。