Flutter元数据管理插件flutter_meta_sdk_flutter的使用

Flutter元数据管理插件flutter_meta_sdk_flutter的使用

flutter_meta_sdk 允许你将 Flutter 与原生 Meta SDK 集成。

该插件目前支持 iOS 和 Android 的应用事件和深度链接。此插件是使用最新 SDK 创建的，以包含对 iOS 14 的支持。

设置

首先，如果你还没有一个，必须先在 Facebook 开发者处创建一个应用：

1. 获取你的应用 ID（在以下示例中用 [APP_ID] 表示）
2. 获取你的客户端令牌（在以下示例中用 [CLIENT_TOKEN] 表示）。 有关详细信息和如何获取它，请参阅“Facebook 文档：客户端令牌”。

对于 iOS

更多信息可以查看 Facebook SDK 官方文档。请阅读“开始使用 iOS 应用事件”教程，并特别注意第 5 步，通过打开 info.plist 作为源代码并添加以下内容：

• 如果你的代码中没有 CFBundleURLTypes，则在最后一个 </dict> 元素之前添加以下内容：

<key>CFBundleURLTypes</key>
<array>
  <dict>
  <key>CFBundleURLSchemes</key>
  <array>
    <string>fb[APP_ID]</string>
  </array>
  </dict>
</array>
<key>FacebookAppID</key>
<string>[APP_ID]</string>
<key>FacebookClientToken</key>
<string>[CLIENT_TOKEN]</string>
<key>FacebookDisplayName</key>
<string>[APP_NAME]</string>

• 如果你的代码已经包含 CFBundleURLTypes，则插入以下内容：

<array>
 <dict>
 <key>CFBundleURLSchemes</key>
 <array>
   <string>fb[APP_ID]</string>
 </array>
 </dict>
</array>
<key>FacebookAppID</key>
<string>[APP_ID]</string>
<key>FacebookClientToken</key>
<string>[CLIENT_TOKEN]</string>
<key>FacebookDisplayName</key>
<string>[APP_NAME]</string>

对于 Android

更多信息可以查看 Facebook SDK 官方文档。请阅读“开始使用 Android 应用事件”教程，并特别注意第 3 步，通过将以下内容添加到 /app/res/values/strings.xml 中（或相应的 debug 或 release 构建风味）：

<string name="facebook_app_id">[APP_ID]</string>
<string name="facebook_client_token">[CLIENT_TOKEN]</string>

然后，在你的主 AndroidManifest.xml 文件中直接在 <application> 标签下添加这些字符串资源引用：

<application android:label="@string/app_name" ...>
    ...
    <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>
    <meta-data android:name="com.facebook.sdk.ClientToken" android:value="@string/facebook_client_token"/>
    ...
</application>

关于 Flutter Meta SDK

请参考官方 SDK 文档了解 Facebook 应用事件的正确行为。如果发现任何不符合官方文档的行为，请在 GitHub 上报告问题。

参与

首先，感谢你考虑参与进来。你是真正的超级英雄⭐，我们爱你！

报告错误和问题

在报告问题时，请使用配置好的 GitHub 问题报告模板。确保尽可能客观和详细地描述你的观察结果和期望，以便我们能够理解你的需求并进行排查。

讨论和想法

我们很高兴在仓库讨论中讨论和交流想法，或者你可以将问题发布到 StackOverflow。

如果你有任何关于如何使用 Facebook SDK 作为报告工具，或者如何使用此插件的问题，都可以随时提问。

示例代码

以下是完整的示例代码，展示了如何使用 flutter_meta_sdk 插件：

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

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

class MyApp extends StatelessWidget {
  static final metaSdk = FlutterMetaSdk();

  const MyApp({Key? key}) : super(key: key);

  [@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: [
              FutureBuilder(
                future: metaSdk.getAnonymousId(),
                builder: (context, snapshot) {
                  final id = snapshot.data ?? '???';
                  return Text('Anonymous ID: $id');
                },
              ),
              MaterialButton(
                child: const Text("点击我！"),
                onPressed: () {
                  // 记录按钮点击事件
                  metaSdk.logEvent(
                    name: 'button_clicked',
                    parameters: {
                      'button_id': 'the_clickme_button',
                    },
                  );
                },
              ),
              MaterialButton(
                child: const Text("设置用户数据"),
                onPressed: () {
                  // 设置用户数据
                  metaSdk.setUserData(
                    email: 'opensource@oddbit.id',
                    firstName: 'Oddbit',
                    dateOfBirth: '2019-10-19',
                    city: 'Denpasar',
                    country: 'Indonesia',
                  );
                },
              ),
              MaterialButton(
                child: const Text("测试添加到购物车"),
                onPressed: () {
                  // 添加到购物车事件
                  metaSdk.logAddToCart(
                    id: '1',
                    type: 'product',
                    price: 99.0,
                    currency: 'TRY',
                  );
                },
              ),
              MaterialButton(
                child: const Text("测试购买！"),
                onPressed: () {
                  // 记录购买事件
                  metaSdk.logPurchase(amount: 1, currency: "USD");
                },
              ),
              MaterialButton(
                child: const Text("启用广告跟踪！"),
                onPressed: () {
                  // 启用广告跟踪
                  metaSdk.setAdvertiserTracking(enabled: true);
                },
              ),
              MaterialButton(
                child: const Text("禁用广告跟踪！"),
                onPressed: () {
                  // 禁用广告跟踪
                  metaSdk.setAdvertiserTracking(enabled: false);
                },
              ),
            ],
          ),
        ),
      ),
    );
  }
}