此页面由 Cloud Translation API 翻译。

开始使用

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

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

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

前提条件

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

导入移动广告 SDK

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

针对具体平台的设置

Android

更新 AndroidManifest.xml

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

添加 Ad Manager 应用 ID（在广告中显示 Manager 界面）添加到应用的 android/app/src/main/AndroidManifest.xml 文件中，方法是添加名称为 <meta-data> 的标记。 com.google.android.gms.ads.APPLICATION_ID。您可以找到您的应用 Ad Manager 界面中显示此 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 文件中，添加将 GADApplicationIdentifier 键替换为您的 Ad Manager 字符串值应用程序 ID（在 Ad Manager 界面）：

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