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

Richten Sie GMA Next-Gen SDK ein.

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:

/6499/example/app-open

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: /6499/example/app-open.

Anzeige einblenden

Verwenden Sie die Methode show, um eine App-Start-Anzeige einzublenden.

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 Einblenden 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 eingeblendet werden kann.

Aufgrund von Verzögerungen bei Anzeigenanfragen interagieren Nutzer möglicherweise mit Ihrer App, bevor eine App-Start-Anzeige eingeblendet wird. Um eine schlechte Nutzererfahrung zu vermeiden, sollten Sie App-Start-Anzeigen bei Kaltstarts nur auf einem Ladebildschirm einblenden, 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, blenden Sie die Anzeige nicht ein.

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

Best Practices

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

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