Integrieren von zwischengeschalteten und belohnten Anzeigen

Überblick

Über zwischengeschaltete Werbung

Zwischengeschaltete Werbungen 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: Schließen Sie die Basis-Plugin-Integration ab

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

Schritt 2. Implementieren Sie Event-Handler (Optional)

Event-Handler können für alle fünf Vungle SDK-Ereignisse eingerichtet werden, die die Werbepräsentation betreffen.

• Folgendes Ereignis wird ausgelöst, wenn das SDK ein Werbevideo wiedergibt. Dies ist eine gute Gelegenheit, um Spiele, Audioeffekte, Animationen usw. pausieren zu lassen.
  

  public static event Action onAdStartedEvent;

• Folgendes Ereignis wird ausgelöst, wenn das SDK ein Werbevideo schließt. Dies ist eine gute Gelegenheit, Ihren Nutzer zu belohnen und die Wiedergabe von Spielen, Audioeffekten, Animationen etc. wiederaufzunehmen.
  

  public static event Action<string, AdFinishedEventArgs> onAdFinishedEvent;

  Die Klasse AdFinishedEventArgs besitzt folgende Eigenschaften, mit denen Sie das Ergebnis einer abgespielten Werbeanzeige überprüfen können:
  

  public class AdFinishedEventArgs : EventArgs
  {
    //Represents a BOOL whether or not the user clicked the download button.
    public bool WasCallToActionClicked{ get; set;}
  
    //Represents a bool whether or not the video can be considered a completed view.
    public bool IsCompletedView{ get; set;}
  }

• Folgendes Ereignis wird ausgelöst, wenn das SDK den Verfügbarkeitsstatus der Werbung geändert hat. Der isAdPlayable-Boolean gibt die neue Wiedergabebereitschaft einer bestimmten placementID an.
  

  public static event Action<string, bool> adPlayableEvent;

  Weitere Details finden Sie im Abschnitt "Werbeanzeigen-Verfügbarkeit für eine Platzierung überprüfen".
• Folgendes Ereignis wird ausgelöst, wenn das SDK erfolgreich initialisiert wurde.
  

  public static event Action onInitializeEvent;

Beispielcode:

void initializeEventHandlers()
{
    Vungle.onAdStartedEvent += (placementID) => {
        DebugLog ("Ad " + placementID + " is starting!  Pause your game  animation or sound here.");
    };

    Vungle.onAdFinishedEvent += (placementID, args) => {
        DebugLog ("Ad finished - placementID " + placementID + ", was call to action clicked:" + args.WasCallToActionClicked +  ", is completed view:"
                  + args.IsCompletedView);
    };

    Vungle.adPlayableEvent += (placementID, adPlayable) => {
        DebugLog ("Ad's playable state has been changed! placementID " + placementID + ". Now: " + adPlayable);
    };

    Vungle.onInitializeEvent += () => {
        adInited = true;
        DebugLog ("SDK initialized");
    };
}

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

Laden einer Werbung für eine Platzierung

Rufen Sie für alle Platzierungen die loadAd()-Methode auf, um eine Werbung zu laden.

public static void loadAd(string placementID)

Stellen Sie sicher, dass Sie die placementID verwenden, die mit der richtigen Plattform verknüpft ist.

Beispielcode:

string placementID;
#if UNITY_IPHONE
  placementID = "ios_placement_id";
#elif UNITY_ANDROID
  placementID = "android_placement_id";
#elif UNITY_WSA_10_0 || UNITY_WINRT_8_1 || UNITY_METRO
  placementID = "windows_placement_id";
#endif
  Vungle.loadAd(placementID);

Prüfen der Werbungsverfügbarkeit für eine Platzierung

Sobald das SDK erfolgreich eine Werbung für eine Platzierung gecacht hat, wird das folgende Event aufgerufen:

public static event Action<string, bool> adPlayableEvent;

Beispielcode:

Vungle.adPlayableEvent += (placementID, adPlayable) => {
  if(placementID == "ios_placement_id") {
    playButtonPlacement1.enabled = adPlayable;
  }
};

Hinweis: Bei Cache-optimierten Platzierungen wird dieses Ereignis nur aufgerufen, wenn eine Werbung verfügbar wird. Bei optimierten Platzierungen erfolgt ein automatischer Füllversuch ohne weitere Handlungen. Bei allen anderen Platzierungen wird das Ereignis auch im Fall von "Load Failed" aufgerufen (adPlayable gibt in diesem Fall false zurück).

Sie können die Werbungsverfügbarkeit für eine Platzierung auch mit folgender Methode überprüfen:

public static bool isAdvertAvailable(string placementID);

Abspielen einer Werbung

Wichtig: Spielen Sie keine Werbung ab, bevor die oben beschriebene adPlayableEvent-Funktion wieder den Wert "true" angenommen hat. Wenn Sie Werbung abspielen, bevor adPlayableEvent wieder "true" ist, wird beim Versuch, die Werbung zu laden, die Systemleistung des Benutzers beeinträchtigt. Wenn Sie für Android entwickeln, verwenden Sie stattdessen den von isAdvertAvailable() zurückgegebenen Wert, um die Verfügbarkeit der Werbung zu bestätigen (da adPlayableEvent nicht "false" zurückgibt, wenn keine Werbung verfügbar ist).

Nachdem eine Werbung zur Platzierung bereitsteht, können Sie sie über die folgende Methode abspielen:

public static void playAd(string placementID);

Beispielcode:

Vungle.playAd(placementID);