Integrar anuncios MREC

Descripción general

Vungle MREC se encuentra actualmente en fase BETA. Comuníquese directamente con el administrador de cuentas para acceder a fin de garantizar un lanzamiento exitoso.

A partir del SDK de Vungle v6.4.11, Vungle admite anuncios de video MREC. “MREC” es una abreviatura de anuncios de “rectángulo mediano”. A diferencia de los anuncios intersticiales, los anuncios MREC no requieren una vista de pantalla completa. Al igual que los anuncios publicitarios, los anuncios de video MREC son anuncios rectangulares que ocupan una ubicación en cualquier lugar dentro del diseño de la aplicación y generalmente se muestran en la parte superior o inferior de la pantalla, para que el usuario pueda continuar interactuando con la aplicación mientras se reproduce el anuncio. El tamaño del contenedor para renderizar anuncios MREC es el estándar de la industria: 300 x 250.

Paso 1. Complete la integración básica

Para integrar anuncios MREC en la aplicación de Android o Amazon, siga las instrucciones del artículo de integración básica. Este artículo contiene información adicional y asume que ha completado la integración básica.

Paso 2. Implemente monitores de eventos

Implementar monitores de eventos

Puede usar devoluciones de llamada genéricas implementando LoadAdCallback para eventos de carga de anuncios y PlayAdCallback para eventos de reproducción de anuncios, o puede usar devoluciones de llamada en línea cuando ejecuta loadAd y playAd.

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
}
};

Paso 3. Cargue, muestre y cierre un anuncio MREC

Cargar un anuncio MREC

Cargar un anuncio MREC es lo mismo que cargar un anuncio a pantalla completa. Sin embargo, la ubicación debe configurarse para admitir un MREC. Comuníquese con su administrador de cuentas de Vungle para habilitar MREC para una ubicación.

Mostrar un anuncio MREC

Debido a que el tamaño de la vista es fijo, el contenedor que se utiliza para mostrar el anuncio MREC debe especificarse para ser 300 dp x 250 dp, y la vista se puede colocar en cualquier lugar de la pantalla. Este contenedor es un RelativeLayOut.

Puede colocar este RelativeLayout en cualquier lugar de la pantalla. Luego debe llamar a AdConfig.setAdSize para especificar el tamaño del anuncio en AdConfig.AdSize.VUNGLE_MREC y pasar este objeto cuando llame a Vungle.getNativeAd para obtener el objeto de anuncio MREC.

Finalmente, llame a la función addView para asociar el contenedor con el anuncio MREC. Vungle MREC se reproduce con el sonido habilitado de forma predeterminada, pero puede configurar la opción setMuted en true para iniciar el video en silencio.

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);

Cerrar un anuncio MREC

Debido a que ha agregado la vista de anuncios MREC a su vista de contenedor, también debe eliminarla, en caso de que la vista de anuncios desaparezca de la pantalla, la actividad o el fragmento se destruya o el contenedor de la vista principal se recicle o destruya. Si intenta reproducir otro anuncio MREC sin cerrar el anuncio anterior, es posible que observe un comportamiento inesperado en la aplicación. Por lo tanto, ejecute finishDisplayingAd para finalizar la experiencia del anuncio. También le recomendamos que elimine el evento de visualización onAdEnd.

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;
    …
}

Adjuntar y separar el estado de un anuncio MREC

Si el usuario se desplaza hasta un punto en el que el anuncio de video ya no es visible en la pantalla, debe pausar el video y reanudarlo cuando vuelva a estar visible. Para controlar los estados de pausa y reanudación, llame a setAdVisibility desde la instancia VungleNativeAd y configúrelo en true cuando el video sea visible y en false cuando el video salga de la pantalla. No se debe confundir setAdVisibility con la visibilidad de la vista: este configurador informa al SDK de Vungle si la vista del anuncio MREC es visible o no, y dependiendo de ello, el SDK pausa o reanuda la reproducción de video.

• Pausar un anuncio MREC:
  vungleNativeAd.setAdVisibility(false);

• Reanudar un anuncio MREC:
  vungleNativeAd.setAdVisibility(true);

Paso 4. Personalice los anuncios MREC (opcional)

Tiene la opción de personalizar los anuncios individuales que reproduce proporcionando un nuevo objeto adConfig a playAd. Cuando el objeto AdConfig es nulo, el anuncio se reproduce con la configuración predeterminada; cuando no es nulo, las configuraciones anulan las del configurador AdConfig. El siguiente es un ejemplo de cómo utilizar AdConfig:

Vungle.playAd(placementReferenceID, adConfig, vunglePlayAdCallback);

El ejemplo anterior utiliza el objeto adConfig, que contiene opciones de configuración personalizadas. Configure el objeto AdConfig como se muestra:

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

La siguiente tabla enumera las opciones de AdConfig disponibles para anuncios MREC:

Nota: Puede utilizar el mismo objeto AdConfig para varios anuncios.