NativeScript: Facebook Analytics

仅添加 Facebook Analytics 到您的 Nativescript 应用，而不是完整的 Facebook SDK。

此插件基于 nativescript-facebook，但仅包含用于分析所需的 Facebook 核心库。这种方式相比包含完整 Facebook SDK 的 nativescript-facebook，可减少 86% 的包大小。如果您想了解更多，可以阅读这篇 博客文章。

安装

tns plugin add nativescript-fb-analytics

配置

以下配置是开始使用 Facebook Analytics 所必需的。为了获取 Facebook App-ID，请参阅官方 文档。

在调用 app.run 之前初始化插件

/* your-project/app/app.ts */
import * as app from "tns-core-modules/application";
import * as fbAnalytics from 'nativescript-fb-analytics';

app.on(app.launchEvent, function (args) {
    fbAnalytics.initAnalytics();
});

Android 需要的额外配置

<!--your-project/app/App_Resources/Android/src/main/res/values/strings.xml-->
<string name="facebook_app_id">YOUR_APP_ID</string>


<!--your-project/app/App_Resources/Android/src/main/res/AndroidManifest.xml-->
<application
	android:name="com.tns.NativeScriptApplication"
	android:allowBackup="true"
	android:icon="@drawable/icon"
	android:label="@string/app_name"
	android:theme="@style/AppTheme">
    
    <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>
	...
</application>

iOS 需要的额外配置

<!--your-project/app/App_Resources/iOS/Info.plist-->
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
      <array>
        <string>fbYOUR_APP_ID</string>
      </array>
  </dict>
</array>
<key>FacebookAppID</key>
<string>YOUR_APP_ID</string>
<key>FacebookDisplayName</key>
<string>YOUR_APP_NAME</string>

用法

您可以通过导入

import * as fbAnalytics from 'nativescript-fb-analytics';

并调用

fbAnalytics.logEvent('Lead');

您还可以向事件记录添加参数

const value = 5;
const parameters = [{
    key: 'value',
    value: value.toString(),
}];

fbAnalytics.logEvent(FundsAdded, parameters);