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

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

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

该插件使用最新版本的SDK以支持iOS 14。目前，该插件支持iOS和Android的应用事件和深层链接。

设置

首先，如果您还没有一个应用，请先在Facebook开发者平台上创建一个应用：Facebook开发者平台。

1. 获取您的应用ID（在以下示例中称为[APP_ID]）。
2. 获取您的客户端令牌（在以下示例中称为[CLIENT_TOKEN]）。 更多信息及如何获取客户端令牌，请参阅Fcaebook文档：客户端令牌。

请确保将[APP_ID]替换为您的应用ID。

对于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

请参阅Facebook应用事件的官方SDK文档：

• iOS文档
• Android文档

如果您发现任何不符合官方文档的行为，请在此报告问题。

参与贡献

首先，感谢您考虑参与贡献。您是一个真正的超级明星⭐，我们❤️您！

报告错误和问题

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

讨论和想法

我们很高兴在仓库讨论区讨论和分享想法，或者您可以将问题发布到StackOverflow。

如果您有任何关于如何使用Facebook SDK作为报告工具或如何使用此插件的问题，请随时发帖提问。

示例代码

示例代码：example/lib/main.dart

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

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

class MyApp extends StatelessWidget {
  // 初始化Meta SDK
  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: [
              // 获取匿名ID
              FutureBuilder(
                future: metaSdk.getAnonymousId(),
                builder: (context, snapshot) {
                  final id = snapshot.data ?? '???';
                  return Text('Anonymous ID: $id');
                },
              ),
              // 点击按钮记录事件
              MaterialButton(
                child: const Text("Click me!"),
                onPressed: () {
                  metaSdk.logEvent(
                    name: 'button_clicked',
                    parameters: {
                      'button_id': 'the_clickme_button',
                    },
                  );
                },
              ),
              // 设置用户数据
              MaterialButton(
                child: const Text("Set user data"),
                onPressed: () {
                  metaSdk.setUserData(
                    email: 'opensource@oddbit.id',
                    firstName: 'Oddbit',
                    dateOfBirth: '2019-10-19',
                    city: 'Denpasar',
                    country: 'Indonesia',
                  );
                },
              ),
              // 记录添加到购物车事件
              MaterialButton(
                child: const Text("Test logAddToCart"),
                onPressed: () {
                  metaSdk.logAddToCart(
                    id: '1',
                    type: 'product',
                    price: 99.0,
                    currency: 'TRY',
                  );
                },
              ),
              // 记录购买事件
              MaterialButton(
                child: const Text("Test purchase!"),
                onPressed: () {
                  metaSdk.logPurchase(amount: 1, currency: "USD");
                },
              ),
              // 启用广告跟踪
              MaterialButton(
                child: const Text("Enable advertise tracking!"),
                onPressed: () {
                  metaSdk.setAdvertiserTracking(enabled: true);
                },
              ),
              // 禁用广告跟踪
              MaterialButton(
                child: const Text("Disabled advertise tracking!"),
                onPressed: () {
                  metaSdk.setAdvertiserTracking(enabled: false);
                },
              ),
            ],
          ),
        ),
      ),
    );
  }
}