mparticle

Ionic mParticle Integration for Capacitor#

The mParticle plugin provides easy integration with the mParticle SDK in your Capacitor app.

Installation#

ionic enterprise register
npm install @ionic-enterprise/capacitor-mparticle-integration
npx cap sync

Configuration#

In capacitor.config.json add your keys, secrets, environment, logLevel and bridgeName.

environment is optional, if not provided mParticle will auto detect it. Possible values are "development" and "production".

logLevel is optional. It allows to configure mParticke SDK log level. If not provided, mParticle won't show any logs. Possible values are "debug", "error", "verbose" and "warning".

bridgeName is optional. If set, it has to match the requiredWebviewBridgeName on the mParticle SDK initialization.

"plugins": {
    "CapacitorMparticleIntegration": {
      "ios-key": "my iOS key",
      "ios-secret": "my iOS secret",
      "android-key": "my Android key",
      "android-secret": "my Android secret",
      "environment": "development",
      "bridgeName": "mycustombridgename",
      "logLevel": "warning"
    }
}

In the javascript mParticle initialization code add useNativeSdk: true and requiredWebviewBridgeName with a value that matches bridgeName on the plugin preferences.

window.mParticle = {
  config: {
    useNativeSdk: true,
    requiredWebviewBridgeName: "mycustombridgename"
  }
};

Register plugin for Android#

In the init method of MainActivity.java add:

add(CapacitorMparticleIntegration.class);

Register plugin for iOS#

Plugin is auto-registered on iOS.