angulartics-cordova-facebook

Facebook App Events plugin for cordova apps using Angulartics. Based on angulartics-facebook-pixel which is an excellent plugin for using the Facebook Pixel on your website.

Install

Install cordova-plugin-facebook cordova plugin.

Install Angulartics (make sure you've read installation and setup instructions for Angulartics ).

Then you can install this package with npm.

npm

npm install angulartics-cordova-facebook

Then add angulartics.facebook.cordova as a dependency for your app:

require('angulartics')  
  
angular.module('myApp', [  
 'angulartics',  require('angulartics-cordova-facebook')  
]);

Using built in Facebook events

You can use any event name and properties you like and Facebook will treat these as a custom event.

If you want Facebook to pick up their pre-defined events then use on the of the event names below. I have listed the Facebook code constant name and the actual string you should use below. See the official documentation here: Facebook App Standard Events

FBSDKAppEventNameAchievedLevel: "fb_mobile_level_achieved"
FBSDKAppEventNameAddedPaymentInfo: "fb_mobile_add_payment_info"
FBSDKAppEventNameAddedToCart: "fb_mobile_add_to_cart"
FBSDKAppEventNameAddedToWishlist: "fb_mobile_add_to_wishlist"
FBSDKAppEventNameCompletedRegistration: "fb_mobile_complete_registration"
FBSDKAppEventNameCompletedTutorial: "fb_mobile_tutorial_completion"
FBSDKAppEventNameInitiatedCheckout: "fb_mobile_initiated_checkout"
FBSDKAppEventNameRated: "fb_mobile_rate"
FBSDKAppEventNameSearched: "fb_mobile_search"
FBSDKAppEventNameSpentCredits: "fb_mobile_spent_credits"
FBSDKAppEventNameUnlockedAchievement: "fb_mobile_achievement_unlocked"
FBSDKAppEventNameViewedContent: "fb_mobile_content_view"

Pre-defined parameter names

FBSDKAppEventParameterNameContentID: "fb_content_id"
FBSDKAppEventParameterNameContentType: "fb_content_type"
FBSDKAppEventParameterNameCurrency: "fb_currency"
FBSDKAppEventParameterNameDescription: "fb_description"
FBSDKAppEventParameterNameLevel: "fb_level"
FBSDKAppEventParameterNameMaxRatingValue: "fb_max_rating_value"
FBSDKAppEventParameterNameNumItems: "fb_num_items"
FBSDKAppEventParameterNamePaymentInfoAvailable: "fb_payment_info_available"
FBSDKAppEventParameterNameRegistrationMethod: "fb_registration_method"
FBSDKAppEventParameterNameSearchString: "fb_search_string"
FBSDKAppEventParameterNameSuccess: "fb_success"
FBSDKAppEventParameterValueYes: "1"
FBSDKAppEventParameterValueNo: "0"

Documentation

Documentation is available on the Angulartics site.

Page views will be tracked as a Facebook ContentView.

Any other event will appear as a custom event unless you use one of the predefined names above.

Development

npm run build

License

MIT

angulartics-cordova-facebook