Questa guida è destinata ai publisher che vogliono monetizzare un'app Flutter.
L'integrazione dell'SDK Google Mobile Ads in un'app Flutter, che farai qui, è il primo passo per visualizzare gli annunci Ad Manager e generare entrate. Una volta completata l'integrazione, puoi scegliere un formato dell'annuncio per visualizzare i passaggi di implementazione dettagliati.
Al momento, l'SDK Google Mobile Ads per Flutter 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
- Livello API Android target 20 o successivo
- Imposta
compileSdkVersion
su un valore pari o superiore a 28
- iOS
- La versione più recente di Xcode con strumenti a riga di comando abilitati
Importa l'SDK Mobile Ads
- Includi il plug-in Flutter dell'SDK Google Mobile Ads nel tuo progetto.
Configurazione specifica per la piattaforma
Android
Aggiorna AndroidManifest.xml
L'ID app Ad Manager deve essere incluso nel AndroidManifest.xml
.
Se non lo fai, 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'interfaccia utente di Ad Manager. Per android:value
, inserisci il tuo ID app Ad
Manager tra virgolette, come mostrato di seguito:
<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>
Utilizza lo stesso value
quando inizializza il plug-in nel codice Dart.
Consulta la guida
di Android per ulteriori informazioni sulla configurazione
AndroidManifest.xml
e sull'ID app.
iOS
Aggiorna il file Info.plist
Nel file ios/Runner/Info.plist
dell'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 inizializza il plug-in nel codice Dart.
Consulta la guida iOS per ulteriori informazioni sulla configurazione di Info.plist
e sull'ID app.
Inizializzare l'SDK Mobile Ads
Prima di caricare gli annunci, chiedi alla tua app di inizializzare l'SDK Mobile Ads chiamando
MobileAds.instance.initialize()
, che inizializza l'SDK e restituisce un
Future
che termina al termine dell'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 degli annunci, così puoi 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 dispositivi mobili, sono 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 nel flusso di esecuzione di un'app, ad esempio tra i livelli di un gioco o subito dopo aver completato 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 devono essere 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 demo e sondaggi. Ideale per monetizzare gli utenti free-to-play.