MREC-Anzeigen integrieren

Überblick

Vungle MREC 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.

Ab Vungle SDK v6.4.11 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: Vollständige Basisintegration

Um MREC-Anzeigen 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

Implementieren Sie die 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: Laden, Anzeigen und Schließen einer MREC-Anzeige

Laden einer MREC-Anzeige

Eine MREC-Anzeige wird wie eine Vollbildanzeige geladen; allerdings muss die Platzierung so eingestellt werden, dass sie MREC unterstützt. Wenden Sie sich an Ihren Vungle Account-Manager, um MREC für eine Platzierung zu aktivieren.

Anzeigen einer MREC-Anzeige

Da die Größe der Ansicht fest vorgegeben ist, muss der zur Ansicht der MREC-Anzeige verwendete Container mit 300dp x 250dp angegeben werden, und die Ansicht kann überall auf dem Bildschirm platziert werden. Dieser Container ist ein RelativeLayOut.

Sie können diese RelativeLayout an beliebiger Stelle auf dem Bildschirm platzieren. Sie müssen dann AdConfig.setAdSize aufrufen, um die Anzeigengröße auf AdConfig.AdSize.VUNGLE_MREC festzulegen, und dieses Objekt beim Aufruf von Vungle.getNativeAd übergeben, um das MREC-Anzeigenobjekt zu erhalten.

Rufen Sie schließlich die addView-Funktion auf, um den Container mit der MREC-Anzeige zu verknüpfen. Vungle MREC spielt mit standardmäßig aktiviertem Ton, aber Sie können die Option setMuted auf true setzen, um das Video stummgeschaltet zu starten.

private RelativeLayout mrecContainer = findViewById(...);

AdConfig adConfig = new AdConfig();
adConfig.setAdSize(AdConfig.AdSize.VUNGLE_MREC);
adConfig.setMuted(true);

VungleNativeAd vungleNativeAd = Vungle.getNativeAd("MREC_ID", adConfig, vunglePlayAdCallback);
View nativeAdView = vungleNativeAd.renderNativeView();
mrecContainer.addView(nativeAdView);

Schließen einer MREC-Anzeige

Da Sie die Ansicht der MREC-Anzeige der Container-Ansicht hinzugefügt haben, müssen Sie diese auch entfernen, falls die Anzeigensicht vom Bildschirm verschwindet, die Aktivität oder das Fragment zerstört werden oder der Container der übergeordneten Sicht wiederverwertet oder gelöscht wird. Wenn Sie versuchen, eine weitere MREC-Anzeige abzuspielen, ohne die vorherige Anzeige zu schließen, kann unerwartetes Verhalten Ihrer App die Folge sein. Rufen Sie daher finishDisplayingAd auf, um dieses Ereignis zu entfernen. Zudem empfehlen wir, das onAdEnd-Ereignis der Ansicht zu entfernen.

private VungleNativeAd vungleNativeAd;

// Calling finishDisplayingAd when you want to finish displaying MREC Ad
// will trigger onAdEnd and will tell you when you can remove the child
// MREC view container 
vungleNativeAd.finishDisplayingAd();

// And removing empty ad view from container
@Override 
public void onAdEnd(String id, boolean completed) {
    …
    parentView.removeView(nativeAdView);
    vungleNativeAd = null;
    …
}

Status einer MREC-Anzeige anfügen oder abtrennen

Falls der Benutzer zu einer Stelle blättert, an der das Video nicht mehr auf dem Bildschirm sichtbar ist, dann müssen Sie das Video anhalten und es fortsetzen, sobald es wieder sichtbar ist. Zur Steuerung von Pause und Fortsetzung rufen Sie setAdVisibility aus der VungleNativeAd-Instanz auf und setzen dies auf true, wenn das Video sichtbar ist, und auf false, wenn sich das Video außerhalb des Bildschirmbereichs befindet. setAdVisibility darf nicht mit der Sichtbarkeit der Ansicht verwechselt werden: Diese Einstelloption informiert Vungle SDK darüber, ob die Ansicht der MREC-Anzeige sichtbar ist und lässt abhängig davon das Abspielen des Videos durch das SDK pausieren bzw. fortsetzen.

• Eine MREC-Anzeige anhalten:
  vungleNativeAd.setAdVisibility(false);

• Eine MREC-Anzeige fortsetzen:
  vungleNativeAd.setAdVisibility(true);

Schritt 4. So passen Sie MREC-Anzeigen an (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 für MREC-Anzeigen aufgelistet:

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