本頁面由 Cloud Translation API 翻譯而成。

開始使用
透過集合功能整理內容你可以依據偏好儲存及分類內容。

選取平台： Android iOS Unity Flutter

將 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，並傳回 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.
  }
}