Anzeigen mit Prämie

Anzeigen mit Prämie 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

  • Führen Sie die Schritte im Startleitfaden aus.

    • Immer Testanzeigen verwenden

    Verwenden Sie beim Entwickeln und Testen Ihrer Apps Testanzeigen anstelle von Live-Anzeigen. Andernfalls kann es zu einer Kontosperrung kommen.

    Testanzeigen lassen sich am einfachsten laden, wenn Sie unsere spezielle Testanzeigenblock-ID für Android-Anzeigen mit Prämie verwenden:

    ca-app-pub-3940256099942544/5224354917

    Sie ist speziell dafür konfiguriert, für jede Anfrage Testanzeigen zurückzugeben. Sie können sie also beim Programmieren, Testen und Debuggen in Ihren eigenen Apps verwenden. Denken Sie daran, sie vor der Veröffentlichung Ihrer App durch Ihre eigene Anzeigenblock-ID zu ersetzen.

    Weitere Informationen zur Funktionsweise von Testanzeigen im Google Mobile Ads SDK (Beta) finden Sie unter Testanzeigen.

    Anzeige laden

    Rufen Sie zum Laden einer Anzeige mit Prämie die statische Methode RewardedAd load() auf und übergeben Sie ein AdLoadCallback<RewardedAd>, um die geladene Anzeige oder mögliche Fehler zu erhalten.

    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 Google Mobile Ads SDK (beta).
    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 = "ca-app-pub-3940256099942544/5224354917"
  }
}

    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 = "ca-app-pub-3940256099942544/5224354917";
  private RewardedAd rewardedAd;

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

    // Load ads after you initialize Google Mobile Ads SDK (beta).
    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;
          }
        }
    );
  }
}

    RewardedAdEventCallback festlegen

    Die RewardedAdEventCallback verarbeitet Ereignisse im Zusammenhang mit der Anzeige Ihrer RewardedAd. Bevor Sie die Anzeige mit Prämie präsentieren, 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 zu präsentieren. Verwende ein OnUserEarnedRewardListener-Objekt, um Prämienevents 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 das Google Mobile Ads SDK (Beta) die OnInitializationCompleteListener auf, auch wenn die Initialisierung in einem Vermittlungsnetzwerk 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, fordert das Google Mobile Ads SDK (Beta) trotzdem eine Anzeige von diesem Netzwerk an. Wenn die Initialisierung eines Vermittlungsnetzwerks also nach dem Zeitlimit abgeschlossen wird, können damit in dieser Sitzung weiterhin zukünftige Anzeigenanfragen bedient werden.

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

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

    AdapterStatus.getDescription() beschreibt, warum ein Adapter nicht bereit ist, Anzeigenanfragen zu verarbeiten.

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

    Bei Google-Anzeigen erfolgen alle onUserEarnedReward()-Aufrufe vor onAdDismissedFullScreenContent(). Bei Anzeigen, die über die Vermittlung ausgeliefert werden, wird die Reihenfolge der Rückrufe durch die Implementierung des SDK des Drittanbieter-Werbenetzwerks bestimmt. Bei SDKs von Werbenetzwerken, die einen einzelnen Schließ-Callback mit Informationen zu Prämien 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 Google Mobile Ads SDK (Beta) zu demonstrieren.