開始使用

本指南的適用對象為想利用 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

AdMob 應用程式 ID 必須納入 AndroidManifest.xml。否則應用程式啟動會異常終止。

新增名為 com.google.android.gms.ads.APPLICATION_ID 的 <meta-data> 標記，藉此將 AdMob 應用程式 ID (在 AdMob UI 中識別) 加進應用程式的 android/app/src/main/AndroidManifest.xml 檔案。您可以在 AdMob UI 中找到應用程式 ID。針對 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。

如要進一步瞭解如何設定 AndroidManifest.xml 及設定應用程式 ID，請參閱 Android 指南。

iOS

更新 Info.plist

在應用程式的 ios/Runner/Info.plist 檔案中，加入一個內含 AdMob 應用程式 ID (在 AdMob UI 中) 的字串值：GADApplicationIdentifier

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>

在 Dart 程式碼中初始化外掛程式時，您必須傳遞相同的值。

如要進一步瞭解如何設定 Info.plist 及設定應用程式 ID，請參閱 iOS 指南。

初始化 Mobile Ads SDK

載入廣告之前，請呼叫 MobileAds.instance.initialize() (初始化 SDK) 並傳回結束 (或在初始化完成後 30 秒) 後結束的 Future，藉此初始化 Mobile Ads SDK。這個步驟只需要執行一次，最好是執行應用程式前。

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.
  }
}