Logging

App events are the key actions that people take, such as launching your app, viewing content or making a purchase.

You can log app events for any meaningful actions people take in your app. There are many pre-defined events such as completed registration, viewed content, searched, added to cart, spent credits and more.

Analytics for Apps supports up to 1,000 unique app events for your app, so you can also define your own custom events.

Application activate and deactivate events are automatically handled by the extension.

App Events

To log an app event you create an instance of the FacebookAppEvent class and pass it to the Facebook.instance.appEventsLogger.logEvent() function:

var event:AppEvent = 
    new AppEvent()
        .setEventName( AppEventsConstants.EVENT_NAME_ADDED_TO_CART )
        .setValueToSum( 54.23 )
        .setParameter( AppEventsConstants.EVENT_PARAM_CURRENCY, "USD" )
        .setParameter( AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product" )
        .setParameter( AppEventsConstants.EVENT_PARAM_CONTENT_ID, "HDFU-8452" )
    ;

Facebook.instance.appEventsLogger.logEvent( event );

The AppEventConstants class defines the current constants for event names and parameters for the standard set of Facebook events.

You can also specify a set of parameters (up to 25 parameters) and a valueToSum property which is an arbitrary number that can represent any value (e.g., a price or a quantity). When reported, all of the valueToSum properties will be summed together. For example, if 10 people each purchased one item that cost $10 (and passed in valueToSum) then they would be summed to report a number of $100.

The parameters are set in the parameters object event.parameters or using the event.setParameter() function. The must be String or Number values.

Note that both the valueToSum and parameters arguments are optional.

The full list of pre-defined events and pre-defined parameters are listed in the AppEventConstants class or in the Facebook documentation.

Custom App Events

You can also choose to create your own custom events, which is done simply by specifying their name as a string:

var event:AppEvent = new AppEvent( "a_custom_event_name" );
                
Facebook.instance.appEventsLogger.logEvent( event );

The maximum number of different event names is 1,000. Note no new event types will be logged once this cap is hit. However it is possible to deactivate obsolete events.

Read more about event limits in the FAQ.

Purchase Events

You can log purchase events using the logPurchase function.

var event:AppPurchaseEvent = new AppPurchaseEvent( 
    79.99,
    "USD"
);

Facebook.instance.appEventsLogger.logPurchase( event );

The currency specification is expected to be an ISO 4217 currency code. This is used to determine a uniform value for use in ads optimization.

Further Information

More information can be found in the Facebook documentation