App Events

Add events to your product to view analytics, measure ad performance, and build audiences for ad targeting.

You add code to the part of your app to identify to Analytics an app state. An app event has three parts:

  1. name - a required string that describes the event. The name appears in the Event log when the app event is sent to Analytics.

  2. ValueToSum - an optional value that Analytics adds to other Value To Sum values from app events with the same name.

  3. parameters - optional values included with your app event.

For example, the pre-defined app event Achieved Level specifies when your user achieves a level defined in the parameter.

The Facebook SDK allows you to pass two kinds of app events:

  • Pre-defined app event - events that already exist in the SDK.
  • Custom events - an app event that you define with a name, ValueToSum, and parameters.

To add app events to your Android or iOS mobile app or web page, you'll need to integrate the Facebook SDK into your app. The following links will help you integrate the appropriate SDK:

After installing FB SDK, you can add app events via the codeless set up tool, or install event codes manually.

Learn more about App Events

Best Practices
Learn best practices for implementing app events, depending on your particular type of business. See examples for apps in e-commerce, retail, gaming and travel.

FAQ
Learn the most common questions developers have related to integrating app events and using Facebook Analytics.

Facebook Analytics

Learn more about Facebook Analytics
If you implement app events in your app or website, you can use Facebook Analytics to view demographic information, build funnels to understand conversion and use cohorts to learn about actions that people take over time and more.

Take a guided tour of Facebook Analytics Demo
Visit the Facebook Analytics guided demo to get an idea of how you can use analytics to better understand your audience and improve people's experience in your app to grow your business.

View Analytics Demo

Grow your business with advertising

Targeting with app events
App events lets you build dynamic custom audiences based on the specific actions that people take. For example, you can include people who added items to a shopping cart, but haven't purchased yet. You can also create "look-alike audiences" to target campaigns to new people who are similar to your best customers.

Mobile app install ads
Create campaigns to increase the installs for your mobile app and use app events to measure the actions people take in your app after installing it.

Post install results

You can view post install results from your mobile app install ad campaigns by using Power Editor. This lets you view metrics associated with the revenue gained from your install ad campaigns. For example, you can view metrics such as yield percentage, average revenue per user (ARPU), revenue and more. You can only view these metrics if you log purchase events for your app.

Mobile app engagement ads
Improve your loyalty and retention by re-engaging people who abandoned a cart, haven't completed a tutorial or based on other actions you choose. With custom audiences, you can retarget campaigns to people to help bring them back to your app using dynamic rules that you define. Additionally, you can optimize campaigns for the app events you choose, which allows you to focus on conversions or the other actions you choose.

App event optimization
App event optimization lets you target mobile app install ad campaigns to people likely to take a specific action in your app that you define, such as making a purchase.

Dynamic Ads
You can promote relevant items from an entire catalog across any device. Display ads for thousands of items to the right audience and automate the process.

Dynamic Ads for Travel
Automatically promote your travel inventory on Facebook. Facebook’s dynamic ads for travel leverage cross-device intent signals to automatically promote relevant travel options from your inventory with unique creatives on Facebook.