App Events Best Practices Guide

App Events allow you to measure the performance of your app using Facebook Analytics for Apps, measure conversions associated with Facebook ads, and build audiences to acquire new users as well as re-engage your existing users.

How to Use This Guide

Prior to writing any code to integrate App Events, we recommend spending a little time to think about the key events that you want to log within your app and what parameters associated with those events you will want to collect. This document will serve as a starting point for developers and marketers to help determine what events and parameters should be logged with App Events.

  1. Learn about the differences between events and parameters
  2. Find the example app most similar to your app and use it as guide for determining what events and parameters to log but feel free to add additional custom events and parameters that make sense for your app
  3. Create a finalized list of events and parameters relevant to your app
  4. Integrate app events based on your list using the platform documentation below:
  5. Finally, don't forget to verify your events and parameters before you submit an update to the Google Play or iOS App Store using verification steps detailed in the above platform specific docs

Not a developer?:

Email Your Developer

Events Versus Parameters

A typical area of confusion for developers ecountering app events for the first time is the difference between events and parameters.

  • An event is an action that a person takes in your app like Achieved Level, Added to Cart, or Purchased
  • A parameter is a specific data point for an event like Level 3 or $3.72

For instance Achieved Level is an event and Level 3 and Score are two parameters that can be associated with that event.

The maximum number of different event names is 1,000. Note that events can’t be removed and no new event types will be logged once this cap is hit. Read more about event limits in the FAQ.

App Events Sample Apps by Category

We've created some recipes for different types of apps in order to make it easier for you to see how you can use App Events in your app.

It is important to note that these guides should be used as a starting point for your app and should be customized. Each of the example apps provides a screen by screen breakdown of the different events and parameters that can be collected. At the end of each section there is a table that lists the recommended events and parameters for each app. And, if required, you can create your own events and parameters.