Skip to main content

Usage

Kettle​

Consents​

import { KettleConsents } from 'react-native-kettle-module';

KettleConsent.SURVEYS
KettleConsent.ANALYTICS
KettleConsent.CAMPAIGNS
KettleConsent.ADS

Granting consents​

Defines what the data collected from the user can be used for.

Kettle.grant([KettleConsent.SURVEYS, KettleConsent.ANALYTICS, KettleConsent.CAMPAIGNS, KettleConsent.ADS]);

Revoking consents​

Removes previously granted user consent.

Kettle.revoke([KettleConsent.SURVEYS, KettleConsent.ANALYTICS, KettleConsent.CAMPAIGNS, KettleConsent.ADS]);

Retrieve granted consents​

Returns an array containing the consents granted to Kettle.

await Kettle.getGrantedConsents();

Start Kettle​

Starts collecting data for given modules. This method can -not- be called without modules.

import { KettleConsents } from 'react-native-kettle-module';

Kettle.start([
  KettleModules.LOCATION,
  KettleModules.BLUETOOTH,
  KettleModules.ACTIVITY
]);

Stop Kettle​

Stops collecting data from given modules.

import { KettleConsents } from 'react-native-kettle-module';

Kettle.stop([
  KettleModules.LOCATION,
  KettleModules.BLUETOOTH,
  KettleModules.ACTIVITY
]);

Retrieve SDK status​

Returns true if Kettle is currently enabled and collecting data.

await Kettle.isStarted();

Assign push token​

Forwards the users push token to Kettle, allowing it to send push notifications.

Kettle.setPushToken("push-token");

Assign external identifier​

Forwards the users internal user ID to Kettle, allowing Kogenta to map your internal identifier with the users Kettle ID.

Kettle.setExternalId("external-id");

Kettle Identifier​

Returns the internal Kettle ID for the user.

await Kettle.getIdentifier();

Send custom data​

This function only accepts stringified json. If anything else is supplied, an exception may be thrown.

var type = "order";
var content = {"orderId": 12, "items": [1, 2, 3]};

await Kettle.addCustomEvent(type, JSON.stringify(content));

Send metadata​

This function only accepts stringified json. If anything else is supplied, an exception may be thrown. This function performs a PUT, replacing any previous values that have been sent with the same type.

let type = "email";
let content = {"email": "mail@example.tld"};
await Kettle.setMetadata(type, JSON.stringify(content));

Privacy dashboard URL​

The URL for the Kogenta Privacy Dashboard. This site can be used to view all data collected by Kettle, exporting data and request deletion of data.

await Kettle.getPrivacyDashboardUrl();

Delete collected PII & Data​

Calling this method will request deletion of all data collected by Kettle for the user. This method will delete all data currently residing on the device, as well as request deletion of data in cloud. It requires an active internet connection and accepts an optional closure that can be used to verify that the deletion request was successfully sent.

await Kettle.deleteCollectedData();

Kettle Motion Tracking​

Android​

Add the following permission to your applications manifest: <uses-permission android:name="com.google.android.gms.permission.ACTIVITY_RECOGNITION"/>

If your application targets Android 9 (API level 28) or lower, the system will auto-grant the required permission as long as the permission line is present in manifest. If you're application targets an API level higher than 28, you need to explicity request Manifest.permission.ACTIVITY_RECOGNITION during onboarding. If this doesn't work, you may have to explicitly request com.google.android.gms.permission.ACTIVITY_RECOGNITION instead.

iOS​

Add the following key and value to your applications Info.plist:

<key>NSMotionUsageDescription</key>
<string>Text to show in system dialog during permission request</string>

Motion data will be collected alongside location updates, which requires the location provider to be enabled.