Einzelne App-Start-Anzeige laden

SDK mit Single-Load-API

App-Start-Anzeigen sind ein spezielles Anzeigenformat für Publisher, die auf dem Ladebildschirm ihrer App Einnahmen erzielen möchten. App-Start-Anzeigen können jederzeit geschlossen werden und werden eingeblendet, wenn Nutzer Ihre App in den Vordergrund bringen.

Weitere Informationen finden Sie in den Richtlinien für App-Start-Anzeigen.

In dieser Anleitung wird erläutert, wie Sie App-Start-Anzeigen in eine Android-App einbinden.

Vorbereitung

Einrichten GMA Next-Gen SDK.

Immer mit Testanzeigen testen

Verwenden Sie beim Erstellen und Testen Ihrer Apps Testanzeigen anstelle von Live-Anzeigen. Andernfalls kann es zur Sperrung Ihres Kontos kommen.

Verwenden Sie zum Laden von Testanzeigen die spezielle Test-Anzeigenblock-ID für App-Start-Anzeigen in Android-Apps:

ca-app-pub-3940256099942544/9257395921

Diese Anzeigenblock-ID wurde speziell so konfiguriert, dass bei jeder Anfrage Testanzeigen zurückgegeben werden. Sie können sie beim Programmieren, Testen und Debuggen in Ihren eigenen Apps verwenden. Ersetzen Sie sie vor der Veröffentlichung Ihrer App durch Ihre eigene Anzeigenblock-ID.

Weitere Informationen zu GMA Next-Gen SDK Testanzeigen finden Sie unter Testanzeigen aktivieren.

Anzeige laden

Das folgende Beispiel zeigt, wie Sie eine einzelne Anzeige laden:

Kotlin

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

Java

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

Verwenden Sie beim Testen die Test-Anzeigenblock-ID: ca-app-pub-3940256099942544/9257395921.

Anzeige präsentieren

Verwenden Sie die Methode show, um eine App-Start-Anzeige zu präsentieren.

Kotlin

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

Java

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

Anzeigenereignisse beobachten

Beobachten Sie vor dem Präsentieren der Anzeige die Ereignisse im Anzeigenlebenszyklus:

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = appOpenAd
  if (ad == null) {
    Log.e(TAG, "App open ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // App open ad failed to show.
        Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

Java

private void listenToAdEvents() {
  // Listen for ad events.
  if (appOpenAd == null) {
    Log.e(TAG, "App open ad is not ready yet.");
    return;
  }

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // App open ad failed to show.
          Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // App open ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // App open ad did record a click.
        }
      });
}

Kaltstarts und Ladebildschirme

Ein Kaltstart tritt auf, wenn Ihre App von Grund auf neu gestartet wird, z. B. wenn ein Nutzer Ihre App zum ersten Mal öffnet oder nach einer Speicherbeendigung. Bei einem Kaltstart ist keine zuvor geladene App-Start-Anzeige verfügbar, die sofort präsentiert werden kann.

Aufgrund von Verzögerungen bei Anzeigenanfragen können Nutzer mit Ihrer App interagieren, bevor eine App-Start-Anzeige eingeblendet wird. Um eine schlechte Nutzererfahrung zu vermeiden, sollten Sie App-Start-Anzeigen bei Kaltstarts nur auf einem Ladebildschirm präsentieren, während die App-Assets geladen werden. Wenn das Laden der Assets abgeschlossen ist und der Nutzer den Hauptinhalt erreicht, bevor die Anzeige geladen wird, präsentieren Sie die Anzeige nicht.

Laden Sie App-Assets in einem Hintergrundthread, damit das Laden fortgesetzt wird, während die Anzeige präsentiert wird.

Best Practices

Beachten Sie diese Best Practices für App-Start-Anzeigen:

  • Präsentieren Sie die erste App-Start-Anzeige erst, nachdem ein Nutzer Ihre App mehrmals geöffnet hat.
  • Präsentieren Sie App-Start-Anzeigen nur, während Nutzer darauf warten, dass Ihre App geladen wird.
  • Wenn der Ladebildschirm fertig geladen ist, während die Anzeige präsentiert wird, schließen Sie den Ladebildschirm in der Callback-Methode für das Schließen der Anzeige.