Docs

Getting started

Our Flutter SDK lets you collect user data from mobile apps. It contains over 40 methods that make it easy to track screen views, goals, ecommerce orders and more. To get started, you need to set up your account in Piwik PRO, install our library and set up the tracker.

Set up Piwik PRO

Before you install our library for Flutter, you need to set up Piwik PRO. Here's what you need to do:

  1. Log in to Piwik PRO.
  2. Go to Menu > Administration.
  3. Navigate to Sites & apps.
  4. Click Add a site or app.
  5. Type the app name and address, and click Save.
  6. Set the time zone and currency.
  7. Note the site/app ID. The ID is under the app name. Example: 00000000-0000-0000-0000-000000000000.
  8. Note your tracking endpoint URL. This is the base URL where the SDK sends collected events. By default, this is the same as your Piwik PRO instance address (for example, https://example.piwik.pro). If your organization uses a custom tracking endpoint, check with your Piwik PRO administrator.

Install the library

To install the library with Flutter or Dart, follow these steps:

  1. Run the following command:
$ flutter pub add flutter_piwikpro
$ dart pub add flutter_piwikpro
  1. This adds a line to your package’s pubspec.yaml and automatically runs dart pub get:
dependencies:
  flutter_piwikpro: ^2.1.1
  1. (Optional) Your editor might support dart pub get or flutter pub get. Check the docs for your editor to learn more.
  2. Now in your Dart code, you can use the following method:
import 'package:flutter_piwikpro/flutter_piwikpro.dart';

Set up the tracker

To set up the Piwik PRO tracker, follow these steps:

  1. Run the following command. Provide your tracking endpoint URL, which is the base URL where the SDK posts events, for example, (https://example.piwik.pro/) and the site/app ID (Where to find it?).
await FlutterPiwikPro.sharedInstance.configureTracker(baseURL: 'https://example.piwik.pro/', siteId: '01234567-89ab-cdef-0123-456789abcdef');

How to use our SDK

All SDK methods are asynchronous and can throw exceptions. For example, calling SDK methods before configuring the tracker results in an error. You can handle this error with a standard try-catch block. See the example below:

try {
    final result =
    await FlutterPiwikPro.sharedInstance.trackDownload('http://your.server.com/bonusmap2.zip');
    print(result);
} catch (exception) {
    //handle an exception
}

If a method call is successful, most methods return a string that describes the called method and the parameters used, unless stated otherwise. For example:

FlutterPiwikPro - configureTracker completed with parameters: baseURL: https://example.piwik.pro/, siteId: 01234567-89ab-cdef-0123-456789abcdef

Updated 10 days ago