Integrieren Sie zwischengeschaltete und belohnte Anzeigen

Überblick

Über zwischengeschaltete Werbung

Zwischengeschaltete Werbung sind bildschirmfüllende Werbeanzeigen, die die Fläche Ihrer App ausfüllen. Sie werden normalerweise an natürlichen Übergangspunkten im Ablauf Ihrer App angezeigt, z. B. zwischen Aktivitäten oder während der Pause zwischen den einzelnen Levels in einem Spiel. Einige zwischengeschaltete Anzeigen sind belohnte Anzeigen.

Über belohnte Werbung

Belohnte Anzeigen sorgen für ein positives Benutzererlebnis, indem sie den Nutzern etwas Nützliches als Gegenleistung dafür bieten, dass sie sich eine Werbeanzeige anzuschauen bzw. sich mit ihr beschäftigen. Dieser Tausch ist in der Regel eine Belohnung innerhalb Ihrer App, wie z. B. zusätzliche „Leben“ in einem Spiel, virtuelle Währung oder ein Tipp in einem Rätsel (Art und Höhe der Belohnung bestimmen Sie). In natürlichen Pausen in der App angezeigt, generieren belohnte Videoanzeigen hohe Einnahmen, insbesondere wenn Sie unserer Empfehlung folgen, sie nicht überspringen zu lassen.  

Beachten Sie, dass belohnte Anzeigen (rewarded ads) im Englischen mitunter auch als incentivized bezeichnet werden. Beide Begriffe stehen für dieselbe Form von Werbeanzeige. Im SDK-Code und in unserer Reporting-API verwenden wir den Begriff „incentiviert”.

Es gibt zwei Möglichkeiten, belohnte Anzeigen zu integrieren: In-App-Belohnungen (empfohlen und weiter unten beschrieben) oder sogenannte Server-to-Server callbacks (siehe unseren FAQ-Artikel zu diesem Thema). Mit In-App-Belohnungen können Sie, wenn ein Benutzer eine Anzeigenansicht erfolgreich abschließt oder auf den Download-Button klickt, diese direkt in Ihrer App belohnen. Der Hauptvorteil dieses Ansatzes liegt in ihrer einfachen Implementierung.

Vungle bietet inzwischen eine Vielzahl an Werbeformaten mit Dynamic Template-Werbungen. Gegenüber dem klassischen Werbeformat, bei dem eine Werbewiedergabe aus einer Videowiedergabe gefolgt von einer End-Karte besteht, bieten wir Vorlagen, bei denen der Call-to-Action (Aufruf zur Aktion, CTA) während der Videowiedergabe bereitsteht. Nutzer, die die Videowerbung vollständig abschließen sowie solche Nutzer, die auf die Schaltfläche klicken, sollten belohnt werden.

Schritt 1: Vollständige Basisintegration

Um zwischengeschaltete Werbung in Ihre Android- oder Amazon-App zu integrieren, befolgen Sie zunächst die Anweisungen im Artikel zum Thema Basisintegration. Dieser Artikel enthält ergänzende Informationen und setzt voraus, dass Sie die Basisintegration bereits abgeschlossen haben.

Schritt 2. Implementieren Sie Event Listener

Sie können generische Callbacks nutzen, indem Sie LoadAdCallback zum Laden von Ereignissen implementieren und PlayAdCallback zum Abspielen von Werbung, oder Inline-Callbacks verwenden, wenn Sie loadAd und playAd aufrufen.

LoadAdCallback

private final LoadAdCallback vungleLoadAdCallback = new LoadAdCallback() { 
  @Override
  public void onAdLoad(String id) { 
    // Ad has been successfully loaded for the placement
  } 

  @Override 
  public void onError(String id, VungleException exception) { 
    // Ad has failed to load for the placement
  }
};

// 6.4.x & below
private final LoadAdCallback vungleLoadAdCallback = new LoadAdCallback() { 
  @Override
  public void onAdLoad(String id) { 
    // Ad has been successfully loaded for the placement
  } 

  @Override 
  public void onError(String id, Throwable throwable) { 
    // Ad has failed to load for the placement
  }
};

PlayAdCallback

private final PlayAdCallback vunglePlayAdCallback = new PlayAdCallback() {
  @Override
  public void onAdStart(String id) { 
    // Ad experience started
  }

  @Override
  public void onAdEnd(String id) {
    // Ad experience ended
  }

  @Override
  public void onAdClick(String id) {
    // User clicked on ad
  }

  @Override
  public void onAdRewarded(String id) {
    // User earned reward for watching an ad
  }

  @Override
  public void onAdLeftApplication(String id) {
    // User has left app during an ad experience
  }

  @Override
  public void onError(String id, VungleException exception) { 
    // Ad failed to play
  }
};

// 6.5.x & below
private final PlayAdCallback vunglePlayAdCallback = new PlayAdCallback() { 
  @Override 
  public void onAdStart(String placementReferenceId) {
    // Ad experience started
  } 

  // Deprecated
  @Override
  public void onAdEnd(String placementReferenceId, boolean completed, boolean isCTAClicked) {
    // Invoked when the ad experience is completed
    // isCTAClicked flag indicates whether CTA download button has been triggered
    // completed flag will indicate whether user has watched 80% of video or longer.
  }

  @Override 
  public void onError(String placementReferenceId, VungleException exception) {
// Ad failed to play
}
};

Schritt 3. So laden Sie eine Werbung und spielen sie ab

Laden einer Werbung für eine Platzierung

Das LoadAdCallback wird über den Lastenzustand des ihm zugewiesenen Aufrufs informiert. Das SDK nimmt diesen Callback nur als Referenz und speichert ihn nicht. Die korrekte Verwaltung des Callbacks liegt in der Verantwortung des Aufrufenden.

public static void loadAd(@NonNull final String id, @Nullable LoadAdCallback callback)

// Load Ad Implementation
if (Vungle.isInitialized()) {
  Vungle.loadAd("PLACEMENT_ID", new LoadAdCallback() {
    @Override
    public void onAdLoad(String placementReferenceId) { }

    @Override
    public void onError(String placementReferenceId, VungleException exception) { }
  });
}

So überprüfen Sie die Werbungsverfügbarkeit für eine Platzierung

Verwenden Sie die statische Methode canPlayAdmethod zur Überprüfung, ob eine Werbung abspielbar zur Platzierung verfügbar ist, bevor Sie die playAd-Methode ausführen.

public static boolean canPlayAd(@NonNull String id)

Abspielen einer Werbung

Zum Abspielen einer Werbung aktivieren Sie die playAd-Methode mit der Referenz-ID für die Platzierung. ID, optional AdConfig (Null, wenn nicht verwendet), und einen PlayAdCallback-Event Listener, der über Erfolg oder Fehler beim Abspielen der Werbung benachrichtigt wird.

public static void playAd(@NonNull final String id, final AdConfig settings, @Nullable final PlayAdCallback listener)

Sie sollten die Verfügbarkeit von Werbung stets überprüfen, indem Sie die canPlayAd-Methode aufrufen, bevor Sie die playAd-Methode aktivieren. Da die Werbung nicht korrekt gerendert wird, wenn playAd wiederholt in schneller Folge aufgerufen wird, müssen Sie sich auch vergewissern, dass Sie entweder einen onAdEnd- oder einen onError-Callback vom ursprünglichen playAd-Call erhalten, bevor Sie einen zusätzlichen playAd starten.

if (Vungle.canPlayAd("PLACEMENT_ID")) { 
  Vungle.playAd("PLACEMENT_ID", null, new PlayAdCallback() { 
    @Override public void onAdStart(String placementReferenceId) { } 
    @Override public void onAdEnd(String placementReferenceId, boolean completed, boolean isCTAClicked) { } 
    @Override public void onError(String placementReferenceId, VungleException exception) { } 
  });
}

Schritt 4: So konfigurieren Sie alle Vollbildanzeigen (optional)

Sie haben die Möglichkeit, Werbung durch Angabe eines neuen adConfig-Objekts für playAd individuell anzupassen. Wenn das AdConfig-Objekt Null ist , wird die Werbung mit der Standardkonfiguration abgespielt. Wenn es nicht Null ist, überschreibt es die AdConfig-Einstellung. Es folgt ein Beispiel zur Anwendung von AdConfig:

Vungle.playAd(placementReferenceID, adConfig, vunglePlayAdCallback);

Im obigen Beispiel wird das Objekt adConfig verwendet, das angepasste Konfigurationsoptionen enthält. Definieren Sie das Objekt AdConfig wie angezeigt:

AdConfig adConfig = new AdConfig();
adConfig.setAdOrientation(AdConfig.AUTO_ROTATE);
adConfig.setMuted(true);
Vungle.playAd(placementReferenceID, adConfig, vunglePlayAdCallback);

In der folgenden Tabelle werden die verfügbaren AdConfig-Optionen aufgelistet:

Hinweis: Sie können dasselbe AdConfig-Objekt für mehrere Werbungen verwenden.

Schritt 5. So passen Sie belohnte Werbung an (Optional)

Pop-Up-Nachrichten-Dialog

Der Popup-Dialog für belohnte Werbung kann mit dem setIncentivizedFields-Objekt konfiguriert werden.

public static void setIncentivizedFields(@Nullable String userID, @Nullable String title, @Nullable String body, @Nullable String keepWatching, @Nullable String close)

Überlegungen zum Belohnungsanreiz

Es gibt keinen Standard für die Belohnung von Benutzern. Ihre Entscheidung hängt davon ab, wie Ihre Spieleökonomie funktioniert. Der Anreiz sollte für den Benutzer gerade groß genug sein, dass die Videooption attraktiv ist, jedoch nicht so viel, dass diese Belohnung einen IAP-Kauf ersetzt. Wichtig ist auch, dass bei belohnten Videos ein Daily View Cap platziert wird; dadurch wird die Anzahl der Belohnungen pro Benutzer begrenzt.

Hier sind ein paar Fragen, die Sie sich stellen sollten, wenn Sie über die geeignete Höhe der Belohnung nachdenken:

1. Was ist für den Benutzer nützlicher: „weiche“ oder „harte“ Währung?
   Weiche Währung ist kostengünstiger zu verschenken, allerdings sind die Benutzer vielleicht eher geneigt, sich ein Video zu einem Artikel anzusehen, den sie umgehend auch verwenden können. Sie können das belohnte Video auch dazu benutzen, dem Benutzer neue Artikel vorzustellen und ihn so zum späteren Kauf des IAP zu animieren.
2. Wie verlockend ist die Belohnung für den Benutzer?
   Sie wollen sicherstellen, dass die Belohnung etwas ist, das der Nutzer tatsächlich gebrauchen kann als nützlich empfindet und zugleich nicht leicht zu bekommen ist.
3. Wie verhält sich die Belohnung im Vergleich zum gängigsten IAP?
   Sie möchten, dass die Belohnung das Sprungbrett zu diesem IAP ist, oder etwas, das der Benutzer vielleicht besitzen möchte, aber nie kauft.
4. Wie steht die Belohnung im Vergleich zu dem, was der Benutzer im Durchschnitt durch das Spielen des Spiels verdient?
   Falls der Benutzer die gleiche Belohnung allein durch das Spielen eines einzigen Levels verdient, kann es sein, dass er nicht der Meinung ist, dass die Belohnung 15 Sekunden seiner Zeit wert sein könnte.
5. Sollte ich die Anzahl der Belohnungen pro Benutzer und Tag begrenzen?
   Ja. Die Festlegung eines täglichen Limits kann Ihnen dabei helfen, zu kontrollieren, wie viele Gratisartikel/Münzen der Benutzer verdienen kann.

Unser Kundenbetreuungsteam steht Ihnen ebenfalls zur Verfügung. Schicken Sie uns eine E-Mail an monetize@vungle.com.