Inizia

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

Importa l'SDK Mobile Ads

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.

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.

Implementare un annuncio con premio