Integrar anuncios intersticiales y con recompensa

Descripción general

Acerca de los anuncios intersticiales

Los anuncios intersticiales son anuncios de pantalla completa que cubren la interfaz de su aplicación. Por lo general, se muestran en puntos de transición naturales en el flujo de su aplicación, como por ejemplo entre actividades o durante la pausa entre niveles de un juego. Algunos anuncios intersticiales son anuncios ofrecen recompensas.

Acerca de los anuncios con recompensa

Los anuncios con recompensa brindan una excelente experiencia de usuario al ofrecerles algo de valor a cambio de mirar o interactuar con un anuncio. Este intercambio suele ser una recompensa dentro de su aplicación, como vidas extra en un juego, monedas virtuales o una pista en un rompecabezas (usted determina la naturaleza y el monto de la recompensa). Los anuncios de video que ofrecen recompensas y que se muestran en las pausas naturales de la aplicación, generan altos ingresos, especialmente si sigue nuestra recomendación para que no se puedan omitir.  

Tenga en cuenta que los anuncios con recompensa se denominan en algunos casos anuncios con incentivo; ambos términos siempre se refieren al mismo tipo de anuncio. Aunque «con recompensa» es nuestro término preferido, en el código del SDK y en nuestra API de informes, utilizamos el término «con incentivo».

Hay dos formas de integrar anuncios con recompensa: con recompensas en la aplicación (recomendadas y descritas a continuación) o con devoluciones de llamada de servidor a servidor (consulte nuestro artículo de preguntas frecuentes sobre este tema). Con las recompensas en la aplicación, cuando un usuario completa con éxito la vista de anuncio o hace clic en el botón de descarga, puede recompensarlo directamente en su aplicación. El principal beneficio de este enfoque es que es fácil de implementar. Si está buscando algo rápido y no le preocupan los ataques de repetición, esto debería ser suficiente.

Vungle ahora ofrece una variedad de formatos de anuncios con anuncios de plantilla dinámica. A diferencia del formato tradicional de los anuncios, en el que la reproducción de un anuncio consiste en la reproducción de un video seguida de una tarjeta de objetivos, ofrecemos plantillas en las que el botón llamada de acción (CTA, por sus siglas en inglés) está disponible durante la reproducción del video. Los usuarios que finalizan la visualización del anuncio de video, así como aquellos que hacen clic en el botón, deberían recibir una recompensa.

Paso 1. Complete la integración básica del complemento

Para integrar anuncios intersticiales y con recompensa en su aplicación de Unity, comience siguiendo las instrucciones del artículo de integración básica del plugin . Este artículo contiene información adicional y supone 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;

  Para más información, consulte la sección “Comprobar la disponibilidad de un anuncio para una ubicación” de este artículo.
• 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 y reproduzca un anuncio

Cargar un anuncio para una ubicación

Para todas las ubicaciones, llame al método loadAd() para cargar un anuncio.

public static void loadAd(string placementID)

Asegúrese de usar la placementID vinculada a la plataforma correcta.

Código de muestra:

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

Comprobar la disponibilidad de un anuncio para una ubicación

Luego de que el SDK finalice el almacenamiento en caché de un anuncio para una ubicación, se invoca el siguiente evento:

public static event Action<string, bool> adPlayableEvent;

Código de muestra:

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

Nota: para las ubicaciones optimizadas en caché, este evento solo se llama cuando un anuncio está disponible. Las ubicaciones optimizadas intentan completarse automáticamente sin más acciones. Para todas las demás ubicaciones, este evento también se llama en caso de «Error de carga» (adPlayable devuelve false en este caso).

También, puede comprobar la disponibilidad de un anuncio para una ubicación con el siguiente método:

public static bool isAdvertAvailable(string placementID);

Reproducir un anuncio

Importante: no reproduzca un anuncio hasta que la función adPlayableEvent descrita anteriormente devuelva «verdadero». Si intenta reproducir un anuncio antes de que la función adPlayableEvent devuelva «verdadero», la experiencia del usuario se verá afectada negativamente mientras el anuncio intenta cargarse. Si se implementa en Android, utilice el valor devuelto por isAdvertAvailable() para asegurarse de que un anuncio esté disponible (porque adPlayableEvent no devolverá «falso» cuando no haya ningún anuncio disponible).

Cuando haya un anuncio disponible para una ubicación, podrá reproducir el anuncio con el siguiente método:

public static void playAd(string placementID);

Código de muestra:

Vungle.playAd(placementID);