Configuración avanzada

Siga las instrucciones del artículo integración básica del complemento y luego las instrucciones para los formatos de anuncios que desee integrar (anuncios intersticiales o con recompensa, anuncios publicitarios, anuncios MREC). Este artículo contiene información adicional y asume que ha completado la integración básica.

Funciones OnPause y OnResume

Agregue el código para las funciones onPause y onResume, que permite reanudar la reproducción de los anuncios que se pusieron en pausa cuando una aplicación pasó a segundo plano.

void OnApplicationPause(bool pauseStatus) {
    if (pauseStatus) {
        Vungle.onPause();
    }
    else {
        Vungle.onResume();
    }
}

Implementación de CCPA

A partir del 1.° de julio de 2020, se aplicará la Ley de Privacidad del Consumidor de California (CCPA), y los editores deben actualizar al complemento de Unity 6.7.0.0 para cumplir con la CCPA.

Use updateCCPAStatus para establecer el estado de consentimiento del usuario para especificar que el usuario ha optado por no utilizar Consent.DENIED. Y use getCCPAStatus para obtener el estado actual de CCPA para el usuario en particular.

public static void updateCCPAStatus(Consent consent)
public static Consent getConsentStatus()

Código de muestra

Vungle.updateCCPAStatus(Vungle.Consent.Denied);
Vungle.Consent CurrentCCPAStatus = Vungle.getCCPAStatus();

Opciones de configuración de anuncios

El método playAd también puede aceptar un diccionario de opciones para personalizar la experiencia de reproducción del anuncio.

public static void playAd(Dictionary<string,object> options, string placementID);

Nota: Los anuncios con recompensa se mencionan en algunos casos como anuncios incentivados; ambos términos se refieren siempre al mismo tipo de anuncio publicitario. En el código del SDK y en nuestra API de informes, usamos el término “anuncios incentivados”.

El diccionario de opciones acepta las siguientes claves:

Clave Descripción
orientation Establece la orientación del anuncio
  • Use el enum VungleAdOrientation para especificar la orientación deseada en Integer
    public enum VungleAdOrientation
    {
        Portrait = 1,
        LandscapeLeft = 2,
        LandscapeRight = 3,
        PortraitUpsideDown = 4,
        Landscape = 5,
        All = 6,
        AllButUpsideDown = 7
    }
    VungleAdOrientation Valor Orientación Plataforma admitida
    1 Portrait iOS, Android, Windows
    2 LandscapeLeft iOS
    3 LandscapeRight iOS
    4 PortraitUpsideDown iOS
    5 Landscape iOS, Android, Windows
    6 All iOS, Android, Windows
    7 AllButUpsideDown iOS
    8 MatchVideo Android
  • Para v6.7.2.1 y versiones anteriores, Android y Windows toman true o false para orientation, que todavía funciona a partir de v6.8.0.0, pero está previsto que quede obsoleto en el futuro.
userTag Cadena de la clave de usuario que se pasa para identificar los usuarios en la invocación S2S (si la hay).
alertTitle Cadena que se utiliza como título de un cuadro de diálogo de alerta que aparece cuando un usuario cierra un anuncio incentivado prematuramente.
alertText Cadena que se utiliza como texto del cuerpo del cuadro de diálogo de alerta que se presenta cuando un usuario cierra un anuncio incentivado prematuramente.
closeText Título de la cadena del texto del botón de cierre del cuadro de diálogo de alerta que aparece cuando un usuario cierra un anuncio incentivado prematuramente.
continueText Título de la cadena del texto del botón de cierre del cuadro de diálogo de alerta que aparece cuando un usuario cierra un anuncio incentivado prematuramente.

 

Espacio mínimo en disco

La configuración de espacio mínimo en disco se introdujo en la versión 6.4.0 para determinar los límites de espacio disponible en el dispositivo de un usuario antes de que el SDK de Vungle se ejecute y obtenga anuncios. El valor predeterminado para SetMinimumDiskSpaceForInitialization es de 51 MB y para SetMinimumDiskSpaceForAd es de 50 MB. El tamaño se ingresa en bytes (no MB).

Vungle.SetMinimumDiskSpaceForInitialization(minValue);
Vungle.SetMinimumDiskSpaceForAd(minValue);
Vungle.init(appID);

Deshabilitar el id. de hardware

Para la versión del SDK 6.4.0 en adelante, los editores ahora pueden restringir el paso de la id. de hardware del dispositivo al SDK.

//Set false to opt in for Hardware ID collection by SDK or true to opt out
Vungle.EnableHardwareIdPrivacy(m_disableHardwareID);

Instrucciones de implementación recomendadas para RGPD

A partir del 25 de mayo de 2019, se aplica en la Unión Europea el Reglamento General de Protección de Datos (RGPD). Para cumplir con el RGPD, los desarrolladores tienen dos opciones.

  • Opción 1 (recomendada): permitir que Vungle maneje los requisitos. Vungle mostrará un cuadro de diálogo de consentimiento antes de reproducir un anuncio para un usuario europeo, y recordará el consentimiento o rechazo del usuario para anuncios posteriores.
  • Opción 2: el editor controla el proceso de consentimiento del RGPD en el nivel de usuario y luego comunica la elección del usuario a Vungle. Para hacer esto, los desarrolladores pueden recopilar el consentimiento del usuario utilizando su propio mecanismo y luego usar las API de Vungle para actualizar o consultar el estado del consentimiento del usuario. Consulte el código de muestra a continuación para obtener más detalles.

Para usar las API de Vungle para actualizar o consultar el estado de consentimiento del usuario como se recomienda en la opción 1, use el enumerador Vungle.Consent y establezca el valor actual con las siguientes dos funciones.

// The Consent enum is used to represent the user's current GDPR opt-in status
public enum Consent {
    Undefined = 0,
    Accepted = 1,
    Denied = 2
}

// Sets the user's consent status
void updateConsentStatus(Vungle.Consent consent);

// Sets the user's consent status and also sets a string to track GDPR version
void updateConsentStatus(Vungle.Consent consent, string consentMessageVersion);

// Gets the user's consent status
Vungle.Consent getConsentStatus();

Questions?

Need further assistance, feel free to reach out to us, we’re here to help!

¿Fue útil este artículo?