设置 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。
  • Ad Manager 应用 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 Ad Manager 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：您的 Ad Manager 应用 ID。

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

iOS

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

  2. 在 Info.plist 文件中，添加一个 GADApplicationIdentifier 键，并将其值设为您的 Ad Manager 应用 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 后，您可以选择要植入的广告格式。Ad Manager 提供以下广告格式：

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