开始使用

本指南适用于希望通过 Flutter 应用创收的发布商。

若要展示 Ad Manager 广告和赚取收入，第一步就是将 Google 移动广告 SDK 集成到 Flutter 应用中。集成完成后，您可以选择一种广告格式以获取详细的实现步骤。

Google 移动广告 SDK for Flutter 目前支持加载和展示横幅广告、插页式广告（全屏）、原生广告和激励广告。

前提条件

Flutter 1.22.0 或更高版本
Android
- Android Studio 3.2 或更高版本
- 以 Android API 级别 20 或更高级别为目标平台
- 将 compileSdkVersion 设为 28 或更高
iOS 设备
- 使用命令行工具的最新版 Xcode

导入移动广告 SDK

在 Flutter 项目中添加 Google 移动广告 SDK for Flutter 插件。

针对具体平台的设置

Android

更新AndroidManifest.xml

Ad Manager 应用 ID 必须包含在 AndroidManifest.xml 中。否则会导致应用崩溃。

通过添加名为 com.google.android.gms.ads.APPLICATION_ID 的 <meta-data> 标记，将 Ad Manager 应用 ID（可在 Ad Manager 界面中找到）添加到应用的 android/app/src/main/AndroidManifest.xml 文件中。您可以在 Ad Manager 界面中找到您的应用 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。

如需详细了解如何配置 AndroidManifest.xml 和设置应用 ID，请参阅 Android 指南。

iOS

更新您的 Info.plist

在应用的 ios/Runner/Info.plist 文件中，添加一个字符串值为您的 Ad Manager 应用 ID 的 GADApplicationIdentifier 键（可在 Ad Manager 界面中找到）：

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

在 Dart 代码中初始化插件时，必须传递相同的值。

如需详细了解如何配置 Info.plist 和设置应用 ID，请参阅 iOS 指南。

初始化移动广告 SDK

加载广告之前，请先调用 MobileAds.instance.initialize()，以便让应用初始化移动广告 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.
  }
}