⌨️Integración del SDK

Requisitos

Esta documentación ha sido escrita para Unity 2020 o superior. Se recomienda utilizar estas versiones a la hora de integrar el SDK.

Importar paquete Unity

En primer lugar, es necesario descargar el paquete para Unity desde el siguiente enlace: https://cdn.resources.wortise.com/sdk/unity/Wortise-Unity-1.5.0.unitypackage

Una vez descargado, haz doble click en el fichero para importarlo en el proyecto.

Configurar proyecto

Una vez el paquete ha sido importado, hay que configurar correctamente el proyecto.

Unity 2022+

Abre la configuración Player (Edit > Project Settings > Player), selecciona la pestaña con el icono de Android, despliega el panel Publishing Settings y marca las opciones Custom Main Gradle Template y Custom Gradle Settings Template.

Después de realizar este paso, abre el fichero settingsTemplate.gradle ubicado en el directorio Assets/Plugins/Android, y añade los siguientes repositorios Maven dentro del bloque repositories ubicado en dependencyResolutionManagement.

repositories {
    maven { url 'https://maven.wortise.com/artifactory/public' }
    
    maven { url 'https://android-sdk.is.com/' }
    maven { url 'https://artifact.bytedance.com/repository/pangle' }
    maven { url 'https://cboost.jfrog.io/artifactory/chartboost-ads/' }
    maven { url 'https://maven.ogury.co' }
}

Por último, en el fichero mainTemplate.gradle, introduce la siguiente línea dentro del bloque dependencies:

implementation 'com.wortise:android-sdk:1.6.1'

Unity 2020+

Abre la configuración Player (Edit > Project Settings > Player), selecciona la pestaña con el icono de Android, despliega el panel Publishing Settings y marca la opción Custom Main Gradle Template.

Después de realizar este paso, abre el fichero mainTemplate.gradle ubicado en el directorio Assets/Plugins/Android, y añade los siguientes repositorios Maven dentro del bloque repositories.

repositories {
    maven { url 'https://maven.wortise.com/artifactory/public' }
    
    maven { url 'https://android-sdk.is.com/' }
    maven { url 'https://artifact.bytedance.com/repository/pangle' }
    maven { url 'https://cboost.jfrog.io/artifactory/chartboost-ads/' }
    maven { url 'https://maven.ogury.co' }
}

Por último, en el mismo fichero, introduce la siguiente línea dentro del bloque dependencies:

implementation 'com.wortise:android-sdk:1.6.1'

Configurar Manifest

Para mejorar los eCPM de los partners Open Bidding de Google, es necesario agregar un elemento <meta-data> en el fichero AndroidManifest.xml, dentro del bloque <application>.

Este valor puede ser localizado en nuestro dashboard, dentro de los detalles de cada aplicación, bajo el nombre Google App ID.

<manifest>
    ...
    <application>
        ...
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

Solicitar consentimiento

Es muy recomendable solicitar consentimiento al usuario para poder mostrar anuncios personalizados. Esto permitirá mostrar contenido que resulte de mayor interés y generar ingresos superiores.

Puede consultar el siguiente apartado para implementar esta solicitud y obtener el consentimiento de los usuarios: Consentimiento del usuario

Inicializar SDK

Para inicializar el SDK, es necesario añadir las siguientes líneas en el método Start() del primer Scene del proyecto. Además, recomendamos implementar el evento OnInitialized para solicitar el consentimiento una vez la inicialización se ha completado:

void Start() {
    ...
    
    WortiseSdk.OnInitialized += () => {
        WortiseConsentManager.RequestIfRequired();
    };
    
    WortiseSdk.Initialize("tu app key");
}

Modo de prueba

Para verificar la integración, el SDK ofrece un modo de prueba (test mode) que permite que la app siempre reciba anuncios.

Además de la opción que hay disponible en nuestro dashboard, es posible activar este modo de prueba programáticamente, desde el propio SDK, utilizando el siguiente código:

WortiseAdSettings.IsTestEnabled = true;