A NativeScript plugin to use the Salesforce DMP mobile SDK.
npm install @essent/nativescript-salesforce-dmp
This is a plugin to use the Salesforce DMP SDK (Android v4.3.2, iOS v4.3.0). To use this plugin you need to have an account for Salesforce DMP.
Run the following command from the root of your project:
``console`
tns plugin add @essent/nativescript-salesforce-dmp
Make sure you add the following permissions to the AndroidManifest.xml file of your app:
`xml`
Add the following services to the application tag in the AndroidManifest.xml file of your app (example):
`xml`
Add play-services-ads to the dependencies in the app.gradle file of your app (example):
`gradle`
compile 'com.google.android.gms:play-services-ads:10.2.4'
To use nativescript-salesforce-dmp you must first import the module:
`ts`
import { SalesforceDMP, KeyValue } from '@essent/nativescript-salesforce-dmp';
At the launch of your app call initialize with your config id:`ts`
SalesforceDMP.getInstance().initialize('YOUR_CONFIG_ID', true);
Before using Salesforce DMP the user needs to give consent. More information about these flags can be found in this support article.
To set the consent:
`ts`
const consentAttributes: KeyValue
pr: '1',
dc: '1',
al: '1',
tg: '1',
cd: '1',
sh: '0',
re: '1'
};
SalesforceDMP.getInstance().setConsent(consentAttributes);
To quickly remove all consent flags:
`ts`
SalesforceDMP.getInstance().removeConsent();
To track page views call trackPageView (optionally you can use pageAttributes and userAttributes):`ts`
SalesforceDMP.getInstance().trackPageView('TestPage', null, null);
To fire events call fireEvent:`ts``
const attributes: KeyValue
event_id: 'YOUR_EVENT_ID', // this attribute is mandatory
myKey: 'An event value'
};
SalesforceDMP.getInstance().fireEvent('TestEvent', attributes);