Dieser Leitfaden richtet sich an Publisher, die eine Flutter-App monetarisieren möchten.
Damit Sie Ad Manager-Anzeigen ausliefern und Umsatz generieren können, müssen Sie zuerst das Google Mobile Ads SDK in eine Flutter-App einbinden. Sobald die Integration abgeschlossen ist, kannst du ein Anzeigenformat auswählen, um detaillierte Implementierungsschritte zu erhalten.
Das Google Mobile Ads SDK for Flutter unterstützt derzeit das Laden und Einblenden von Banner-, Interstitial- (Vollbildanzeigen), nativen Anzeigen und Anzeigen mit Prämie.
Voraussetzungen
- Flutter 1.22.0 oder höher
- Android
- Android Studio 3.2 oder höher
- Ziel-Android-API-Level 20 oder höher
compileSdkVersion
auf 28 oder höher festlegen
- iOS
- Neueste Version von Xcode mit aktivierten Befehlszeilentools
Mobile Ads SDK importieren
- Fügen Sie das Google Mobile Ads SDK for Flutter in Ihr Flutter-Projekt ein.
Plattformspezifische Einrichtung
Android
AndroidManifest.xml aktualisieren
Die Ad Manager-App-ID muss im AndroidManifest.xml
enthalten sein.
Andernfalls kommt es beim Start der App zu einem Absturz.
Fügen Sie der Datei android/app/src/main/AndroidManifest.xml
der App die Ad Manager-App-ID (auf der Ad Manager-Benutzeroberfläche angezeigt) hinzu. Fügen Sie dazu ein <meta-data>
-Tag mit dem Namen com.google.android.gms.ads.APPLICATION_ID
hinzu. Sie finden Ihre App-ID auf der Ad Manager-Benutzeroberfläche. Fügen Sie für android:value
Ihre eigene Ad Manager-App-ID in Anführungszeichen ein, wie hier gezeigt:
<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>
Verwenden Sie dieselbe value
, wenn Sie das Plug-in in Ihrem Dart-Code initialisieren.
Weitere Informationen zum Konfigurieren von AndroidManifest.xml
und zum Einrichten der App-ID findest du im Android-Leitfaden.
iOS
Info.plist-Datei aktualisieren
Fügen Sie in die Datei ios/Runner/Info.plist
Ihrer App einen GADApplicationIdentifier
-Schlüssel mit einem Stringwert Ihrer Ad Manager-App-ID ein, die auf der Ad Manager-Benutzeroberfläche angezeigt wird:
<key>GADApplicationIdentifier</key> <string>ca-app-pub-################~##########</string>
Sie müssen denselben Wert übergeben, wenn Sie das Plug-in in Ihrem Dart-Code initialisieren.
Weitere Informationen zum Konfigurieren von Info.plist
und zum Einrichten deiner App-ID findest du im iOS-Leitfaden.
Mobile Ads SDK initialisieren
Bevor Anzeigen geladen werden, muss deine App das Mobile Ads SDK initialisieren. Dazu muss MobileAds.instance.initialize()
aufgerufen werden. Dadurch wird das SDK initialisiert und ein Future
zurückgegeben, der abgeschlossen ist, sobald die Initialisierung abgeschlossen ist (oder nach einer Zeitüberschreitung von 30 Sekunden). Dies muss nur einmal erfolgen, idealerweise direkt vor dem Ausführen der 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.
}
}
Anzeigenformat auswählen
Das Mobile Ads SDK wurde importiert und Sie können eine Anzeige implementieren. In Ad Manager können Sie das Anzeigenformat auswählen, das sich am besten für Ihre App eignet.
Banner
Rechteckige Anzeigen, die oben oder unten auf dem Gerätebildschirm erscheinen. Banneranzeigen bleiben auf dem Bildschirm, während Nutzer mit der App interagieren, und können nach einer bestimmten Zeit automatisch aktualisiert werden. Wenn Sie noch nicht mit mobiler Werbung vertraut sind, sind sie ein guter Ausgangspunkt.
Interstitial
Vollbildanzeigen, die die Benutzeroberfläche einer App verdecken, bis sie vom Nutzer geschlossen werden. Sie eignen sich am besten für natürliche Pausen im Ablauf der App-Ausführung, z. B. zwischen Levels eines Spiels oder kurz nach dem Abschließen einer Aufgabe.
Interstitial-Anzeige implementieren
Nativ
Anpassbare Anzeigen, die zum Design Ihrer App passen. Sie entscheiden, wie und wo sie platziert werden, sodass das Layout besser zum Design Ihrer App passt.
Verfügbar
Das sind Anzeigen, in denen Nutzer belohnt werden, wenn sie sich kurze Videos ansehen oder mit spielbaren Anzeigen und Umfragen interagieren. Geeignet für die Monetarisierung von Nutzern, die kostenlos spielen.