Integrar anuncios publicitarios y MREC

Descripción general

Vungle admite los siguientes tres tamaños de anuncios publicitario y el tamaño estándar de anuncio MREC.

Acerca de los anuncios publicitarios

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

El complemento Unity de Vungle admite anuncios publicitarios y MREC a partir del SDK de Vungle para Unity v6.7.0.0. Este formato de anuncio no requiere una pantalla completa; en cambio, el editor determina la ubicación del contenedor de anuncios dentro de su aplicación. Sin embargo, el tamaño del contenedor del anuncio debe ser de 320 x 50, 300 x 50 o 728 x 90 (para tabletas). Puede configurar anuncios publicitarios en cualquier lugar de la pantalla y el usuario puede continuar usando la aplicación mientras se reproduce el anuncio. La lista de Enum donde se enumeran los diferentes tamaños de anuncios publicitarios se puede encontrar en el archivo VungleSDK.h (también se describen en la siguiente tabla).

No tiene límite para la cantidad de anuncios que no son de pantalla completa en un momento dado, pero el complemento no verifica si se muestran varios anuncios en una posición. Invoque un anuncio para cualquier posición proporcionado por nuestro complemento y también controle que no se superpongan entre sí si está mostrando más de uno.

El tipo de ubicación para los anuncios publicitarios debe tener el tipo “Anuncio publicitario” en el panel de control de Vungle. No dude en ponerse en contacto con su administrador de cuentas para habilitar la ubicación de los anuncios publicitarios en el panel de control.

Acerca de los anuncios MREC

A partir del SDK de Vungle v.6.4.3, 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 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 del complemento

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

Paso 2. Implemente controladores de eventos (opcional)

Puede configurar controladores de eventos para los cinco eventos del SDK de Vungle que rodean la presentación de anuncios.

• El siguiente evento se activa cuando el SDK comienza a reproducir un anuncio de video. Este es un gran lugar para pausar el juego, los efectos de sonido, las animaciones, etc.
  

  public static event Action onAdStartedEvent;

• El siguiente evento se activa cuando el SDK cierra un anuncio. Este es un gran lugar para recompensar a sus usuarios y reanudar el juego, los efectos de sonido, las animaciones, etc.
  

  public static event Action<string, AdFinishedEventArgs> onAdFinishedEvent;

  La clase AdFinishedEventArgs consta de las siguientes propiedades para que pueda verificar el resultado de la reproducción de un anuncio:
  

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

• El siguiente método se activa cuando el SDK modificó el estado de disponibilidad del anuncio. La expresión booleana isAdPlayable denota la nueva reproducibilidad de una identificación placementID determinada.
  

  public static event Action<string, bool> adPlayableEvent;

• El siguiente evento se ejecuta cuando el SDK se inicializa correctamente.
  

  public static event Action onInitializeEvent;

Código de muestra:

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

Paso 3. Cargue, reproduzca y cierre un anuncio MREC

Cargar un anuncio

La carga de un anuncio que no es de pantalla completa funciona diferente de los anuncios de pantalla completa y hay una API loadBanner específica que puede cargar. Debe especificar el tamaño y la posición del anuncio que no es de pantalla completa que desea cargar y el SDK automáticamente lo actualizará con el intervalo de tiempo que configuró en el panel de control. Debe usar las ubicaciones que creó específicamente para los anuncios publicitarios o MREC.

Cargue un anuncio que no sea de pantalla completa a través del método loadBanner:

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

Mostrar un anuncio

Los anuncios que no son de pantalla completa se mostrarán en la posición en el tamaño que especificó en el momento de invocar loadBanner cuando usa showBanner.

Vungle.showBanner("PLACEMENT_ID");

Le recomendamos que compruebe la disponibilidad de anuncios antes de intentar reproducir un anuncio y se puede utilizar isAdvertAvailable como anuncios de pantalla completa. Sin embargo, para los anuncios que no son de pantalla completa, deberá pasar VungleBannerSize además del id. de ubicación para el anuncio que desea mostrar.

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

Cerrar un anuncio

Puede usar closeBanner cuando desee descartar un anuncio que no sea de pantalla completa.

Vungle.closeBanner("PLACEMENT_ID");