踏出第一步

選取平台： Android iOS Unity Flutter

在 Flutter 應用程式中整合 Google Mobile Ads SDK，是顯示廣告並賺取收益的第一步。整合完畢後，即可開始導入一或多種支援的廣告格式。

必備條件

  • Flutter 3.27.0 以上版本
  • Android
    • 最新版 Android Studio
  • iOS

匯入 Mobile Ads SDK

平台專屬設定

Android

更新 AndroidManifest.xml

Ad Manager 應用程式 ID 必須包含在 AndroidManifest.xml 中，否則應用程式啟動時會停止運作。

請從 Ad Manager 網頁介面找出 Ad Manager 應用程式 ID，然後將這組 ID 加入應用程式的 android/app/src/main/AndroidManifest.xml 檔案。方法是新增 <meta-data> 標籤，將 name 設為 com.google.android.gms.ads.APPLICATION_ID，並在 android:value 中插入您的應用程式 ID (需用半形引號括住)，如下所示：

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

在 Dart 程式碼中初始化外掛程式時，請使用相同的 value。

如要進一步瞭解如何設定 AndroidManifest.xml 和應用程式 ID，請參閱 Android 指南。

iOS

更新 Info.plist

請在應用程式的 ios/Runner/Info.plist 檔案中新增 GADApplicationIdentifier 鍵，並使用從 Ad Manager 網頁介面取得的 Ad Manager 應用程式 ID 來設定字串值：

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

在 Dart 程式碼中初始化外掛程式時，請務必傳遞相同的值。

如要進一步瞭解如何設定 Info.plist 和應用程式 ID，請參閱 iOS 指南。

初始化 Mobile Ads SDK

載入廣告前，請先讓應用程式呼叫 MobileAds.instance.initialize() 來初始化 Mobile Ads SDK。這個方法會初始化 SDK 並回傳 Future 物件，該物件將在初始化完成或 30 秒逾時後執行完畢。建議盡早呼叫 initialize()。

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

選取廣告格式

匯入 Mobile Ads SDK 後，即可開始導入廣告。Ad Manager 提供多種廣告格式，您可以根據應用程式的使用者體驗，選擇最適合的格式。

顯示在裝置畫面頂端或底部的矩形廣告。使用者操作應用程式時，橫幅廣告會持續停留在畫面上，並能定時自動更新內容。對剛接觸行動廣告的新手來說，這是很好的入門選擇。

導入橫幅廣告

插頁式廣告

完全覆蓋應用程式介面的全螢幕廣告，使用者需自行關閉。這類廣告最適合出現在應用程式執行流程中的自然停頓點，例如遊戲關卡之間或完成任務後。

導入插頁式廣告

原生廣告

可自訂的廣告，能配合應用程式的外觀風格。您可以決定廣告的顯示方式和位置，讓版面配置更貼近應用程式的設計。

導入原生廣告

獎勵廣告

這類廣告能在使用者看完短片、與可試玩廣告互動，或完成問卷調查後提供獎勵；適合用來從免付費玩遊戲的使用者身上創造收益。

導入獎勵廣告