此页面由 Cloud Translation API 翻译。

开始使用

本指南适用于希望通过 Flutter 应用。

将 Google 移动广告 SDK 集成到 Flutter 应用中，您将完成以下操作：这是展示 AdMob 广告并赚取收入的第一步。一次集成已完成，您可以选择一种广告格式实施步骤。

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

前提条件

Flutter 1.22.0 或更高版本
Android 设备
- Android Studio 3.2 或更高版本
- 以 Android API 级别 20 或更高级别为目标平台
- 将 compileSdkVersion 设置为 28 或更高版本
iOS
- 具有已启用命令行的最新版 Xcode 工具
推荐：创建 AdMob 并注册 Android 和/或 iOS 应用

导入移动广告 SDK

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

针对具体平台的设置

Android

更新 AndroidManifest.xml

AdMob 应用 ID 必须包含在 AndroidManifest.xml 中。失败则会导致应用启动时崩溃。

添加 AdMob 应用 ID（可在 AdMob 网站中找到）接口、 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 和设置应用的信息 ID。

iOS

更新 Info.plist

在应用的 ios/Runner/Info.plist 文件中，添加 GADApplicationIdentifier 键，其中含有您的 AdMob 应用程序 ID 的字符串值，如在 AdMob 网站中标识的界面：

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

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

有关详情，请参阅 iOS 指南有关如何配置 Info.plist 和设置应用 ID 的信息。

初始化移动广告 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.
  }
}