/flutter_facebook_app_events

Flutter Plugin for Facebook App Events

Primary LanguageDartApache License 2.0Apache-2.0

facebook_app_events

pub package

Flutter plugin for Facebook App Events and analytics.

An app event is an action that takes place in your app or on your web page such as a person installing your app or completing a purchase. Facebook App Events allows you to track these events to view analytics, measure ad performance, and build audiences for ad targeting.

Flutter plugin for Facebook App Events, an app measurement solution that provides insight on app usage and user engagement in Facebook Analytics.

Setting things up

You must first create an app at Facebook for developers: https://developers.facebook.com/

Get your app id (referred to as [APP_ID] below)

Configure Android

Read through the "Getting Started with App Events for Android" tutuorial and in particular, follow step 2 by adding the following into /app/res/values/strings.xml (or into respective debug or release build flavor)

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

After that, add that string resource reference to your main AndroidManifest.xml file, directly under the <application> tag.

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

Configure iOS

Read through the "Getting Started with App Events for iOS" tutuorial and in particular, follow step 4 by opening info.plist "As Source Code" and add the following

  • If your code does not have CFBundleURLTypes, add the following just before the final </dict> element:
<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>
  • If your code already contains CFBundleURLTypes, insert the following:
<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>

About Facebook App Events and Facebook Analytics

Please refer to the official SDK documentation for iOS and Android respectively for the correct and expected behavior. Please report an issue if you find anything that is not working according to official documentation.

Getting involved

First of all, thank you for even considering to get involved. You are a real super ⭐ and we ❤️ you!

Please do not use the Github issues for discussions or questions about usage. Send an email to opensource@oddbit.id if you have a great idea or something that that can't be helped by the community.

Try asking the community on StackOverflow if it is general questions on how to use either the Facebook App Events as a reporting tool itself or even on how to use this plugin.

Facebook Analytics

The events that your app is reporting will appear in Facebook Analytics for apps. You can read more about how to configure your dashboard and best practices on how to report data in Facebook help resources: https://www.facebook.com/help/analytics/319598688400448