Erste Schritte

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

Mobile Ads SDK importieren

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.

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.

Banneranzeige implementieren

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.

Native Anzeige implementieren

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.

Anzeigen mit Prämie implementieren