本指南適用於想透過 Flutter 應用程式營利的發布商。
將 Google Mobile Ads SDK 整合至 Flutter 應用程式 (您將在本節中進行這項操作),是顯示 AdMob 廣告並賺取收益的第一步。整合完成後,您可以選擇廣告格式來取得詳細的導入步驟。
Flutter 專用的 Google Mobile Ads SDK 目前支援載入及顯示橫幅廣告、插頁式廣告 (全螢幕)、原生廣告和獎勵廣告。
必要條件
- Flutter 1.22.0 以上版本
- Android
- Android Studio 3.2 以上版本
- 指定 Android API 級別 20 以上版本
- 將
compileSdkVersion
設為 28 以上
- iOS
- 最新版 Xcode (已啟用指令列工具)
- 建議做法:建立 AdMob 帳戶並註冊 Android 和/或 iOS 應用程式
匯入 Mobile Ads SDK
- 在 Flutter 專案中加入 Google Mobile Ads SDK for Flutter 外掛程式。
平台專屬設定
Android
更新 AndroidManifest.xml
AndroidManifest.xml
中必須包含 AdMob 應用程式 ID。否則會導致應用程式在啟動時異常終止。
在 AdMob 網頁介面中找到 AdMob 應用程式 ID,然後加入名稱為 com.google.android.gms.ads.APPLICATION_ID
的 <meta-data>
標記,將該 ID 新增至應用程式的 android/app/src/main/AndroidManifest.xml
檔案。如果是 android:value
,請插入您的 AdMob 應用程式 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
。
請參閱 Android 指南,進一步瞭解如何設定 AndroidManifest.xml
及設定應用程式 ID。
iOS
更新 Info.plist
在應用程式的 ios/Runner/Info.plist
檔案中,新增含有 AdMob 應用程式 ID 字串值的 GADApplicationIdentifier
鍵,如 AdMob 網頁介面中辨識所示:
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>
您必須在 Dart 程式碼中初始化外掛程式時傳遞相同的值。
如要進一步瞭解如何設定 Info.plist
和應用程式 ID,請參閱 iOS 指南。
初始化 Mobile Ads SDK
在載入廣告之前,請讓應用程式透過呼叫 MobileAds.instance.initialize()
初始化 Mobile Ads SDK,這會初始化 SDK,並傳回 Future
,該函式會在初始化完成後或 30 秒逾時後結束。這項操作只需執行一次,最好在執行應用程式前操作。
import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize();
runApp(MyApp());
}
class MyApp extends StatefulWidget {
@override
MyAppState createState() => MyAppState();
}
class MyAppState extends State<MyApp> {
@override
void initState() {
super.initState();
// Load ads.
}
}
選取廣告格式
匯入 Mobile Ads SDK 後,即可導入廣告。AdMob 提供多種不同的廣告格式,方便您選擇最適合應用程式使用者體驗的廣告格式。
橫幅廣告
這類矩形廣告會顯示在裝置畫面頂端或底部。使用者與應用程式互動時,橫幅廣告會停留在螢幕上,且經過一段時間後會自動重新整理。如果您不熟悉行動廣告,不妨從這裡開始。
插頁式
全螢幕廣告會覆蓋應用程式的介面,直到使用者關閉為止。最適合用在應用程式執行流程中的自然暫停點,例如遊戲關卡之間,或完成任務之後。
原生
這類可自訂廣告能完美融入應用程式的設計與內容。廣告出現的方式和位置都由您決定,因此能讓廣告和應用程式設計的版面配置更加協調。
已獲得獎勵
在使用者看完短片、與可試玩廣告及問卷調查互動後提供獎勵的廣告。適合用來透過免付費玩遊戲的使用者營利,