NativeScript Salesforce DMP 插件

这是一个用于使用 Salesforce DMP SDK 的插件（Android v4.3.2，iOS v4.3.0）。要使用此插件，您需要一个 Salesforce DMP 的账户。

安装

从您项目的根目录运行以下命令

tns plugin add @essent/nativescript-salesforce-dmp

设置（仅限 Android）

请确保将以下权限添加到您的应用 AndroidManifest.xml 文件中

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

将以下服务添加到您的应用 AndroidManifest.xml 文件中的应用标签中（示例）

<service android:name="com.krux.androidsdk.aggregator.EventPublisherService" android:enabled="true" />
<service android:name="com.krux.androidsdk.aggregator.ConsentService" android:enabled="true" />

将 play-services-ads 添加到您的应用 app.gradle 文件中的依赖项（示例）

compile 'com.google.android.gms:play-services-ads:10.2.4'

使用

要使用 nativescript-salesforce-dmp，您必须首先导入模块

import { SalesforceDMP, KeyValue } from '@essent/nativescript-salesforce-dmp';

在您的应用启动时，使用配置 ID 调用 initialize

SalesforceDMP.getInstance().initialize('YOUR_CONFIG_ID', true);

同意

在开始使用 Salesforce DMP 之前，用户需要同意。有关这些标志的更多信息，请参阅这篇支持文章。
设置同意

const consentAttributes: KeyValue<string> = {
    pr: '1',
    dc: '1',
    al: '1',
    tg: '1',
    cd: '1',
    sh: '0',
    re: '1'
};
SalesforceDMP.getInstance().setConsent(consentAttributes);

快速移除所有同意标志

SalesforceDMP.getInstance().removeConsent();

跟踪

要跟踪页面视图，调用 trackPageView（可选地，您可以使用 pageAttributes 和 userAttributes）

SalesforceDMP.getInstance().trackPageView('TestPage', null, null);

要触发事件，调用 fireEvent

const attributes: KeyValue<string> = {
    event_id: 'YOUR_EVENT_ID', // this attribute is mandatory
    myKey: 'An event value'
};
SalesforceDMP.getInstance().fireEvent('TestEvent', attributes);