Vorabladen von Anzeigen (Beta)

Plattform auswählen: iOS Unity Flutter Android (Legacy)

Das Vorabladen von Anzeigen ist eine von Google verwaltete Funktion zum Laden von Anzeigen in Google Mobile Ads Flutter Plugin, die das Laden und Caching von Anzeigen in Ihrem Namen verwaltet. Für das Vorabladen von Anzeigen muss die Art und Weise geändert werden, wie Sie das Laden von Anzeigen verwalten. Wenn Sie die Leistung durch das Vorabladen von Anzeigen optimieren möchten, deaktivieren Sie das benutzerdefinierte Caching und übertragen Sie diese Aufgabe an Google Mobile Ads Flutter Plugin.

Das Vorabladen von Anzeigen bietet gegenüber dem manuellen Laden von Anzeigen folgende Vorteile:

  • Referenzverwaltung:Geladene Anzeigen werden gespeichert, sodass Sie Referenzen erst dann verwalten müssen, wenn Sie die Anzeigen präsentieren möchten.
  • Automatisches Neuladen:Eine neue Anzeige wird automatisch geladen, wenn Sie eine aus dem Cache abrufen.
  • Verwaltete Wiederholungen:Fehlgeschlagene Anfragen werden automatisch mit exponentiellem Backoff wiederholt.
  • Ablaufbehandlung:Anzeigen werden automatisch aktualisiert, bevor sie ablaufen (in der Regel nach einer Stunde).
  • Cache-Optimierung: Wenn Sie eine Cache-Größe von mehr als 1 verwenden, Google Mobile Ads Flutter Plugin optimiert die Cache-Reihenfolge, um die beste Anzeige auszuliefern.

In dieser Anleitung wird beschrieben, wie Sie das Vorabladen von Anzeigen konfigurieren, die Verfügbarkeit von vorabgeladenen Anzeigen prüfen und die vorabgeladene Anzeige präsentieren.

Vorbereitung

Bevor Sie mit dieser Anleitung fortfahren, müssen Sie einrichten Google Mobile Ads Flutter Plugin.

Vorabladen von Anzeigen starten

Rufen Sie beim Start der App einmal die Methode start auf. Nachdem Sie die Methode start aufgerufen haben, lädt Google Mobile Ads Flutter Plugin automatisch Anzeigen vorab und wiederholt fehlgeschlagene Anfragen für vorabgeladene Konfigurationen.

Im folgenden Beispiel wird das Vorabladen von Anzeigen gestartet:

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: const PreloadCallback(),
);

Ersetzen Sie _adUnitId durch Ihre Anzeigenblock-ID.

Vorabgeladene Anzeigen abrufen und präsentieren

Wenn Sie das Vorabladen von Anzeigen verwenden, werden die im Cache gespeicherten Anzeigen von Google Mobile Ads Flutter Plugin verwaltet. Wenn Sie eine Anzeige präsentieren möchten, rufen Sie die Methode pollAd auf. Google Mobile Ads Flutter Plugin ruft eine verfügbare Anzeige ab und lädt im Hintergrund automatisch die nächste Anzeige vorab.

Rufen Sie die Methode pollAd erst auf, wenn Sie bereit sind, eine Anzeige zu präsentieren. Wenn Anzeigen im Cache gespeichert bleiben, kann Google Mobile Ads Flutter Plugin abgelaufene Anzeigen automatisch aktualisieren und den Cache optimieren.

Im folgenden Beispiel wird eine vorabgeladene Anzeige abgerufen und präsentiert:

void _pollAndShowAd() async {
  final InterstitialAd? ad = await InterstitialAdPreloader.pollAd(_adUnitId);
  if (ad != null) {
    _interstitialAd = ad;
    ad.fullScreenContentCallback = FullScreenContentCallback(
      onAdImpression: (ad) {
        // Called when an impression occurs on the ad.
        debugPrint('Ad recorded an impression.');
      },
    );
    ad.onPaidEvent = (ad, valueMicros, precision, currencyCode) {
      // Called when an ad is estimated to have earned money.
      debugPrint('Ad paid: $valueMicros $currencyCode.');
    };
    // Show the ad.
    await ad.show();
  }
}

Verfügbarkeit von vorabgeladenen Anzeigen prüfen

Wählen Sie eine der folgenden Optionen aus, um die Verfügbarkeit von Anzeigen zu prüfen:

Verfügbarkeit von vorabgeladenen Anzeigen abrufen

Im folgenden Beispiel wird die Verfügbarkeit von Anzeigen geprüft:

void _checkAdAvailability() async {
  final bool isAvailable = await InterstitialAdPreloader.isAdAvailable(
    _adUnitId,
  );
  debugPrint('Is ad available: $isAvailable');
}

Verfügbarkeit von vorabgeladenen Anzeigen abfragen

Registrieren Sie sich für Vorabladen-Ereignisse, um benachrichtigt zu werden, wenn Anzeigen erfolgreich vorabgeladen wurden, das Vorabladen fehlgeschlagen ist oder der Anzeigen-Cache erschöpft ist.

Vorabladen-Ereignisse sind für Analysezwecke vorgesehen. Innerhalb von Rückrufen für Vorabladen-Ereignisse:

  • Rufen Sie start nicht auf.
  • Rufen Sie pollAd nur auf, wenn die Anzeige sofort präsentiert wird.

Im folgenden Beispiel werden Anzeigenereignisse registriert:

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: PreloadCallback(
    onAdPreloaded: (preloadId, responseInfo) {
      debugPrint('Ad preloaded for ID: $preloadId');
    },
    onAdFailedToPreload: (preloadId, error) {
      debugPrint('Ad failed to preload for ID: $preloadId. Error: $error');
    },
    onAdsExhausted: (preloadId) {
      debugPrint('All preloaded ads exhausted for ID: $preloadId');
    },
  ),
);

Vorabladen von Anzeigen beenden

Wenn Sie in der Sitzung keine Anzeigen für eine Vorabladen-ID mehr präsentieren müssen, können Sie das Vorabladen von Anzeigen beenden. Rufen Sie destroy mit einer Vorabladen-ID auf, um das Vorabladen von Anzeigen für eine bestimmte Vorabladen-ID zu beenden. Rufen Sie destroyAll auf, um das Vorabladen für alle Vorabladen-IDs zu beenden.

void _stopPreloading() async {
  await InterstitialAdPreloader.destroy(_adUnitId);
}

Puffergröße festlegen

Mit der Puffergröße wird die Anzahl der vorabgeladenen Anzeigen gesteuert, die im Arbeitsspeicher gespeichert werden. Standardmäßig optimiert Google die Puffergröße, um den Arbeitsspeicherverbrauch und die Latenz bei der Anzeigenauslieferung auszugleichen. Wenn in Ihrer App Anzeigen präsentiert werden, bevor die nächste Anzeige geladen wird, können Sie eine benutzerdefinierte Puffergröße festlegen, um die Anzahl der im Arbeitsspeicher gespeicherten Anzeigen zu erhöhen.

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(
    adUnitId: _adUnitId,
    bufferSize: 3,
  ),
  callback: const PreloadCallback(),
);

Limits für den Vorabladen-Cache

Google Mobile Ads Flutter Plugin erzwingt ein app-weites Limit für die Gesamtzahl der vorabgeladenen Anzeigen für alle Anzeigenblöcke und Vorabladen-IDs:

  • Standardlimit: Google Mobile Ads Flutter Plugin speichert maximal sechs vorabgeladene Anzeigen im Arbeitsspeicher. Dieses Limit gilt für alle Formate und Vorabladen-IDs.
  • Wir empfehlen, für jede Vorabladen-ID eine Puffergröße von zwei festzulegen.