Anzeigen mit Prämie

<ph type="x-smartling-placeholder">


Anzeigen mit Prämie bieten Nutzern die Möglichkeit, im Gegenzug mit ihnen zu interagieren. um In-App-Prämien zu erhalten. In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Mobile Ads C++ SDK Anzeigen mit Prämie in Android- und iOS-Apps einbinden.

Lesen Sie einige Erfolgsgeschichten von Kunden: Fallstudie 1, Fallstudie 2.

Vorbereitung

Immer mit Testanzeigen testen

Verwenden Sie beim Erstellen und Testen Ihrer Apps Testanzeigen anstelle von aktiven Produktionsanzeigen. Andernfalls kann Ihr Konto gesperrt werden.

Die einfachste Methode zum Laden von Testanzeigen ist die Verwendung unserer speziellen Test-Anzeigenblock-ID für Anzeigen mit Prämie (variiert je nach Geräteplattform):

  • Android: ca-app-pub-3940256099942544/5224354917
  • iOS: ca-app-pub-3940256099942544/1712485313

Sie wurden speziell so konfiguriert, dass bei jeder Anfrage Testanzeigen zurückgegeben werden. können Sie es 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 zur Funktionsweise von Testanzeigen im Mobile Ads SDK finden Sie unter Testanzeigen.

Implementierung

Die wichtigsten Schritte zur Integration von Anzeigen mit Prämie sind:

  1. Laden Sie eine Anzeige.
  2. Registrieren Sie sich für Rückrufe.
  3. Blenden Sie die Anzeige ein und verarbeiten Sie das Prämienereignis.

RewardedAd konfigurieren

Anzeigen mit Prämie werden in RewardedAd Objekten angezeigt. Der erste Schritt zur zur Integration von Anzeigen mit Prämie in Ihre App ist das Erstellen und Initialisieren einer Instanz, von RewardedAd.

  1. Fügen Sie dem C++-Code Ihrer App den folgenden Header hinzu: 

     #include "firebase/gma/rewarded_ad.h"

  2. Deklarieren und instanziieren Sie ein RewardedAd-Objekt: 

     firebase::gma::RewardedAd* rewarded_ad;
 rewarded_ad = new firebase::gma::RewardedAd();

  3. Initialisieren Sie die RewardedAd-Instanz mit Ihrer übergeordneten Ansicht, die in einen AdParent-Typ umgewandelt wurde. Die übergeordnete Ansicht ist eine JNI-jobject-Referenz auf eine Android-Activity oder ein iOS-UIView.

    // my_ad_parent is a jobject reference to an Android Activity or
// a pointer to an iOS UIView.
firebase::gma::AdParent ad_parent =
  static_cast<firebase::gma::AdParent>(my_ad_parent);
firebase::Future<void> result = rewarded_ad->Initialize(ad_parent);

  4. Anstatt die Future-Funktion als Variable zu speichern, können Sie den Status des Initialisierungsvorgangs auch regelmäßig prüfen, indem Sie InitializeLastResult() auf das RewardedAd-Objekt anwenden. Das kann hilfreich sein, um den Initialisierungsprozess in Ihrer globalen Spielschleife im Blick zu behalten.

    // Monitor the status of the future in your game loop:
firebase::Future<void> result = rewarded_ad->InitializeLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  // Initialization completed.
  if(future.error() == firebase::gma::kAdErrorCodeNone) {
    // Initialization successful.
  } else {
    // An error has occurred.
  }
} else {
  // Initialization on-going.
}

Weitere Informationen zur Arbeit mit firebase::Future finden Sie unter Mit Futures den Abschlussstatus von Methodenaufrufen überwachen.

Anzeige laden

Anzeigen werden mit der Methode LoadAd() für ein RewardedAd-Objekt geladen. Für die Lademethode ist es erforderlich, dass RewardedAd initialisiert wurde. Außerdem müssen Sie eine Anzeigenblock-ID und ein AdRequest-Objekt haben. Es wird eine firebase::Future zurückgegeben, mit der Sie den Status und das Ergebnis des Ladevorgangs überwachen können.

Der folgende Code zeigt, wie eine Anzeige geladen wird, nachdem RewardedAd erfolgreich initialisiert:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = rewarded_ad->LoadAd(rewarded_ad_unit_id, ad_request);

Für Rückrufe registrieren

Sie müssen die FullScreenContentListener-Klasse erweitern, um Benachrichtigungen zur Präsentation von Anzeigen mit Prämie und zu Lebenszyklus-Ereignissen Ihr individuelles Die abgeleitete FullScreenContentListener-Klasse kann über die RewardedAd::SetFullScreenContentListener() an und es wird Rückrufe, wenn die Anzeige erfolgreich oder nicht geschaltet wird, sowie wird er geschlossen.

Der folgende Code zeigt, wie die Klasse erweitert und der Anzeige zugewiesen wird:

  class ExampleFullScreenContentListener
      : public firebase::gma::FullScreenContentListener {

   public:
    ExampleFullScreenContentListener() {}

    void OnAdClicked() override {
      // This method is invoked when the user clicks the ad.
    }

    void OnAdDismissedFullScreenContent() override {
     // This method is invoked when the ad dismisses full screen content.
    }

    void OnAdFailedToShowFullScreenContent(const AdError& error) override {
      // This method is invoked when the ad failed to show full screen content.
      // Details about the error are contained within the AdError parameter.
    }

    void OnAdImpression() override {
      // This method is invoked when an impression is recorded for an ad.
    }

    void OnAdShowedFullScreenContent() override {
      // This method is invoked when the ad showed its full screen content.
    }
  };

  ExampleFullScreenContentListener* example_full_screen_content_listener =
    new ExampleFullScreenContentListener();
  rewarded_ad->SetFullScreenContentListener(example_full_screen_content_listener);

RewardedAd ist ein Objekt zur einmaligen Verwendung. Das bedeutet, dass eine Anzeige mit Prämie, die einmal ausgeliefert wurde, nicht noch einmal ausgeliefert werden kann. Es empfiehlt sich, eine weitere Anzeige mit Prämie zu laden, in der Methode OnAdDismissedFullScreenContent() Ihres FullScreenContentListener, damit die nächste Anzeige mit Prämie sofort geladen wird da die vorherige geschlossen wird.

Anzeige einblenden und Prämienereignis abwickeln

Bevor Sie Nutzern eine Anzeige mit Prämie präsentieren, müssen Sie ihnen die Möglichkeit geben, sich Anzeigeninhalte mit Prämie anzusehen. Mit Prämie Anzeigen müssen immer von Google aktiviert werden.

Wenn Sie Ihre Anzeige präsentieren, müssen Sie ein UserEarnedReward-Objekt angeben, um die Prämie für den Nutzer zu verarbeiten.

Der folgende Code zeigt, wie ein RewardedAd angezeigt wird:

// A simple listener track UserEarnedReward events.
class ExampleUserEarnedRewardListener :
    public firebase::gma::UserEarnedRewardListener {
 public:
   ExampleUserEarnedRewardListener() { }

  void OnUserEarnedReward(const firebase::gma::AdReward& reward) override {
    // Reward the user!
  }
};

ExampleUserEarnedRewardListener* user_earned_reward_listener =
  new ExampleUserEarnedRewardListener();
firebase::Future<void> result = rewarded_ad->Show(user_earned_reward_listener);

FAQ

Gibt es ein Zeitlimit für den Initialisierungsaufruf?
Nach 10 Sekunden schließt das Google Mobile Ads C++ SDK firebase::Future hat von Initialize() zurückgegeben, auch wenn ein Vermittlungsnetzwerk immer noch hat die Initialisierung nicht abgeschlossen.
Was passiert, wenn einige Vermittlungsnetzwerke noch nicht bereit sind, wenn ich den Callback zur Initialisierung erhalte?

Es wird empfohlen, Anzeigen zu laden, nachdem die SDK-Initialisierung abgeschlossen ist. Auch wenn kein Vermittlungsnetzwerk bereit ist, wird das Google Mobile Ads C++ SDK das Netzwerk dennoch um eine Anzeige bitten. Wenn die Initialisierung eines Vermittlungsnetzwerks also nach Ablauf der Zeitüberschreitung abgeschlossen ist, kann es weiterhin zukünftige Anzeigenanfragen in dieser Sitzung bearbeiten.

Sie können den Initialisierungsstatus aller Adapter während der gesamten App-Sitzung durch Aufrufen von GetInitializationStatus() abfragen.

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

AdapterStatus.description() gibt an, warum ein Adapter nicht bereit ist, Anzeigenanfragen zu bearbeiten. Im Quellcode unserer Beispiel-App für die Kurzanleitung auf GitHub finden Sie ein Beispiel für das Logging des Mediation-Adapter-Status.

Zusätzliche Ressourcen

Beispiel in GitHub