设置 Google 移动广告 Flutter 插件

请选择平台： Android iOS Unity Flutter Android（旧版）

如需投放广告并赚取收入，请将 Google Mobile Ads Flutter Plugin集成到您的 Flutter 应用中。如需准备项目，请在提出广告请求之前导入并初始化 Google Mobile Ads Flutter Plugin。

本指南介绍了如何导入和初始化 Google Mobile Ads Flutter Plugin，以及如何选择广告格式。

前提条件

在继续之前，请确保您已具备以下条件：

  • Flutter 3.38.1 或更高版本。
  • 对于 Android，请使用最新版 Android Studio。
  • 对于 iOS，请使用最新版 Xcode，并确保已启用命令行工具。如需了解详情，请参阅安装 Flutter。
  • AdMob 应用 ID。如需了解详情，请参阅查找并复制应用 ID 或广告单元 ID。

导入 Google Mobile Ads Flutter Plugin

如需在 Flutter 项目中导入 Google Mobile Ads Flutter Plugin，请参阅 google_mobile_ads。

配置您的应用

导入 Google Mobile Ads Flutter Plugin后，选择以下平台之一来配置应用：

Android

  1. 在 Android Studio 中，前往 android/app/src/main/AndroidManifest.xml 文件。

  2. 在 AndroidManifest.xml 文件中，向 <application> 标记添加一个具有以下属性的 <meta-data> 标记：

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

    这些属性必须具有以下值：

    • android:name：com.google.android.gms.ads.APPLICATION_ID。
    • android:value：您的 AdMob 应用 ID。

    如需详细了解如何设置 AndroidManifest.xml 文件，请参阅设置 Google Mobile Ads SDK (Legacy)。

iOS

  1. 在 Xcode 中，找到 ios/Runner/Info.plist 文件。

  2. 在 Info.plist 文件中，添加一个 GADApplicationIdentifier 键，并将您的 AdMob 应用 ID 设为字符串值。

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

    如需详细了解如何设置 Info.plist 文件，请参阅更新 Info.plist。

初始化 Google Mobile Ads Flutter Plugin

加载广告之前，请先调用 MobileAds.instance.initialize() 来初始化 Google Mobile Ads Flutter Plugin。

此方法会返回一个 Future，该 Future 会在 Google Mobile Ads Flutter Plugin初始化后或 30 秒后结束。

以下示例初始化了 Google Mobile Ads Flutter Plugin：

// Initialize the Mobile Ads SDK.
MobileAds.instance.initialize();

选择一种广告格式

导入 Google Mobile Ads Flutter Plugin后，您可以选择要植入的广告格式。 AdMob 提供以下广告格式：

广告格式 说明 文档
横幅 在指定区域展示矩形广告。这些广告会自动刷新，让用户无需离开当前屏幕即可看到广告。 设置横幅广告
插页式广告 在应用中展示全屏广告。请将这些广告放置在自然过渡点，例如游戏关卡之间。 插页式广告
原生 可让您自定义应用中的素材资源（如标题和号召性用语）。自定义广告时，您需要制作与应用视觉设计相符的广告。 加载原生广告
激励广告 让用户通过观看视频或填写调查问卷来获得应用内奖励，例如金币或额外生命值。您可以为每个广告单元指定奖励价值。 激励广告
插页式激励广告 让您可以通过在应用过渡期间展示的广告向用户提供奖励，如金币或额外生命值。 插页式激励广告
开屏广告 这种广告会在用户打开或返回您的应用时展示，广告会叠加在加载屏幕上。 开屏广告