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

Plataforma	Documentação
Android	clique aqui
iOS	clique aqui

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

dependencies:
  behavior_analytics_flutter_sdk: ^0.3.7

dependencies:
  behavior_analytics_flutter_sdk: 
    git:
        url: https://PublicPackagesCS@dev.azure.com/PublicPackagesCS/Behavior/_git/BehaviorAnalytics.SDK.Flutter
        ref: main
        version: 0.5.10

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 
  }
}
    

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");
    }
}

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'),
                        ),
                    ],
                ),
            ),
        ),
    );
}