L'integrazione dell'SDK Google Mobile Ads in un'app Flutter è il primo passo
per visualizzare gli annunci e generare entrate. Una volta integrato l'SDK, puoi procedere con l'implementazione di uno o più formati di annunci supportati.
L'ID app Ad Manager deve essere incluso in AndroidManifest.xml.
In caso contrario, si verifica un arresto anomalo all'avvio dell'app.
Aggiungi l'ID app Ad Manager, come
identificato nell'interfaccia web di Ad Manager,
al file android/app/src/main/AndroidManifest.xml dell'app aggiungendo un tag
<meta-data> con il nome com.google.android.gms.ads.APPLICATION_ID.
Per android:value, inserisci il tuo ID app tra virgolette come mostrato di seguito:
Utilizza lo stesso value quando inizializzi il plug-in nel codice Dart.
Per ulteriori informazioni sulla configurazione di AndroidManifest.xml e sull'impostazione dell'ID app, consulta la
guida per Android.
iOS
Aggiornare Info.plist
Nel file ios/Runner/Info.plist della tua app, aggiungi una chiave GADApplicationIdentifier
con un valore stringa dell'ID app Ad Manager, come
identificato nell'interfaccia web di Ad Manager:
Devi passare lo stesso valore quando inizializzi il plug-in nel codice Dart.
Per ulteriori informazioni sulla configurazione di Info.plist e sull'impostazione dell'ID app, consulta la
guida per iOS.
Inizializza l'SDK Mobile Ads
Prima di caricare gli annunci, fai in modo che la tua app inizializzi l'SDK Google Mobile Ads chiamando
MobileAds.instance.initialize()
che inizializza l'SDK e restituisce un Future che termina una volta
completata l'inizializzazione o dopo un timeout di 30 secondi. Chiama initialize()
il prima possibile.
// Initialize the Mobile Ads SDK.MobileAds.instance.initialize();
Dopo aver importato l'SDK Google Mobile Ads, puoi implementare un annuncio.
Ad Manager offre diversi formati di annunci, per consentirti di scegliere
quello più adatto all'esperienza utente della tua app.
Banner
Annunci rettangolari visualizzati nella parte superiore o inferiore dello schermo del dispositivo. Gli annunci
banner rimangono sullo schermo mentre gli utenti interagiscono con l'app e possono aggiornarsi
automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità mobile, sono un ottimo punto di partenza.
Annunci a schermo intero che coprono l'interfaccia di un'app finché non vengono chiusi dall'utente.
Sono più adatti per le pause naturali nel flusso di esecuzione di un'app, ad esempio
tra i livelli di un gioco o subito dopo il completamento di un'attività.
Annunci personalizzabili che corrispondono all'aspetto della tua app. Decidi come e dove devono essere posizionati, in modo che il layout sia più in linea con il design della tua app.
Annunci che premiano gli utenti per la visione di brevi video e/o l'interazione con annunci demo e sondaggi. Perfetti per monetizzare gli utenti free-to-play.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-06 UTC."],[[["\u003cp\u003eThis guide explains how to integrate Google Mobile Ads SDK into a Flutter app for monetization with Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure you meet the prerequisites, which include specific Flutter, Android, and iOS requirements.\u003c/p\u003e\n"],["\u003cp\u003eYou must update your AndroidManifest.xml or Info.plist with your Ad Manager app ID for Android and iOS respectively, then initialize the Mobile Ads SDK in your Dart code.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK supports banner, interstitial, native, and rewarded ad formats - select the one that best suits your app.\u003c/p\u003e\n"],["\u003cp\u003eDetailed implementation steps are provided for each ad format after the initial integration is complete.\u003c/p\u003e\n"]]],["Publishers monetize Flutter apps by integrating the Google Mobile Ads SDK. This involves importing the SDK plugin and setting up platform-specific configurations. For Android, update `AndroidManifest.xml` with the Ad Manager app ID; for iOS, update `Info.plist`. Initialize the SDK using `MobileAds.instance.initialize()` before loading ads. Finally, choose an ad format: banner, interstitial, native, or rewarded, each with detailed implementation guides. Ensure you have the latest SDK version for full privacy compliance.\n"],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/quick-start \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/quick-start \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/quick-start \"View this page for the Unity platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/flutter/quick-start \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nIntegrating Google Mobile Ads SDK into a Flutter app is the first step\ntoward displaying ads and earning revenue. Once you've integrated the SDK, you\ncan proceed to implement one or more of the supported ad formats.\n\nPrerequisites\n\n- Flutter 3.27.0 or higher\n- Android\n - Latest version of Android Studio\n- iOS\n - Latest version of Xcode with [enabled command-line\n tools](//flutter.dev/docs/get-started/install/macos#install-xcode)\n\nImport Google Mobile Ads SDK\n\n- Include the [Google Mobile Ads SDK for Flutter\n plugin](//pub.dev/packages/google_mobile_ads/install) in your Flutter project.\n\nPlatform specific setup\n\n\n| **Important:** Use the latest Google Mobile Ads SDK so that you have access to all the privacy compliance features.\n\n\u003cbr /\u003e\n\nAndroid\n\n**Update AndroidManifest.xml**\n\nThe Ad Manager app ID must be included in the `AndroidManifest.xml`.\nFailure to do so results in a crash on app launch.\n\nAdd the Ad Manager app ID, as\n\n[identified in the Ad Manager web interface](//support.google.com/admanager/answer/15014197),\n\nto the app's `android/app/src/main/AndroidManifest.xml` file by adding a\n`\u003cmeta-data\u003e` tag with the name `com.google.android.gms.ads.APPLICATION_ID`.\nFor `android:value`, insert your own app ID in quotes as shown: \n\n \u003cmanifest\u003e\n \u003capplication\u003e\n \u003c!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 --\u003e\n \u003cmeta-data\n android:name=\"com.google.android.gms.ads.APPLICATION_ID\"\n android:value=\"ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy\"/\u003e\n \u003capplication\u003e\n \u003cmanifest\u003e\n\nUse the same `value` when you initialize the plugin in your Dart code.\n\nSee the\n\n[Android guide](/ad-manager/mobile-ads-sdk/android/quick-start#update_your_androidmanifestxml)\n\nfor more information about configuring `AndroidManifest.xml` and setting up\nthe app ID.\n\niOS\n\n**Update Info.plist**\n\nIn your app's `ios/Runner/Info.plist` file, add a `GADApplicationIdentifier`\nkey with a string value of your Ad Manager app ID, as\n[identified in the Ad Manager web interface](//support.google.com/admanager/answer/15014197): \n\n \u003ckey\u003eGADApplicationIdentifier\u003c/key\u003e\n \u003cstring\u003eca-app-pub-################~##########\u003c/string\u003e\n\nYou must pass the same value when you initialize the plugin in your Dart code.\n\nSee the\n\n[iOS guide](/ad-manager/mobile-ads-sdk/ios/quick-start#update_your_infoplist)\n\nfor more information about configuring `Info.plist` and setting up the app ID.\n\nInitialize the Mobile Ads SDK\n\nBefore loading ads, have your app initialize Google Mobile Ads SDK by calling\n[`MobileAds.instance.initialize()`](//pub.dev/documentation/google_mobile_ads/latest/google_mobile_ads/MobileAds/initialize.html)\nwhich initializes the SDK and returns a `Future` that finishes once\ninitialization is complete, or after a 30-second timeout. Call `initialize()`\nas early as possible. \n\n // Initialize the Mobile Ads SDK.\n MobileAds.instance.initialize(); \n https://github.com/googleads/googleads-mobile-flutter/blob/82c58b3202d8b9391e4d3ec39b045032e90cf331/samples/admob/banner_example/lib/main.dart#L229-L230\n\nSelect an ad format\n\nAfter Google Mobile Ads SDK is imported, you're ready to implement an ad.\nAd Manager offers a number of different ad formats, so you can choose\nthe one that best fits your app's user experience.\n\nBanner\n\nRectangular ads that appear at the top or bottom of the device screen. Banner\nads stay on screen while users are interacting with the app, and can refresh\nautomatically after a certain period of time. If you're new to mobile\nadvertising, they're a great place to start. \n\n[Implement a Banner ad](/ad-manager/mobile-ads-sdk/flutter/banner)\n\nInterstitial\n\nFull-screen ads that cover the interface of an app until closed by the user.\nThey're best used at natural pauses in the flow of an app's execution, such as\nin between levels of a game or just after completing a task. \n\n[Implement an Interstitial ad](/ad-manager/mobile-ads-sdk/flutter/interstitial)\n\nNative\n\nCustomizable ads that match the look and feel of your app. You decide how and\nwhere they're placed, so the layout is more consistent with your app's design. \n\n[Implement a Native ad](/ad-manager/mobile-ads-sdk/flutter/native)\n\nRewarded\n\nAds that reward users for watching short videos and interacting with playable\nads and surveys. Good for monetizing free-to-play users. \n\n[Implement a Rewarded ad](/ad-manager/mobile-ads-sdk/flutter/rewarded)"]]