Iniziare

Questa guida è destinata ai publisher che desiderano monetizzare un Flutter.

Integrare l'SDK Google Mobile Ads in un'app Flutter, cosa che farai ecco il primo passo per mostrare gli annunci Ad Manager e generare entrate. Una volta completata l'integrazione, puoi scegliere un formato dell'annuncio per ottenere dettagli i passaggi di implementazione.

Al momento, l'SDK Google Mobile Ads per Flutter supporta il caricamento e la visualizzazione 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

Importa l'SDK Mobile Ads

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'annuncio UI 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 la tua app nell'interfaccia utente di Ad Manager. Per android:value inserisci il tuo annuncio ID app gestore 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>

Utilizza lo stesso value quando inizializza il plug-in in Dart le API nel tuo codice.

Consulta le per ulteriori informazioni sulla configurazione AndroidManifest.xml e configurare l'ID app.

iOS

Aggiorna il file Info.plist

Nel file ios/Runner/Info.plist dell'app, aggiungi un elemento Chiave GADApplicationIdentifier con un valore stringa del tuo Ad Manager ID app (identificato in dell'interfaccia utente di Ad Manager).

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

Devi passare lo stesso valore quando inizializza il plug-in in Dart le API nel tuo codice.

Consulta la guida di iOS per ulteriori informazioni sulla configurazione di Info.plist l'ID dell'app.

Inizializzare l'SDK Mobile Ads

Prima di caricare gli annunci, chiedi all'app di inizializzare 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 30 secondi timeout). 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. Annuncio Manager offre diversi formati di annunci, così puoi scegliere quello che si adatta meglio all'esperienza utente della tua app.

Annunci rettangolari che vengono visualizzati nella parte superiore o inferiore dello schermo del dispositivo. Banner gli annunci rimangono sullo schermo mentre gli utenti interagiscono con l'app e possono aggiornarsi automaticamente dopo un certo periodo di tempo. Se non hai mai utilizzato un dispositivo mobile pubblicità, 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 un livello e l'altro 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 sono 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 contenuti riproducibili annunci e sondaggi. Ideale per monetizzare gli utenti free-to-play.

Implementare un annuncio con premio