Android 7.0+
iOS 13.0+

Add this dependency to your module's build.gradle file:

Kotlin

dependencies {
	...
	implementation("io.github.clickonometrics.android:clickonometrics:1.+")
}

Groovy

dependencies {
	...
	implementation 'io.github.clickonometrics.android:clickonometrics:1.+'
}

Make sure the minSdkVersion in build.gradle file is at least 24.

Kotlin

android {
	...
	defaultConfig {
		...
		// 24 or greater
		minSdkVersion(24)
	}	
}

Groovy

android {
	...
	defaultConfig {
		...
		// 24 or greater
		minSdkVersion 24
	}	
}

The library is available via Cocapods so you need add dependency to your Podfile

pod 'EuvicMobileSDK', '~> 1.0'

You can also use framework binary file EuvicMobileSDK.xcframework and add it to your project.

Create a new file called euvic_sdk_plugin.dart and paste all the code you find here.

To use system ad identifier add this line to your AndroidManifest.xml file.

<manifest xlmns:android...>
 ...
 <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
 <application ...
</manifest>

To use system ad identifier you need to request for tracking authorization in your app.
Remember to add NSUserTrackingUsageDescription in your Info.plist

To allow library to track user's location you need to request about location permission in your app before sending an event.
Remember to add this line to your AndroidManifest.xml file.

<manifest xlmns:android...>
 ...
 <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
 <application ...
</manifest>

To send current user location you need to request for tracking authorization in your app.
Remember to add NSLocationWhenInUseUsageDescription in your Info.plist

In order for the library to do its job, you need to add a bridge that communicates between Flutter and Android. Click here and copy the code to MainActivity.kt in your android/app/src/main/kotlin/your_project_path/.

In order for the library to do its job, you need to add a bridge that communicates between Flutter and iOS. Click here and copy content of AppDelegate+EuvicMobileBridge.swift file into your project and add the following to AppDelegate.swift

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
      setupEuvicMobileBridge()

      GeneratedPluginRegistrant.register(with: self)
      ...
    }

Before sending events configuration is required. We recommend to do it just after starting the app, because all events submitted earlier will not be sent.

Example:

Dart

EuvicSdkPlugin.configure(
    apiKey: "your_api_key",
    url: "https://your-event-tracker.com",
    currency: "EUR"
  );

This event should be sent when user has visited a home page

This event should be sent when user has browsed a product.

This event should be sent when user adds product to the shopping cart.

This event should be sent when user removes product from the shopping cart.

This event should be sent when user has browsed category.

This event should be sent when user views products in the cart.

This event should be sent when user has started the order process.

This event should be sent when user has completed the order process.

For each event there is possibility to append custom data. Sample below:

Dart

EuvicSdkPlugin.productsOrderedEvent(
     orderId: "your_order_id",
     saleValue: "299.99",
     products: Product('id_1', '299.99', 1, 'PLN'),
     currency: "PLN",
     customData: {
           'someText': 'Lorem ipsu',
           'customNumber': 124,
           'myCustomDouble': 0.1337
        }
  );

Represents a product instance