Integração do SDK

Requisitos

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

Cuidado

Esses mínimos vêm das redes de anúncios incluídas no SDK. Versões mais antigas do Android Gradle Plugin fazem o build falhar com um erro de AAR metadata, e compiladores Kotlin abaixo da versão 2.2 não conseguem ler os metadados do SDK do Google Mobile Ads.

Configurar o projeto

Dependendo da linguagem usada pelo projeto nos scripts do Gradle, você deve seguir os passos da aba correspondente:

Groovy

Primeiro, você precisa adicionar os seguintes repositórios Maven dentro do bloco repositories do arquivo settings.gradle:

Nota

Nos projetos que ainda usam uma estrutura antiga, o bloco repositories pode ser encontrado no arquivo build.gradle localizado no nível do 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' }
}

Depois de adicioná-los, você pode prosseguir com a integração do SDK. Para isso, adicione a seguinte linha dentro do bloco dependencies do arquivo build.gradle localizado no nível do app:

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

Se ainda não estiver ativada, você precisa ativar a compatibilidade com Java 8 no projeto. Isso pode ser feito adicionando estas linhas extras dentro do bloco android, também no mesmo arquivo build.gradle:

compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}

Kotlin

Primeiro, você precisa adicionar os seguintes repositórios Maven dentro do bloco repositories do arquivo 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") }
    }
}

Depois de adicioná-los, você pode prosseguir com a integração do SDK. Para isso, adicione a seguinte linha dentro do bloco dependencies do arquivo build.gradle.kts localizado no nível do app:

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

Se ainda não estiver ativada, você precisa ativar a compatibilidade com Java 8 no projeto. Isso pode ser feito adicionando estas linhas extras dentro do bloco android, também no mesmo arquivo build.gradle.kts:

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

Configurar o Manifest

Você precisa adicionar o seguinte elemento <meta-data> no arquivo AndroidManifest.xml, dentro do bloco <application>, com o ID de aplicativo do 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

Esse valor pode ser encontrado em nosso dashboard, nos detalhes do app, sob o nome Google App ID.

Solicitar consentimento

Dica

É altamente recomendável solicitar o consentimento do usuário para poder exibir anúncios personalizados. Isso nos permitirá exibir conteúdo de maior interesse e gerar receitas mais altas.

Você pode consultar a seguinte seção para implementar essa solicitação e obter o consentimento do usuário: Consentimento do usuário

Inicializar o SDK

Nossa recomendação é inicializar o SDK na classe Application do app, mas isso também pode ser feito em qualquer Activity principal.

Para isso, é necessário integrar o seguinte código no método onCreate:

Kotlin

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

Java

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

Listener de inicialização

Existem duas maneiras possíveis de saber quando o SDK conclui sua inicialização:

Passando um listener como último parâmetro do método WortiseSdk.initialize

Kotlin

WortiseSdk.initialize(this, "sua app key") {
    // Este listener será invocado quando a inicialização for concluída
}

Java

WortiseSdk.initialize(this, "sua app key", () -> {
    // Este listener será invocado quando a inicialização for concluída
    return Unit.INSTANCE;
});

Usando o método WortiseSdk.wait

Kotlin

WortiseSdk.wait {
    // Este listener será invocado quando a inicialização for concluída
}

Java

WortiseSdk.wait(() -> {
    // Este listener será invocado quando a inicialização for concluída
    return Unit.INSTANCE;
});

Modo de teste

Para verificar a integração, o SDK oferece um modo de teste que permite que o app sempre receba anúncios.

Além da opção disponível em nosso dashboard, você pode ativar esse modo de teste programaticamente, a partir do próprio SDK, usando o seguinte código:

Kotlin

AdSettings.testEnabled = true

Java

AdSettings.setTestEnabled(true);