IntegraçãoInstalando e inicializando

Instalando e inicializando

O SDK do Finteza requer o Android 4.0.3 (API Level 15) ou superior e uma biblioteca com.android.installreferrer:installreferrer. Você pode instalar o SDK através do Gradle ou manualmente fazendo o download do pacote no link https://bintray.com/finteza/maven/finteza-sdk.

Instalação através do Gradle #

Para conectar o Finteza SDK à seção dependencies do arquivo build.gradle do seu projeto, adicione a seguinte dependência:

dependencies {
   //... outras dependências
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

Instalação manual #

Faça o download do SDK mais recente como arquivo jar e copie-o para o diretório libs do seu projeto. Em seguida, adicione o arquivo jar do SDK ao projeto como biblioteca.

Adicione o serviço ao manifesto do projeto:

<service android:name="net.metaquotes.FintezaService" />

E depois as permissões:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Adicione a dependência ao arquivo build.gradle:

dependencies {
   //... outras dependências
    implementation 'com.android.installreferrer:installreferrer:1.0'
}

Inicialização do SDK no aplicativo #

Para inicialização, chame o método Finteza.initialize no manipulador Application.onCreate ou Activity.onCreate:

Finteza.initialize(getApplication(), "{WEBSITE_ID}""{WEBSITE_URL}""{PRODUCT}");

Defina o ID do site como {WEBSITE_ID}. Pode ser obtido nas configurações do site (campo ID) do painel do Finteza. Em seguida, defina os parâmetros:

Parâmetros

Tipo

Descrição

site

string

Nome de domínio do site. Por exemplo, "my.site.com".

product

string

Nome do produto. Usado como um prefixo para marcar eventos enviados pelo seu aplicativo para o Finteza.

 

Você pode precisar dele para separar eventos em diferentes plataformas caso tenha aplicativos para PC, iOS, Android etc. Por exemplo, se você especificar o produto "Android App" e enviar o evento 'Registration', o nome do evento final no Finteza será "Android App Registration".

 

Defina null, para evitar o uso do prefixo.

Evento ao inicializar o aplicativo #

Adicione o seguinte código ao manipulador Activity.onCreate:

Finteza.activate()

Ao chamar activate, durante a primeira inicialização do aplicativo, o SDK envia para o Finteza o evento de instalação 'Install Finish' (se definido o prefixo do produto, então '{PRODUCT} Install Finish').

Além disso, ao chamar activate, é iniciada uma nova sessão de trabalho e é registrado o evento 'Session Start' (se definido o prefixo do produto, então '{PRODUCT} Session Start').

Qualquer partida do aplicativo encerra a sessão atual. Na próxima vez que você iniciar/ativar o aplicativo, será iniciana iniciada uma nova sessão.


Mensagens de depuração #

Para testar o SDK, você pode incluir informações de depuração no console do desenvolvedor com filtragem por tipo de mensagem:

Apenas eventos

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Registro completo

Finteza.addLogging(LogUtil.LogLevel.ALL);

Apenas erros

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Para desativar as mensagens de depuração, chame:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Exemplo

A mensagem de depuração a seguir indica um erro de envio de evento devido à ausência da chamada do método activate:

[event] cannot send event 'Book Load': call the 'activate' method first