此页面由 Cloud Translation API 翻译。

开始使用

本指南面向希望通过 Flutter 应用进行创收的发布商。

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

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

前提条件

Flutter 1.22.0 或更高版本
Android
- Android Studio 3.2 或更高版本
- 以 Android API 级别 20 或更高级别为目标平台
- 将 compileSdkVersion 设置为 28 或更高版本
iOS
- 安装有命令行工具（且已启用）的最新版 Xcode

导入移动广告 SDK

在您的 Flutter 项目中添加 Google 移动广告 SDK 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（可在 Ad Manager 界面中找到）的 GADApplicationIdentifier 键：

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