Integración del SDK

Requisitos

• Android Gradle Plugin: 8.9.1 o superior (Gradle 8.11.1 o superior)
• Compile SDK: 36 o superior
• Kotlin: 2.2 o superior
• SDK mínimo: 24 o superior

Precaución

Estos mínimos vienen impuestos por las redes publicitarias incluidas en el SDK. Las versiones anteriores del Android Gradle Plugin hacen fallar la compilación con un error de AAR metadata, y los compiladores de Kotlin inferiores a la 2.2 no pueden leer los metadatos del SDK de Google Mobile Ads.

Configurar proyecto

Dependiendo del lenguaje que utilice el proyecto en los scripts Gradle, debes seguir los pasos de la pestaña correspondiente:

Groovy

En primer lugar, es necesario añadir los siguientes repositorios Maven dentro del bloque repositories del fichero settings.gradle:

Nota

En los proyectos donde todavía se utilice una estructura antigua, el bloque repositories se encontrará en el fichero build.gradle ubicado a nivel de app.

repositories {
    maven { url 'https://maven.wortise.com/artifactory/public' }

    maven { url 'https://artifact.bytedance.com/repository/pangle' }
    maven { url 'https://artifactory.bidmachine.io/bidmachine' }
}

Una vez añadidos, se puede proceder a integrar el SDK . Para ello, hay que introducir la siguiente línea dentro del bloque dependencies del fichero build.gradle ubicado a nivel de app:

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

En caso de no tenerlo ya, es necesario activar la compatibilidad con Java 8 en el proyecto. Esto se puede lograr añadiendo estas líneas adicionales dentro del bloque android, también en el mismo fichero build.gradle:

compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}

Kotlin

En primer lugar, es necesario añadir los siguientes repositorios Maven dentro del bloque repositories del fichero settings.gradle.kts:

dependencyResolutionManagement {
    repositories {
        maven { url = uri("https://maven.wortise.com/artifactory/public") }

        maven { url = uri("https://artifact.bytedance.com/repository/pangle") }
        maven { url = uri("https://artifactory.bidmachine.io/bidmachine") }
    }
}

Una vez añadidos, se puede proceder a integrar el SDK . Para ello, hay que introducir la siguiente línea dentro del bloque dependencies del fichero build.gradle.kts ubicado a nivel de app:

implementation("com.wortise:android-sdk:1.8.0")

En caso de no tenerlo ya, es necesario activar la compatibilidad con Java 8 en el proyecto. Esto se puede lograr añadiendo estas líneas adicionales dentro del bloque android, también en el mismo fichero build.gradle.kts:

compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
}

Configurar Manifest

Es necesario agregar el siguiente elemento <meta-data> en el fichero AndroidManifest.xml, dentro del bloque <application>, con el ID de aplicación de Google como valor:

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

Nota

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

Solicitar consentimiento

Consejo

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

Nuestra recomendación es inicializar el SDK en la clase Application de la app, aunque también se puede realizar en algún Activity principal.

Para ello, es necesario integrar el siguiente código en el método onCreate:

Kotlin

WortiseSdk.initialize(this, "tu app key")

Java

WortiseSdk.initialize(this, "tu app key");

Listener de inicialización

Existen dos maneras posibles para conocer cuando el SDK finaliza su inicialización:

Pasando un listener como último parámetro del método WortiseSdk.initialize

Kotlin

WortiseSdk.initialize(this, "tu app key") {
    // Este listener será invocado cuando la inicialización finalice
}

Java

WortiseSdk.initialize(this, "tu app key", () -> {
    // Este listener será invocado cuando la inicialización finalice
    return Unit.INSTANCE;
});

Utilizando el método WortiseSdk.wait

Kotlin

WortiseSdk.wait {
    // Este listener será invocado cuando la inicialización finalice
}

Java

WortiseSdk.wait(() -> {
    // Este listener será invocado cuando la inicialización finalice
    return Unit.INSTANCE;
});

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:

Kotlin

AdSettings.testEnabled = true

Java

AdSettings.setTestEnabled(true);