@datacamp/react-native-snowplow-tracker

@datacamp/react-native-snowplow-tracker

Please note this currently only binds very basic tracker features.

Getting started

Install the native Snowplow Tracker in your project by following the official instructions [iOS/Android].

$ npm install @datacamp/react-native-snowplow-tracker --save

Mostly automatic installation

$ react-native link @datacamp/react-native-snowplow-tracker

Manual installation

iOS

• In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
• Go to node_modules ➜ react-native-snowplow-tracker and add RNSnowplowTracker.xcodeproj
• In XCode, in the project navigator, select your project. Add libRNSnowplowTracker.a to your project's Build Phases ➜ Link Binary With Libraries
• Run your project (Cmd+R)<

Android

• Open up android/app/src/main/java/[...]/MainActivity.java

• Add import com.snowplow.RNSnowplowTrackerPackage; to the imports at the top of the file
• Add new RNSnowplowTrackerPackage() to the list returned by the getPackages() method

• Append the following lines to android/settings.gradle:

  include ':@datacamp_react-native-snowplow-tracker'
  project(':@datacamp_react-native-snowplow-tracker').projectDir = new File(rootProject.projectDir, 	'../node_modules/@datacamp/react-native-snowplow-tracker/android')
  

• Insert the following lines inside the dependencies block in android/app/build.gradle:

    implementation project(':@datacamp_react-native-snowplow-tracker')
  

Usage

import Snowplow from '@datacamp/react-native-snowplow-tracker';

// Initialize
Snowplow.initialize({
  endpoint: 'com.acme.net',
  protocol: 'https',
  httpMethod: 'POST',
  namespace: 'your-namespace',
  appId: 'your-app',
})

// Track structured events
Snowplow.trackStructEvent({
    category: 'shop',
    action: 'add-to-basket',
    label: 'Add To Basket',
    property: 'pcs',
    value: 2.0,
})