Flutter Facebook应用事件追踪插件flutter_facebook_appevents的使用

Flutter Facebook应用事件追踪插件flutter_facebook_appevents的使用

2019 © Weizhong Yang.

该插件将Facebook App Events功能集成到您的Flutter应用程序中。

它帮助您安装适用于iOS和Android的Facebook SDK 5.x，并在完成应用程序配置后使您的应用程序自动开始向Facebook发送事件。如果您愿意，还可以跟踪额外的事件。

安装

在pubspec.yaml文件中添加以下依赖项：

dependencies:
  flutter_facebook_appevents:
    git: "git@gitlab.kkinternal.com:xddd/flutter_facebook_appevents.git"

然后运行flutter packages get命令。

配置

为了在iOS和Android平台上集成Facebook SDK，您需要进行一些额外的配置。

iOS

请在您的Info.plist文件中添加以下行：

<key>FacebookAppID</key>
<string>[YOUR_FB_APP_ID]</string>
<key>FacebookDisplayName</key>
<string>[YOUR_FB_APP_NAME]</string>
<key>FacebookAutoLogAppEventsEnabled</key>
<true/>
<key>FacebookAdvertiserIDCollectionEnabled</key>
<true/>
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLName</key>
        <string>Facebook</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>fb[YOUR_FB_APP_ID]</string>
        </array>
    </dict>
</array>

您的Facebook应用ID和显示名称是必需的。另一方面，您可以自行决定是否启用自动记录应用事件和收集广告ID。

Android

请在您的AndroidManifest.xml文件中的application范围内添加以下行：

<meta-data
    android:name="com.facebook.sdk.ApplicationId"
    android:value="@string/facebook_app_id" />
<meta-data
    android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
    android:value="true" />
<meta-data
    android:name="com.facebook.sdk.AutoInitEnabled"
    android:value="true" />
<meta-data
    android:name="com.facebook.sdk.AdvertiserIDCollectionEnabled"
    android:value="false" />

然后，在app/src/main/res/values目录下创建一个名为strings.xml的文件，并添加以下行：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="facebook_app_id">[YOUR_FB_APP_ID]</string>
    <string name="fb_login_protocol_scheme">fb[YOUR_FB_APP_ID]</string>
</resources>

手动事件

您可以使用插件来跟踪额外的事件。要跟踪手动事件，只需调用FacebookAppEvents.logEvent()方法。例如：

FacebookAppEvents.logEvent("EVENT_NAME", {"PARAMETER_NAME": "VALUE"});

您可以通过查看类如EventName和ParameterName来查找Facebook支持的事件和参数。

注意事项

我编写此包仅出于自己的需求，因为我在2019年6月找不到任何用于Facebook App Events的包。然而，当我发布此包时，我发现有许多其他优秀的包可以实现相同的目的。您可以考虑查看以下包：

• facebook_app_events by oddbit.id.
• facebook_analytics_plugin by Khalit Hartmann.

示例代码

以下是一个简单的示例代码，展示了如何使用flutter_facebook_appevents插件：

import 'package:flutter/material.dart';
import 'package:flutter_facebook_appevents/flutter_facebook_appevents.dart';

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              TextButton(
                  child: const Text("重置用户ID"),
                  onPressed: () => FacebookAppEvents.resetUserId()),
              TextButton(
                  child: const Text("设置用户ID"),
                  onPressed: () => FacebookAppEvents.setUserId("user")),
              TextButton(
                  child: const Text("记录事件"),
                  onPressed: () =>
                      FacebookAppEvents.logEvent("test_", {"k": "v"})),
            ],
          ),
        ),
      ),
    );
  }
}