Interstitial-Anzeigen


Interstitial-Anzeigen sind Vollbildanzeigen, die die Benutzeroberfläche einer App überlagern, bis sie vom Nutzer geschlossen werden. Sie werden normalerweise an natürlichen Übergangspunkten in den Ablauf einer App, zum Beispiel zwischen Aktivitäten oder während der Pause zwischen Level in einem Spiel. Wenn in einer App eine Interstitial-Anzeige eingeblendet wird, kann der Nutzer entweder auf die Anzeige tippen und zum Ziel weitergeleitet werden oder sie schließen und zur App zurückkehren. Fallstudie

In diesem Leitfaden erfahren Sie, wie Sie Interstitial-Anzeigen in Android- und iOS-Apps einbinden. mit dem Google Mobile Ads C++ SDK.

Vorbereitung

Immer mit Testanzeigen testen

Verwenden Sie beim Entwickeln und Testen Ihrer Apps nur Testanzeigen, Live-Produktionsanzeigen. Andernfalls kann Ihr Konto gesperrt werden.

Die einfachste Methode zum Laden von Testanzeigen ist die Verwendung unserer speziellen Test-Anzeigenblock-ID für Interstitials, die je nach Geräteplattform variieren:

  • Android: ca-app-pub-3940256099942544/1033173712
  • iOS: ca-app-pub-3940256099942544/4411468910

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 jedoch vor dem Veröffentlichen Ihrer

Weitere Informationen zur Funktionsweise von Testanzeigen des Mobile Ads SDK finden Sie unter Testanzeigen:

Implementierung

Die wichtigsten Schritte zur Integration von Interstitial-Anzeigen sind:

  1. Laden Sie eine Anzeige.
  2. Registrieren Sie sich für Rückrufe.
  3. Die Anzeige einblenden und ihre Lebenszyklus-Ereignisse verarbeiten

InterstitialAd konfigurieren

Interstitial-Anzeigen werden in InterstitialAd Objekten ausgeliefert. Im ersten Schritt zur Integration von Interstitial-Anzeigen in Ihre App ist das Erstellen und Initialisieren eines InterstitialAd-Objekt.

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

     #include "firebase/gma/interstial_ad.h"

  2. Deklarieren und instanziieren Sie ein InterstitialAd-Objekt:

     firebase::gma::InterstitialAd* interstitial_ad;
     interstitial_ad = new firebase::gma::InterstitialAd();

  3. Initialisieren Sie die Instanz InterstitialAd mithilfe Ihrer übergeordneten Ansicht, die in einen Typ AdParent. Die übergeordnete Ansicht ist eine JNI-jobject-Referenz zu einem Android- Activity oder einen Verweis auf 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 = interstitial_ad->Initialize(ad_parent);
    
  4. Anstatt das Future als Variable beizubehalten, können Sie den Status des Initialisierungsvorgangs durch Aufrufen von InitializeLastResult() für das InterstitialAd-Objekt. Das könnte hilfreich sein zur Nachverfolgung des Initialisierungsprozesses in der globalen Spielschleife.

    // Monitor the status of the future in your game loop:
    firebase::Future<void> result = interstitial_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 der Methode überwachen Anrufe

Anzeige laden

Das Laden einer Anzeige erfolgt mit der LoadAd()-Methode auf der InterstitialAd-Objekt. Die Lademethode setzt voraus, dass Sie den InterstitialAd-Objekt enthält und Sie Ihre Anzeigenblock-ID und ein AdRequest-Objekt haben. -Objekt enthält. Es wird ein firebase::Future zurückgegeben, mit dem Sie den Status überwachen können. und das Ergebnis des Ladevorgangs.

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

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

Für Rückrufe registrieren

Sie müssen die FullScreenContentListener-Klasse erweitern, um Benachrichtigungen zur Präsentation von Interstitial-Anzeigen und zu Lebenszyklus-Ereignissen Ihr individuelles Die abgeleitete FullScreenContentListener-Klasse kann über die InterstitialAd::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* full_screen_content_listener =
    new ExampleFullScreenContentListener();
  interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);

InterstitialAd ist ein Objekt zur einmaligen Verwendung. Sobald eine Interstitial-Anzeige angezeigt wird, kann sie nicht erneut angezeigt werden. Es empfiehlt sich, eine weitere Interstitial-Anzeige in der Methode OnAdDismissedFullScreenContent() Ihrer FullScreenContentListener, damit die nächste Interstitial-Anzeige sobald die vorherige geschlossen wurde.

Anzeige einblenden

Interstitials sollten in natürlichen Pausen einer App eingeblendet werden. Ein gutes Beispiel ist zwischen den Leveln eines Spiels oder nachdem der Nutzer eine Aufgabe abgeschlossen hat. Mit FullScreenContentListener lässt sich zwar ermitteln, Vollbildinhalt angezeigt wird, signalisiert die von Show() zurückgegebene Zukunft ebenfalls wenn die Anzeige ausgeliefert wurde.

  firebase::Future<void> result = interstitial_ad->Show();

Best Practices

Überlegen Sie, ob Interstitial-Anzeigen der richtige Anzeigentyp für Ihre App sind.
Interstitial-Anzeigen funktionieren am besten in Apps mit natürlichen Übergangspunkten. Die Abschluss einer Aufgabe in einer App, z. B. das Teilen eines Bildes oder das Abschließen eines Spiels einen solchen Punkt erstellt. Da der Nutzer eine Pause im können Sie eine Interstitial-Anzeige präsentieren, ohne die Nutzererfahrung. Überlegen Sie genau, an welchen Stellen im Workflow Ihrer App Sie Display-Interstitial-Anzeigen und die Wahrscheinlichkeit, dass der Nutzer darauf reagiert.
Pausieren Sie die Aktion, wenn eine Interstitial-Anzeige eingeblendet wird.
Es gibt verschiedene Arten von Interstitial-Anzeigen: Text-, Bild-, Video und mehr. Wenn in Ihrer App ein Interstitial-Anzeige aktiviert, setzt sie auch die Nutzung einiger Ressourcen aus, damit die Anzeige und sie für sich zu nutzen. Wenn Sie beispielsweise die Anzeige eines Interstitial-Anzeige verwenden, unterbrechen Sie die Audioausgabe in Ihrer App. Du kannst die Wiedergabe von Tönen mit der OnAdDismissedFullScreenContent-Methode von Ihre installierte FullScreenContentListener, die aufgerufen wird, wenn der Nutzer die Interaktion mit der Anzeige beendet hat. Außerdem sollten Sie erwägen, aufwendige Rechenaufgaben (z. B. eine Spielschleife) während der Auslieferung der Anzeige angezeigt. So wird sichergestellt, dass der Nutzer keine nicht reagierende Grafiken oder ruckelige Videos.
Achten Sie auf eine ausreichende Ladezeit.
Die Interstitial-Anzeigen sollten zur richtigen Zeit geeignet, ist es auch wichtig, dass die Nutzenden nicht warten müssen, damit sie geladen werden. Wenn Sie die Anzeige vor der Auslieferung laden, dass in Ihrer App eine vollständig geladene Interstitial-Anzeige bereitsteht, zur Präsentation einer.
Überschwemmen Sie Nutzer nicht mit Anzeigen.
Es mag auf den ersten Blick scheinen, die Häufigkeit von Interstitial-Anzeigen in Ihrer App zu erhöhen. eine gute Möglichkeit, den Umsatz zu steigern, kann dies auch die Nutzererfahrung beeinträchtigen. und niedrigere Klickraten. Achten Sie darauf, dass Nutzende nicht so häufig wurde unterbrochen, dass sie deine App nicht mehr nutzen können.
Verwenden Sie zum Einblenden der Interstitial-Anzeige nicht die Funktion für den Abschluss des Ladevorgangs.
Dies kann zu einer schlechten Nutzererfahrung führen. Laden Sie die Anzeige stattdessen im Voraus, um sie anzuzeigen.

Zusätzliche Ressourcen

Beispiel in GitHub

Videoanleitungen der Mobile Ads Garage

Erfolgsgeschichten

Nächste Schritte