Orientação gerada a partir de informações públicas. Apenas para referência.
O pacote matomo_tracker oferece uma solução totalmente multiplataforma para integrar análises Matomo em aplicativos Flutter. Ele encapsula a API de rastreamento do Matomo, permitindo que desenvolvedores coletam dados de comportamento do usuário em plataformas Android, iOS, Web, macOS, Windows e Linux. Com métodos simples de inicialização e rastreamento de eventos, suporta eventos personalizados, visualizações de página e rastreamento de sessões de usuário. O pacote foi projetado para integração perfeita com instalações existentes do Matomo, oferecendo coleta confiável de dados sem código específico da plataforma. É ideal para aplicativos que exigem análises detalhadas, mantendo práticas de rastreamento focadas na privacidade.
Casos de uso
Rastreamento de interações do usuário em aplicativos móveis e web
Monitorar o desempenho do aplicativo por meio de visualizações de página
Analisando o comportamento do usuário com eventos personalizados
Integração com servidores Matomo hospedados por você
Coletando análises em múltiplas plataformas
Principais recursos
Compatibilidade multiplataforma
Suporte para todas as principais plataformas de SO
Rastreamento simples de evento e visualização de página
Integração com instâncias auto-hospedadas do Matomo
Tratamento de dados consciente de privacidade
Indicado para
Desenvolvedores Flutter que precisam de análise
Aplicativos usando Matomo auto-hospedado
Projetos que exigem rastreamento multiplataforma
Equipes focadas em insights sobre comportamento do usuário
Desenvolvedores evitando serviços de análise de terceiros
Considerações
Requer um servidor Matomo em execução
É necessário configurar corretamente o ID de rastreamento
Pode ser necessário o cumprimento de regulamentações de privacidade
Limitado a recursos específicos do Matomo
Depende da disponibilidade da rede para transmissão de dados
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
If your application uses authentication and you wish to have your visitors including their specific identity to Matomo, you can use the Visitor property userId with any unique identifier from your back-end, by calling the setVisitorUserId() method. Here's an example on how to do it with Firebase:
If you want to offer a way for the user to opt out of analytics, you can use the setOptOut() call.
MatomoTracker.instance.setOptOut(optout: true);
Using Dimensions
If you want to track Visit or Action dimensions you can either use the trackDimensions (if
it's a Visit level dimension) or provide data in the optional dimensions param of trackEvent
(if it's an Action level dimension):
When using cookieless tracking, the user_id won't be sent or saved locally.
Dispatching
Actions logged are not send to Matomo immediately, but are queued for a configurable duration (defaulting to 10 seconds) before beeing send in batch. A user could terminate your app while there are still undispatched actions in the queue, which by default would be lost. The queue can be configured to be persistent so that such actions would then be send on the next app launch. See the DispatchSettings class for more configuration options.
Session class and its related properties firstVisit, lastVisit and visitCount have been removed as they were not used since Matomo 4.0.0.
LocalStorage methods getFirstVisit, setFirstVisit, getVisitCount and setVisitCount have been removed accordingly.
siteId is now a String instead of an int
v4.0.0
trackScreen was renamed to trackPageView and trackScreenWithName to trackPageViewWithName.
screenId and widgetId were renamed to pvId.
userId was renamed to uid.
traceName and widgetName were renamed to actionName.
traceTitle was renamed to eventName.
forcedId property has been removed as it was never used. You should rely on the user ID instead.
An object of type EventInfo has been added, it has the following properties: category, action, name and value, use it instead of passing the event name, action and value as separate parameters.
For TraceableClientMixin and TraceableWidget to work you will have to add the matomoObserver to your MaterialApp or WidgetsApp:
trackPageView positional parameter context is now a named parameter
trackGoal positional parameter goalId is now a named parameter: id
trackDimensions positional parameter dimensions is now a named parameter
trackCartUpdate positional parameters trackingOrderItems, subTotal, taxAmount, shippingCost and discountAmount are now named parameters
trackOrder positional parameters orderId (now id), trackingOrderItems, revenue (also became a double), subTotal, taxAmount, shippingCost and discountAmount are now named parameters
trackOutlink positional parameter link is now a named required parameter (also changed the type to String)
v3.0.0
Now the initialize() method takes a LocalStorage? localStorage instead of a SharedPreferences? prefs as its parameter to override the persistent data implementation.
By default it will use an implementation of shared_preferences with the class SharedPrefsStorage, but you can provide your own implementation of LocalStorage to use a different package.