flutter_estatisticas 0.0.5

Simple Umami Analytics Flutter SDK

Flutter Umami Analytics Integration

Este pacote integra o Umami Analytics ao seu app Flutter, permitindo rastreamento de navegação e eventos personalizados.

Instalação

Adicione ao seu pubspec.yaml:

dependencies:
  flutter_estatisticas: ^0.0.5

Como usar

1. Importe os serviços

import 'package:flutter_estatisticas/umami_service.dart';
import 'package:flutter_estatisticas/umami_navigation_observer.dart';

2. Instancie o serviço Umami

final umamiService = UmamiService(
  website: 'id-website', // Seu website ID do Umami
  hostname: 'seusite.com.pt',              // Hostname do seu app
);

3. Adicione o observer ao seu MaterialApp

MaterialApp(
  // ... outros parâmetros ...
  navigatorObservers: [
    FirebaseAnalyticsObserver(analytics: FirebaseAnalytics.instance),
    UmamiNavigationObserver(umamiService),
  ],
)

4. Envie eventos personalizados

Clique simples

umamiService.enviarClique(context, 'spotify');

Substitua 'spotify' pelo nome do evento desejado.

Evento customizado

umamiService.enviarEvento(
  context,
  nome: 'nome-do-evento',
  dados: {
    'chave': 'valor',
    'foo': 'bar',
  },
);

Use enviarEvento para enviar eventos com dados adicionais.

---

Observações

• O website deve ser o ID do seu site cadastrado no painel do Umami.
• O hostname deve ser o domínio ou identificador do seu app.
• O observer irá rastrear automaticamente as navegações no app.
• Use enviarClique para eventos simples e enviarEvento para eventos customizados.

---

Licença

MIT