本指南適用於想要透過 Flutter 應用程式營利的發布商。
將 Google Mobile Ads SDK 整合至 Flutter 應用程式後,您將完成顯示 Ad Manager 廣告並賺取收益的第一步。整合完成後,您可以選擇廣告格式來取得詳細的導入步驟。
Flutter 專用的 Google Mobile Ads SDK 目前支援載入及顯示橫幅廣告、插頁式廣告 (全螢幕)、原生廣告和獎勵廣告。
先備知識
- Flutter 1.22.0 以上版本
- Android
- Android Studio 3.2 以上版本
- 指定 Android API 級別 20 以上版本
- 將
compileSdkVersion
設為 28 以上
- iOS
- 最新版本的 Xcode (含已啟用的指令列工具)
匯入 Mobile Ads SDK
- 在 Flutter 專案中加入 Google Mobile Ads SDK for Flutter 外掛程式。
平台專屬設定
Android
更新 AndroidManifest.xml
AndroidManifest.xml
中必須包含 Ad Manager 應用程式 ID。
否則會導致應用程式啟動時異常終止。
新增名為 com.google.android.gms.ads.APPLICATION_ID
的 <meta-data>
標記,將 Ad Manager 應用程式 ID (在 Ad Manager UI 中識別) 新增至應用程式的 android/app/src/main/AndroidManifest.xml
檔案。您可以在 Ad Manager UI 中找到應用程式 ID。如果是 android:value
,請在引號中插入您自己的 Ad Manager 應用程式 ID,如下所示:
<manifest> <application> <!-- Sample 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
檔案中,新增包含 Ad Manager 應用程式 ID 字串值的 GADApplicationIdentifier
鍵 (可在 Ad Manager UI 中識別):
<key>GADApplicationIdentifier</key> <string>ca-app-pub-################~##########</string>
在 Dart 程式碼中初始化外掛程式時,您必須傳送相同的值。
如要進一步瞭解如何設定 Info.plist
以及設定應用程式 ID,請參閱 iOS 指南。
初始化 Mobile Ads SDK
載入廣告前,請呼叫 MobileAds.instance.initialize()
,讓應用程式初始化 Mobile Ads SDK,此 SDK 會初始化 SDK,並傳回在初始化完成 (或逾時後 30 秒) 後完成的 Future
。這項操作只需執行一次,最好在執行應用程式前操作。
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 現已匯入完成,您隨時可以導入廣告。Ad Manager 提供多種廣告格式,因此您可以選擇最適合應用程式使用者體驗的廣告格式。
橫幅廣告
顯示在裝置螢幕頂端或底部的矩形廣告。橫幅廣告會在使用者與應用程式互動時持續顯示在畫面上,並在一段時間後自動重新整理。如果你是行動廣告新手,建議從這裡著手。
插頁式
全螢幕廣告會覆蓋應用程式介面,直到使用者關閉為止。 最適合用在應用程式執行流程中的自然暫停點,例如遊戲關卡之間,或完成任務之後。
原生
可自訂廣告能融入應用程式的外觀與風格。廣告的顯示位置和位置都由您決定,因此版面配置與應用程式設計更加一致。
已獲得獎勵
這類廣告會在使用者觀看短片、與可試玩廣告及問卷調查互動時提供獎勵。有助於透過免費遊戲使用者營利。