Questa guida è rivolta ai publisher che vogliono monetizzare un'app Flutter.
Integrare l'SDK Google Mobile Ads in un'app Flutter, come descritto qui, è il primo passo per mostrare annunci Ad Manager e generare entrate. Una volta completata l'integrazione, puoi scegliere un formato dell'annuncio per visualizzare i passaggi dettagliati di implementazione.
L'SDK Google Mobile Ads per Flutter al momento supporta il caricamento e la visualizzazione di annunci banner, interstitial (a schermo intero), nativi e con premio.
Prerequisiti
- Flutter 1.22.0 o versioni successive
- Android
- Android Studio 3.2 o versioni successive
- Effettuare il targeting del livello API Android 20 o superiore
- Imposta
compileSdkVersion
su 28 o un numero superiore
- iOS
- La versione più recente di Xcode con strumenti a riga di comando abilitati
Importa l'SDK Mobile Ads
- Includi il plug-in dell'SDK Google Mobile Ads per Flutter nel tuo progetto Flutter.
Configurazione specifica per la piattaforma
Android
Aggiorna AndroidManifest.xml
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 (identificato nell'interfaccia utente 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
. Puoi trovare il tuo ID app
nell'UI di Ad Manager. Per android:value
, inserisci il tuo ID app Ad
Manager tra virgolette, come mostrato:
<manifest> <application> <!-- Sample 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>
Usa lo stesso value
per inizializzare il plug-in nel codice Dart.
Consulta la guida Android per saperne di più sulla configurazione di AndroidManifest.xml
e dell'ID app.
iOS
Aggiorna il file Info.plist
Nel file ios/Runner/Info.plist
della tua app, aggiungi una chiave GADApplicationIdentifier
con un valore stringa del tuo ID app Ad Manager (identificato nell'interfaccia utente di Ad Manager):
<key>GADApplicationIdentifier</key> <string>ca-app-pub-################~##########</string>
Devi passare lo stesso valore quando inizializzi il plug-in nel codice Dart.
Consulta la guida iOS per ulteriori informazioni sulla configurazione di Info.plist
e sull'impostazione del tuo ID app.
Inizializza l'SDK Mobile Ads
Prima di caricare gli annunci, fai in modo che la tua app inizializza l'SDK 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). Questa operazione deve essere eseguita una sola volta, idealmente subito prima di eseguire l'app.
import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize();
runApp(MyApp());
}
class MyApp extends StatefulWidget {
@override
MyAppState createState() => MyAppState();
}
class MyAppState extends State<MyApp> {
@override
void initState() {
super.initState();
// Load ads.
}
}
Seleziona un formato dell'annuncio
L'SDK Mobile Ads è stato importato e puoi implementare un annuncio. Ad Manager offre diversi formati dell'annuncio, tra cui scegliere quello più adatto all'esperienza utente della tua app.
Banner
Annunci rettangolari che vengono 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à per il mobile, l'offerta è un ottimo punto di partenza.
Implementare un annuncio banner
Interstitial
Annunci a schermo intero che coprono l'interfaccia di un'app fino alla chiusura dell'utente. Sono ideali per le pause naturali del flusso di esecuzione di un'app, ad esempio tra un livello di gioco e l'altro o subito dopo il completamento di un'attività.
Implementare un annuncio interstitial
Nativo
Annunci personalizzabili che si adattano all'aspetto e al design della tua app. Sei tu a decidere come e dove vengono posizionati, in modo che il layout sia più coerente con il design della tua app.
Implementare un annuncio nativo
Con premio
Annunci che premiano gli utenti per la visione di brevi video e l'interazione con annunci e sondaggi demo. Ideale per monetizzare gli utenti free-to-play.