Para aqueles clientes que possuem um aplicativo próprio desenvolvido utilizando as tecnologias nativas do Android e que desejam realizar as conversões de indicados através deste aplicativo, nós oferecemos um SDK para facilitar esta tarefa.


O passo a passo para a instalação e uso deste SDK pode ser conferida a seguir:


1. Primeiramente, requisite suas credenciais de autenticação enviando um e-mail para emanuel.martins@beeviral.com.br


2. Feito isso, insira o código abaixo no arquivo settings.gradle.kts a nível da aplicação:


dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://pkgs.dev.azure.com/beeviraldevops/beeviralsdk-android/_packaging/sdk_conversion/maven/v1")
            credentials {
                username = "<E-mail>"
                password = "<Senha>"
            }
        }
    }
}


As marcações <E-mail> e <Senha> devem ser substituídas, respectivamente, pelas credenciais recebidas através de sua requisição.


3. Insira a seguinte dependência no arquivo build.gradle.kts a nível da aplicação dentro do bloco de código dependencies:


implementation("com.beeviral.sdk_conversion:sdk_conversion:0.0.3")


4. Por fim, sincronize o projeto com os arquivos Gradle.



Feito isso, seu aplicativo já está habilitado para utilizar os métodos do SDK de Conversão




Como usar o SDK de Conversão no meu aplicativo?


Abaixo, você encontrará um exemplo de aplicação do SDK de Conversão em um indicado fictício:


Arquivo MainActivity.kt:


class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        ConversionService.initialize("<CAMPAIGN_TOKEN>")
        runBlocking {
            withContext(Dispatchers.IO) {
                ConversionService.doConversion(
                    applicationContext, hashMapOf(
                        Pair("name", "Gina"),
                        Pair("email", "gina_gomes@teste.com.br"),
                    )
                )
            }
        }

        setContent {
            MyApplicationTheme {
                // A surface container using the 'background' color from the theme
                Surface(modifier = Modifier.fillMaxSize(), color = MaterialTheme.colorScheme.background) {
                    Greeting("Android")
                }
            }
        }
    }
}

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Text(
        text = "Hello $name!",
        modifier = modifier
    )
}

@Preview(showBackground = true)
@Composable
fun GreetingPreview() {
    MyApplicationTheme {
        Greeting("Android")
    }
}


A marcação <CAMPAIGN_TOKEN> deve ser substituída pela Campaign Token específica de sua campanha. Este token pode ser encontrado no menu Configurações>Integrações. O token necessário está entro da box de "API Token".