facebook_app_events 0.5.0

  • Readme
  • Changelog
  • Example
  • Installing
  • 92

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

<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.

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

0.5.0 #

  • Fixing issues ( #2, #4 and #8: breaking configuration change for Android. See the README with information on what to add in AndroidManifest.xml

0.4.0 #

  • Breaking name change of logActivateApp to logActivatedApp
  • Adding shorthand log methods
    • logDeactivatedApp
    • logCompletedRegistration
    • logRated
    • logViewContent

0.3.0 #

  • Add sample of shorthand log methods for app events.
    • logActivateApp

0.2.1 #

  • Bug fixing.

0.2.0 #

  • Adding app events
    • logPushNotificationOpen
    • flush
    • getApplicationId

0.1.0 #

  • First initial release supporting some basic functionality
    • clearUserData
    • clearUserID
    • logEvent
    • setUserData
    • setUserID
    • updateUserProperties

example/README.md

facebook_app_events_example #

Demonstrates how to use the facebook_app_events plugin. Read the offical "getting started" documentation for full understanding.

Logging events #

import 'package:facebook_app_events/facebook_app_events.dart';
...
final facebookAppEvents = FacebookAppEvents();
facebookAppEvents.logEvent(
    name: 'button_clicked',
    parameters: {
        'button_id': 'the_clickme_button',
    },
);

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  facebook_app_events: ^0.5.0

2. Install it

You can install packages from the command line:

with Flutter:


$ flutter pub get

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:facebook_app_events/facebook_app_events.dart';
  
Popularity:
Describes how popular the package is relative to other packages. [more]
84
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
100
Overall:
Weighted score of the above. [more]
92
Learn more about scoring.

We analyzed this package on Dec 9, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.6.1
  • pana: 0.13.1+4
  • Flutter: 1.12.13+hotfix.2

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.1.0 <3.0.0
flutter 0.0.0
Transitive dependencies
collection 1.14.11 1.14.12
meta 1.1.8
sky_engine 0.0.99
typed_data 1.1.6
vector_math 2.0.8
Dev dependencies
flutter_test