Introdução

O objetivo deste manual é fornecer todas as informações necessárias para instalação e uso da ferramenta nos aplicativos desenvolvidos para plataforma Flutter.

Este Plugin realiza a coleta de dados (informações e localização) do dispositivo e envio para ClearSale. Todas as informações coletadas são dados relacionados apenas ao dispositivo, sem relação ao aplicativo integrado.

A informação de geolocalização depende da permissão concedida pelo usuário do dispositivo, neste caso é necessário que o aplicativo solicite o acesso da informação de localização do usuário (o SDK não solicita permissão). Caso o aplicativo não solicite o acesso ou o usuário não conceda permissão, para localização, não será realizada a captura das informações de GeoLocation.

O Plugin respeita a política de privacidade da Apple e do Google para a captura dos dados do dispositivo e o nivel de permissão atribuído pelo usuário (usuário do dispositivo).

Checksum

Para consultar o checksum do artefato verifique o pubspec.lock, após executar o comando flutter pub get . no seu projeto.

Flutter

Instalação

O plugin está disponível no pub.dev, e para sua utilização é necessário seguir o exemplo abaixo:

dependencies:
  behavior_analytics_flutter_sdk: ^0.3.3

No arquivo pubspec.yaml, insira a referencia do package na parte de dependencias.

Configuração Proguard

Caso o seu projeto esteja utilizando Proguard, será necessário inserir as seguintes configurações:

Obrigatório

-keep class sale.clear.behavior.android.** { *; }

Opcional

-keepattributes Exceptions

Configuração de release

Abaixo uma recomendação de configuração base para a release.

buildTypes {
  release {

    shrinkResources true

    minifyEnabled true

    proguardFiles getDefaultProguardFile('proguard-android.txt'),
    'proguard-rules.pro'
    signingConfig signingConfigs.debug 
  }
}

Dados e Descrição

Implementação

Inicialização do SDK

import  'package:behavior_analytics_flutter_sdk/behavior_analytics_flutter_sdk.dart';

class  MyApp  extends  StatefulWidget {
    @override
    _MyAppState  createState() => _MyAppState();
}

class  _MyAppState  extends  State {
    @override
    void  initState() {
        super.initState();
        BehaviorAnalyticsFlutterSdk.start("appkey_fornecido_pela_clearsale");
    }
}

Coleta de device

Exemplo de implementação da coleta

void _handleButtonPress() {
    BehaviorAnalyticsFlutterSdk.generateSessionID().then((sessionID) {
        BehaviorAnalyticsFlutterSdk.collectDeviceInformation(sessionID);

        print(sessionID);

        setState(() {
          _sessionID = sessionID;
        });
    });
}

@override
Widget build(BuildContext context) {
    print('build');
    return MaterialApp(
        home: Scaffold(
            appBar: AppBar(
                title: const Text('BehaviorAnalytics Plugin Example'),
            ),
            body: Center(
                child: Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    children: [
                        Text('SessionID: $_sessionID\n'),
                        ElevatedButton(
                            onPressed: _handleButtonPress,
                            child: Text('Coletar'),
                        ),
                    ],
                ),
            ),
        ),
    );
}

Projeto de Exemplo

É possível visualizar a implementação do SDK em um projeto de exemplo Clicando aqui.

Detalhes de privacidade

Uso de dados

Todas as informações coletadas pelo SDK da ClearSale são com exclusiva finalidade de prevenção à fraude e proteção ao próprio usuário, aderente à política de segurança e privacidade das plataformas Google e Apple e à LGPD. Por isso, estas informações devem constar na política de privacidade do aplicativo.

Tipo de dados coletados

O SDK da ClearSale coleta as seguintes informações do dispositivo :

• Localização precisa (quando habilitada permissão pelo usuário);
• Identificadores de publicidade do dispositivo (quando habilitada permissão pelo usuário);
• Características físicas do dispositivo/ hardware (Como tela, bateria, teclado, espaço livre em disco, modelo, nome do dispositivo);
• Características de software (Como versão, idioma, build, controle parental);
• Informações de rede (Como Conexões, IP);
• Operadora do SimCard.

Política de privacidade da Google
Política de privacidade da Apple