設定 Google Mobile Ads 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 檔案中，將 <meta-data> 代碼新增至 <application> 代碼，並加入下列屬性：

    <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，並在 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 提供下列廣告格式：

廣告格式 說明 說明文件
橫幅廣告 在指定區域顯示矩形廣告。這類廣告會自動重新整理，讓使用者在同一個畫面中看到不同廣告。 設定橫幅廣告
插頁式廣告 在應用程式中顯示全版廣告。請將這類廣告放置在自然轉換點，例如遊戲關卡之間。 插頁式廣告
原生 可讓您自訂應用程式中的素材資源，例如廣告標題和行動號召。自訂廣告時，您可以建立與應用程式視覺設計相符的廣告。 載入原生廣告
獎勵廣告 使用者可透過觀看影片或填寫問卷來贏得應用程式內獎勵，例如金幣或額外生命。您可以為每個廣告單元指定獎勵價值。 獎勵廣告
插頁式獎勵廣告 這類廣告可在應用程式轉換時顯示，向使用者提供錢幣或額外生命等獎勵。 插頁式獎勵廣告
應用程式開啟頁面廣告 在使用者開啟或切換回應用程式時顯示。廣告會疊在載入畫面上。 應用程式開啟頁面廣告