Banner- und MREC-Anzeigen integrieren

Überblick

Vungle unterstützt die folgenden drei Bannergrößen und die Standard-MREC-Größe.

Informationen zu Banneranzeigen

Vungle Banner befindet sich derzeit in der BETA-Phase. Wenden Sie sich für den Zugang direkt an Ihren Kontomanager, um einen erfolgreichen Start zu gewährleisten.

Das Vungle Unity-Plugin unterstützt Banner- und MREC-Anzeigen, und zwar ab Vungle SDK für Unity v6.7.0.0 . Für dieses Anzeigenformat ist kein Vollbild erforderlich; stattdessen bestimmt der Publisher die Position des Anzeigencontainers innerhalb seiner Anwendung. Die Größe des Bannercontainers muss jedoch entweder 320x50, 300x50 oder 728x90 (für Tablets) betragen. Sie können Banneranzeigen an einer beliebigen Stelle auf dem Bildschirm platzieren, und der Benutzer kann die App während der Wiedergabe der Anzeige weiter nutzen. Die Auflistung der verschiedenen Bannergrößen finden Sie unter der VungleSDK.h Datei (ebenfalls in der nachstehenden Tabelle beschrieben).

Sie sind nicht auf die Anzahl der Nicht-Vollbild-Anzeigen zu einem bestimmten Zeitpunkt beschränkt, aber das Plugin prüft nicht, ob mehrere Anzeigen an einer Position angezeigt werden. Stellen Sie sicher, dass Sie eine Anzeige für jede von unserem Plugin bereitgestellte Position aufrufen und stellen Sie auch sicher, dass sie sich nicht überschneiden, falls Sie mehr als eine Anzeige anzeigen wollen.

Der Platzierungstyp für Bannerwerbung muss vom Typ „Banner“ im Vungle-Dashboard sein. Wenden Sie sich an Ihren Kundenbetreuer, um die Bannerplatzierung auf dem Dashboard zu ermöglichen.

Informationen zu MREC-Anzeigen

Ab Vungle SDK v6.4.3 unterstützt Vungle MREC-Videoanzeigen. MREC ist eine Abkürzung für „Medium Rectangle“-Anzeigen. Im Gegensatz zu zwischengeschalteten Anzeigen ist für MREC-Anzeigen keine Vollbildansicht erforderlich. Ähnlich wie Banner-Anzeigen sind MREC-Videoanzeigen rechteckige Anzeigen, die an einer beliebigen Stelle im Layout der Anwendung platziert werden und in der Regel oben oder unten auf dem Bildschirm angezeigt werden, sodass der Benutzer während ihrer Wiedergabe weiterhin mit der Anwendung interagieren kann. Die Containergröße zum Rendern einer MREC-Anzeige entspricht dem Industriestandard: 300x250.

Schritt 1: Schließen Sie die Basis-Plugin-Integration ab

Um Banner- und MREC-Anzeigen 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;

• 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: Laden, Abspielen und Schließen einer-Anzeige

Laden einer Anzeige

Das Laden einer Nicht-Vollbildanzeige funktioniert anders als bei Vollbildanzeigen, und es gibt eine spezielle loadBanner-API, die Sie zum Laden verwenden. Sie müssen die Größe und Position der Nicht-Vollbildanzeige angeben, die Sie laden wollen, und das SDK aktualisiert sie automatisch mit dem Zeitintervall, das Sie auf dem Dashboard konfiguriert haben. Sie müssen Platzierungen verwenden, die speziell für Banner- oder MREC-Anzeigen erstellt wurden.

Laden Sie eine Nicht-Vollbild-Werbeanzeige, indem Sie die folgende loadBanner-Methode aufrufen:

Vungle.loadBanner("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner, Vungle.VungleBannerPosition.BottomCenter);

Anzeigen einer Anzeige

Die Nicht-Vollbild-Anzeigen werden an der Position in der Größe angezeigt, die Sie beim Aufruf von loadBanner angegeben haben, wenn Sie showBanner aufrufen.

Vungle.showBanner("PLACEMENT_ID");

Wir empfehlen Ihnen, die Verfügbarkeit von Anzeigen zu prüfen, bevor Sie versuchen, eine Anzeige abzuspielen, wobei isAdvertAvailable wie Vollbild-Anzeigen verwendet werden kann. Bei Nicht-Vollbild-Anzeigen müssen Sie jedoch zusätzlich zur Platzierungs-ID der Anzeige, die Sie anzeigen möchten, VungleBannerSize angeben.

Vungle.isAdvertAvailable("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner);

Schließen einer Anzeige

Sie können closeBanner aufrufen, wenn Sie eine Nicht-Vollbildanzeige ablehnen möchten.

Vungle.closeBanner("PLACEMENT_ID");