Functions

Methods

Initialize

Initializes the SDK. For a complete configuration of the Flutter Intelligence SDK please check Configuration.

initialize(List<int> trackIds, String trackDomain) → Future<String?>

Optional setup functions

/**
 * We should use this function to enable batch support 
 * @size is one batch size (The recommended value is between 500 and 5000)
 */
setBatchSupportEnabledWithSize(bool isEnabled, int size) → Future<String?>
/**
 * log level
 */
setLogLevel(LogLevel logLevel) → Future<String?>
/**
 * Request Interval: define how often the library sends a request to the server. The minimum is 15 minutes, which is the default
 */
setRequestInterval(int intervalSize) → Future<String?>
/**
 * Only iOS function: The number of requests in the queue before write the database
 */
setRequestPerQueue(int requestNumber) → Future<String?>

JAVA

Build

Builds the SDK. For a complete configuration of the Flutter Intelligence SDK please check Configuration. For Android, please refer to the section Initializing the SDK for Android.

build() → Future<void>

Track

Sends data to the Mapp tracking server. To see the complete data configuration of the Mapp Intelligence Java library, please check Data. It's possible to send actionEvents and pageViewEvents.

The following data can only be sent via pageViewEvents:

• Page

The following data can be sent only via actionEvents:

• Action

The following information can be sent via both pageViewEvents and actionEvents:

• Campaign

• Customer

• Product

• Order

• Goal

• Session

The following information can be sent in MediaEvents:

• Media

• Action

• E-commerce

• Session

/**
 * @Action(Event) tracking function
 * @return void
 */
trackAction(ActionEvent actionEvent) → Future<void>
/**
 * @Media tracking function
 * @return void
 */
trackMedia(MediaEvent mediaEvent) → Future<void>
/**
 * @Page(Screen) trakcing function
 * @return void
 */
trackPage(String customName, [Map<String, String>? trackingParameters]) → Future<void>
/**
 * @ * @Page(Screen) trakcing function with custom data and PageViewEvent
 * @return void
 */
trackPageWithCustomData(PageViewEvent? pageViewEvent, [String? customName]) → Future<void>

Deep link

Deep Link tracking allows you to analyze campaigns that are deep linked to a screen of your mobile app.

/**

 * @param url specifies the URL to be tracked. Please note that you need to use the campaign format used by Mapp Intelligence.

 * @return void

 */

trackUrl(String urlString, String? mediaCode) → Future<void>

/**

 * Campaign that uses "wt_mc" as media code.

*/

buttons.add(ElevatedButton(

      onPressed: () async {

        var urlString =

            "https://testurl.com/?wt_mc=email.newsletter.nov2020.thursday&wt_cc45=parameter45";

        PluginMappintelligence.trackUrl(urlString, null);

        String className = this.runtimeType.toString();

        PluginMappintelligence.trackPageWithCustomData(null, className);

      },

      child: Text('Test Link1'),

      style:

          ElevatedButton.styleFrom(primary: Theme.of(context).primaryColorDark),

    ));

/**

 * Campaign that uses a custom media code.

*/

    buttons.add(ElevatedButton(

      onPressed: () async {

        var urlString =

            "https://testurl.com/?customMc=email.newsletter.nov2020.thursday&wt_cc12=parameter12";

        PluginMappintelligence.trackUrl(urlString, "customMc");

        String className = this.runtimeType.toString();

        PluginMappintelligence.trackPageWithCustomData(null, className);

      },

Anonymous Tracking

With anonymous tracking it is possible to track usage of the mobile application without a persistent tracking of a user across sessions. When anonymous tracking is enabled, the default user identifier is not set. It is possible to set a temporary session ID to provide a better data quality during session tracking. The temporary session ID identifies requests from the same session.

/**

 * Anonymous tracking can be called on initialization or during runtime.

*/

// Enable anonymous tracking. If needed, include a String of additional parameters to be excluded from tracking if anonymous tracking is enabled.  
setAnonymousTracking(bool enabled, List <String>) -> Future<void>

// Set a temporary session ID.

setTemporarySessionId(<String>) -> Future<String>

User Matching

User Matching allows you to use Intelligence analytics data to better target users via mobile push or in App messages in Engage.

/**

 * User matching only works if anonymous tracking is inactive. It is possible to set user matching on initialisation as well as on runtime.

*/

setUserMatchingEnabled(bool enabled) → Future<void>

Opt-out

/**
 * set to true if you want to send the currently cached data before setting the opt-out. Default is false.
 */
optOutAndSendCurrentData(bool value) → Future<void>

Opt-in

/**
 * @return void
 */
optIn() → Future<void>

Get EverID

/**
 * @return everID
 */
getEverID() → Future<String>

Change TrackID and Track Domain on Runtime

It is possible to change the track ID and track domain on runtime.

/**
 * @return everID
 */
PluginMappintelligence.setIdsAndDomain([array String account ID], String track domain);

WebView

For a complete description of tracking WebView data please refer to Data > WebView.

/**
 * Setup function for webview
 * only for iOS
 */
trackWebview(double? x, double? y, double? width, double? height, String urlString) → Future<void>
/**
 * dispose function for webview
 * only for iOS
 */
disposeWebview() → Future<void>

/**
 * Import package and use like a standard flutter webview https://pub.dev/packages/webview_flutter/install
 */
import 'package:plugin_mappintelligence/webview_flutter.dart';

import 'package:plugin_mappintelligence/plugin_mappintelligence.dart';

PluginMappintelligence.trackWebview(
          0.0,
          Scaffold.of(context).appBarMaxHeight ??
              MediaQuery.of(context).padding.top + kToolbarHeight,
          MediaQuery.of(context).size.width,
          MediaQuery.of(context).size.height -
              (Scaffold.of(context).appBarMaxHeight ??
                  MediaQuery.of(context).padding.top + kToolbarHeight),
          'http://demoshop.webtrekk.com/web2app/index.html');

import 'package:plugin_mappintelligence/webview_flutter.dart';

 return Scaffold(
      appBar: AppBar(
        title: Text('WebviewForAndroid'),
      ),
      body: WebView(
          initialUrl: 'http://demoshop.webtrekk.com/web2app/index.html',
          javascriptMode: JavascriptMode.unrestricted,
      
          }),
    );

Send Request Immediately (Android only)

Due to the use of WorkManager, Android is limited in terms of the scheduled sending of requests. As long as the app is used in the foreground, it is possible to trigger the sending of requests on any event trigger.

PluginMappintelligence.sendAndCleanData()

Print Current Configuration

While testing and debugging the configuration, it can be helpful to print out the currently active global configuration to the console.

PluginMappintelligence.getCurrentConfig()

Reset Singleton

For testing purposes, it's helpful to be able to reset the Intelligence singleton. Resetting the singleton will reset the SDK configuration to its default values.

PluginMappintelligence.reset()