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

開始使用

本指南適用於想透過 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 Flutter 中的外掛程式專案。

平台專屬設定

Android

更新 AndroidManifest.xml

AdMob 應用程式 ID 必須包含在AndroidManifest.xml中。失敗否則會導致應用程式啟動時異常終止。

加入 AdMob 網頁中找出的 AdMob 應用程式 ID 介面連往應用程式的將 android/app/src/main/AndroidManifest.xml 檔案新增到 <meta-data> 標記名為 com.google.android.gms.ads.APPLICATION_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。

請參閱 Android 指南關於設定 AndroidManifest.xml 及設定應用程式的資訊編號。

iOS

更新 Info.plist

在應用程式的 ios/Runner/Info.plist 檔案中新增 GADApplicationIdentifier 這個字串是 AdMob 應用程式 ID 的字串值，如 AdMob 網頁所示介面：

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

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

詳情請參閱 iOS 指南。瞭解如何設定 Info.plist 及應用程式 ID。

初始化 Mobile Ads SDK

載入廣告前，請呼叫應用程式，以便呼叫 MobileAds.instance.initialize()，會初始化 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.
  }
}