Anzeigen mit Prämie

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

Mit Anzeigen mit Prämie können Sie Nutzern, die mit Videoanzeigen, spielbaren Anzeigen und Umfragen interagieren, Belohnungen in Form von In‑App-Artikeln bieten.

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.

Testanzeigen lassen sich unter Android am einfachsten mit unserer speziellen Test-Anzeigenblock-ID für Anzeigen mit Prämie laden:

/21775744923/example/rewarded

Sie wurde speziell so konfiguriert, dass für jede 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 einfach durch Ihre eigene Anzeigenblock-ID.

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

Anzeige laden

Zum Laden einer Anzeige bietet GMA Next-Gen SDK folgende Möglichkeiten:

• Mit der API zum Laden einzelner Anzeigen laden

• Mit der API zum Vorabladen von Anzeigen laden. Dadurch ist kein manuelles Laden und Caching von Anzeigen mehr erforderlich.

Mit der API zum Laden einzelner Anzeigen laden

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

Kotlin

import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback
import com.google.android.libraries.ads.mobile.sdk.MobileAds

class RewardedActivity : Activity() {
  private var rewardedAd: RewardedAd? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Load ads after you inititalize GMA Next-Gen SDK.
    RewardedAd.load(
      AdRequest.Builder(AD_UNIT_ID).build(),
      object : AdLoadCallback<RewardedAd> {
        override fun onAdLoaded(ad: RewardedAd) {
          // Rewarded ad loaded.
          rewardedAd = ad
        }

        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Rewarded ad failed to load.
          rewardedAd = null
        }
      },
    )
  }

  companion object {
    // Sample rewarded ad unit ID.
    const val AD_UNIT_ID = "/21775744923/example/rewarded"
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback;
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest;
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError;
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;

class RewardedActivity extends Activity {
  // Sample rewarded ad unit ID.
  private static final String AD_UNIT_ID = "/21775744923/example/rewarded";
  private RewardedAd rewardedAd;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Load ads after you initialize GMA Next-Gen SDK.
    RewardedAd.load(
        new AdRequest.Builder(AD_UNIT_ID).build(),
        new AdLoadCallback<RewardedAd>() {
          @Override
          public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
            // Rewarded ad loaded.
            AdLoadCallback.super.onAdLoaded(rewardedAd);
            RewardedActivity.this.rewardedAd = rewardedAd;
          }

          @Override
          public void onAdFailedToLoad(@NonNull LoadAdError adError) {
            // Rewarded ad failed to load.
            AdLoadCallback.super.onAdFailedToLoad(adError);
            rewardedAd = null;
          }
        }
    );
  }
}

Mit der API zum Vorabladen von Anzeigen laden

So starten Sie das Vorabladen:

1. Initialisieren Sie eine Konfiguration für das Vorabladen mit einer Anzeigenanfrage.

2. Starten Sie das Vorabladen für Anzeigen mit Prämie mit Ihrer Anzeigenblock-ID und der Konfiguration für das Vorabladen:

Kotlin

private fun startPreloading(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  RewardedAdPreloader.start(adUnitId, preloadConfig)
}
RewardedAdSnippets.kt

Java

private void startPreloading(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  RewardedAdPreloader.start(adUnitId, preloadConfig);
}
RewardedAdSnippets.java

Wenn Sie bereit sind, die Anzeige einzublenden, rufen Sie sie vom Vorabladen ab:

Kotlin

// Polling returns the next available ad and loads another ad in the background.
val ad = RewardedAdPreloader.pollAd(adUnitId)
RewardedAdSnippets.kt

Java

// Polling returns the next available ad and loads another ad in the background.
final RewardedAd ad = RewardedAdPreloader.pollAd(adUnitId);
RewardedAdSnippets.java

RewardedAdEventCallback festlegen

Mit RewardedAdEventCallback werden Ereignisse im Zusammenhang mit der Anzeige von RewardedAd verarbeitet. Bevor Sie die Anzeige mit Prämie einblenden, müssen Sie den Callback festlegen:

Kotlin

// Listen for ad events.
rewardedAd?.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdShowedFullScreenContent() {
      // Rewarded ad did show.
    }

    override fun onAdDismissedFullScreenContent() {
      // Rewarded ad did dismiss.
      rewardedAd = null
    }

    override fun onAdFailedToShowFullScreenContent(
      fullScreenContentError: FullScreenContentError
    ) {
      // Rewarded ad failed to show.
      rewardedAd = null
    }

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

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

Java

// Listen for ad events.
rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Rewarded ad did show.
        RewardedAdEventCallback.super.onAdShowedFullScreenContent();
      }

      @Override
      public void onAdDismissedFullScreenContent() {
        // Rewarded ad did dismiss.
        RewardedAdEventCallback.super.onAdDismissedFullScreenContent();
        rewardedAd = null;
      }

      @Override
      public void onAdFailedToShowFullScreenContent(
          @NonNull FullScreenContentError fullScreenContentError) {
        // Rewarded ad failed to show.
        RewardedAdEventCallback.super.onAdFailedToShowFullScreenContent(
            fullScreenContentError);
        rewardedAd = null;
      }

      @Override
      public void onAdImpression() {
        // Rewarded ad did record an impression.
        RewardedAdEventCallback.super.onAdImpression();
      }

      @Override
      public void onAdClicked() {
        // Rewarded ad did record a click.
        RewardedAdEventCallback.super.onAdClicked();
      }
    }
);

Anzeige einblenden

Verwenden Sie die Methode show(), um eine Anzeige mit Prämie einzublenden. Verwenden Sie ein OnUserEarnedRewardListener-Objekt, um Prämienereignisse zu verarbeiten.

Kotlin

// Show the ad.
rewardedAd?.show(
  this@RewardedActivity,
  object : OnUserEarnedRewardListener {
    override fun onUserEarnedReward(rewardItem: RewardItem) {
      // User earned the reward.
      val rewardAmount = rewardItem.amount
      val rewardType = rewardItem.type
    }
  },
)

Java

// Show the ad.
rewardedAd.show(
    RewardedActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        // User earned the reward.
        int rewardAmount = rewardItem.getAmount();
        String rewardType = rewardItem.getType();
    }
});

FAQ

Gibt es ein Zeitlimit für den Initialisierungsaufruf?

Nach 10 Sekunden ruft GMA Next-Gen SDK OnInitializationCompleteListener auf, auch wenn die Initialisierung eines Vermittlungsnetzwerks noch nicht abgeschlossen ist.

Was passiert, wenn einige Vermittlungsnetzwerke nicht bereit sind, wenn ich den Initialisierungs-Callback erhalte?

Wir empfehlen, eine Anzeige im Callback von OnInitializationCompleteListener zu laden. Auch wenn ein Vermittlungsnetzwerk nicht bereit ist, GMA Next-Gen SDK fordert dieses Netzwerk trotzdem eine Anzeige an. Wenn die Initialisierung eines Vermittlungsnetzwerks nach dem Zeitlimit abgeschlossen ist, kann es in dieser Sitzung weiterhin Anzeigenanfragen bearbeiten.

Sie können den Initialisierungsstatus aller Adapter während der gesamten App-Sitzung abrufen, indem Sie MobileAds.getInitializationStatus() aufrufen.

Wie finde ich heraus, warum ein bestimmtes Vermittlungsnetzwerk nicht bereit ist?

In AdapterStatus.getDescription() wird beschrieben, warum ein Adapter nicht bereit ist, Anzeigenanfragen zu bearbeiten.

Wird der onUserEarnedReward() Callback immer vor dem onAdDismissedFullScreenContent() Callback aufgerufen?

Bei Google-Anzeigen erfolgen alle onUserEarnedReward()-Aufrufe vor onAdDismissedFullScreenContent(). Bei Anzeigen, die über die Vermittlungausgeliefert werden, wird die Reihenfolge der Callbacks durch die Implementierung des SDK des Drittanbieter-Werbenetzwerks bestimmt. Bei Werbenetzwerk-SDKs, die einen einzelnen Callback zum Schließen mit Prämieninformationen bereitstellen, ruft der Vermittlungsadapter onUserEarnedReward() vor onAdDismissedFullScreenContent() auf.

Beispiel

Laden Sie die Beispiel-App herunter und führen Sie sie aus, um die Verwendung des GMA Next-Gen SDK zu sehen.