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

開始使用

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

平台專屬設定

Android

更新 AndroidManifest.xml

必須在 AndroidManifest.xml 中加入 Ad Manager 應用程式 ID。否則會導致應用程式啟動時異常終止。

新增 Ad Manager 應用程式 ID (從廣告中找到的資訊) Manager UI)) 移至應用程式的 android/app/src/main/AndroidManifest.xml 檔案，方法是新增含有名稱為 <meta-data> 的標記 com.google.android.gms.ads.APPLICATION_ID。您可以在在 Ad Manager UI 中顯示 ID若是「android:value」，請插入自己的廣告引號中的管理員應用程式 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 字串值的 GADApplicationIdentifier 鍵應用程式 ID (識別 Ad Manager UI)：

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

當您在 Dart 中初始化外掛程式時，必須傳送相同的值再也不是件繁重乏味的工作

請參閱 iOS 指南進一步瞭解如何設定 Info.plist 與應用程式編號。

初始化 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.
  }
}