Flutter Facebook事件集成插件facebook_event的使用

Flutter Facebook事件集成插件facebook_event的使用

Flutter 插件用于 Facebook 事件 和分析。

安装

首先，您需要在 Facebook 开发者平台创建一个应用：https://developers.facebook.com/。

获取您的应用 ID（以下称为 [APP_ID]）。

Android

阅读 “为 Android 应用程序开始使用应用程序事件” 教程，并特别注意步骤 2，在 /app/res/values/strings.xml 文件（或 debug 或 release 构建口味文件）中添加以下内容：

之后，将该字符串资源引用添加到您的主 <AndroidManifest.xml> 文件中，直接在 <application> 标签下。

<meta-data
  android:name="com.facebook.sdk.ApplicationId"
  android:value="your_facebook_app_id_here" />

示例代码：

<!-- https://github.com/faisal-kabir/facebook_event/blob/main/example/android/app/src/main/AndroidManifest.xml -->

在您的 Android 项目中添加以下代码到 MainActivity.kt：

setAutoLogAppEventsEnabled(true)
FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()
setAdvertiserIDCollectionEnabled(true)
FacebookSdk.setIsDebugEnabled(true);
FacebookSdk.addLoggingBehavior(LoggingBehavior.APP_EVENTS);

示例代码：

<!-- https://github.com/faisal-kabir/facebook_event/blob/main/example/android/app/src/main/kotlin/com/faisal/facebook_event/facebook_event_example/MainActivity.kt -->

iOS

阅读 “为 iOS 应用程序开始使用应用程序事件” 教程，并特别注意步骤 4，通过以源代码形式打开 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>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>FacebookDisplayName</key>
<string>[APP_NAME]</string>

示例代码：

<!-- https://github.com/faisal-kabir/facebook_event/blob/main/example/ios/Runner/Info.plist -->

在您的 iOS 项目中添加以下代码到 AppDelegate.swift：

ApplicationDelegate.shared.application(application, didFinishLaunchingWithOptions: launchOptions)
AppEvents.activateApp()
AppEvents.logEvent(AppEvents.Name.init(rawValue: "Opened App Main VC"))

示例代码：

<!-- https://github.com/faisal-kabir/facebook_event/blob/main/example/ios/Runner/AppDelegate.swift -->

获取 Android 哈希密钥

final facebookEvent = FacebookEvent();
String hashKey='Null';

[@override](/user/override)
void initState() {
    // TODO: implement initState
    super.initState();
    if(Platform.isAndroid)
      getHashKey();
}

void getHashKey()async{
    hashKey= await facebookEvent.getAndroidHashKey();
    print(hashKey);
}

所有事件

final facebookEvent = FacebookEvent();

// 获取 Facebook 应用程序 ID
facebookEvent.getApplicationId();

/// 当应用程序被激活时记录，通常在 AppDelegate 的 applicationDidBecomeActive 中。
facebookEvent.logActivatedApp();

// 当应用程序被停用时记录此事件。
facebookEvent.logDeactivatedApp();

// 在用户同意后重新启用应用程序事件的自动记录
facebookEvent.setAutoLogAppEventsEnabled(true);

// 提交用户详细信息
facebookEvent.setUserData(
  email:'email',
  firstName:'first name',
  lastName:'last name',
  phone:'phone number',
  dateOfBirth:'dob',
  gender:'gender',
  city:'city',
  state:'state',
  zip:'zip',
  country:'country',
);

// 记录自定义事件
facebookEvent.logEvent(
    name: 'name',
    body: {'key':'value'},
    valueToSum: 0
);

// 记录联系人详情
facebookEvent.logContactEvent(contact: 'number');

// 用户查看了应用程序中的某种内容。
facebookEvent.logViewContent(
  content: {'key':'value'},
  id: 'id',
  type: 'type'
);

// 用户完成了购买。指定货币。
facebookEvent.logPurchase(
  amount: 0,
  currency: 'USD',
  body: {'key':'value'}
);

// 用户在游戏中达到了某个等级。
facebookEvent.logAchieveLevelEvent(
  level: 'level'
);

// 用户输入了支付信息。
facebookEvent.logAddPaymentInfoEvent(
  success: true
);

// 用户将商品添加到了购物车。传递的 valueToSum 应该是商品的价格。
facebookEvent.logAddToCartEvent(
  price:0,
  contentData: 'contentData',
  contentType: 'contentType',
  contentId: 'contentId',
  currency: 'USD'
);

// 用户完成了应用程序注册。
facebookEvent.logCompleteRegistrationEvent(
  registrationMethod:'registrationMethod',
  name: 'name',
  currency: 'USD'
);

// 用户进入了结账流程。传递的 valueToSum 应该是购物车中的总价。
facebookEvent.logInitiateCheckoutEvent(
  totalPrice:0,
  contentData: 'contentData',
  contentType: 'contentType',
  contentId: 'contentId',
  currency: 'USD',
  numItems: 1,
  paymentInfoAvailable: true
);

// 用户对应用程序中的某项进行了评分。传递的 valueToSum 应该是数值评分。
facebookEvent.logRateEvent(
  ratingGiven:5,
  contentData: 'contentData',
  contentType: 'contentType',
  contentId: 'contentId',
  maxRatingValue: 5
);

示例代码

import 'dart:io';

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

import 'package:flutter/services.dart';
import 'package:facebook_event/facebook_event.dart';

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

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

class _MyAppState extends State<MyApp> {
  static FacebookEvent? facebookEvent;
  String hashKey='Null';

  _MyAppState(){
    facebookEvent = FacebookEvent();
  }

  [@override](/user/override)
  void initState() {
    // TODO: implement initState
    super.initState();
    if(Platform.isAndroid)
      getHashKey();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                child: Text("记录 AchieveLevelEvent"),
                onPressed: () {
                  facebookEvent!.logAchieveLevelEvent(
                    level: 'Payment',
                  );
                },
              ),
            ],
          ),
        ),
      ),
    );
  }

  void getHashKey()async{
    hashKey = (await facebookEvent!.getAndroidHashKey())!;
    print(hashKey);
  }
}