App Events FAQ

Limits

An app can create up to 1,000 unique event names. If you exceed this limit you may see an 100 Invalid parameter error when logging.

If you need to remove obsolete events - you can deactivate events by following the instructions in our help center.

One typical reason we see developers go over event limits is because they don't take advantage of parameters and instead log individual events when they should be utilizing parameters. For instance, instead of logging a separate event for each time someone completes a level (e.g. Level Achieved 1, Level Achieved 2, etc), a developer should log a single event Achieved Level with a parameter of level for the level number.

An event can have up to 25 parameters. This doesn't just mean for each call, but for all invocations that use that event name.

If you need to remove obsolete parameters - you can deactivate parameters by following the instructions in our help center.

Event names and parameter names must be between 2 and 40 characters, and must consist of alphanumeric characters, _, -, or spaces.

The length of each parameter value can be no more than 100 characters.

Implementation

App Events provides SDKs for the following channels: iOS, Android, Games on Facebook, and Unity. Additionally, App Events supports passing events server to server through the Graph API.

App Events does not require Facebook Login, or any other Channel features, to be implemented.

You can define any event that you would like to capture and you will be able to see that event in your Facebook Analytics dashboard. We support logging up to 1,000 distinct event names and no limit on event volume. However, in Ads Reporting, we will only show the fourteen pre-defined App Events and any additional App Events will be logged as “Other Mobile App Actions“. For this reason, we recommend using one of the fourteen pre-defined App Events.

The 14 pre-defined events are:

  • Achieved Level: You can log this event when a person completes a level in a game or a similar task within the app.
  • Added Payment Info: You can log this event when a person adds payment information (such as a credit card, shipping address and so on) within the app.
  • Added to Cart: You can log this event when a person adds an item (such as a product or service) to a shopping cart within the app.
  • Added to Wishlist: You can log this event when a person adds an item (such as a product or service) to a wishlist within the app.
  • App Launched: You can log this event when a person starts using the app on their device.
  • Completed Registration: You can log this event when a person completes the account registration process within the app.
  • Completed Tutorial: You can log this event when a person finishes a training or educational experience within the app.
  • Initiated Checkout: You can log this event when a person begins the checkout process to purchase items (such as products or services) within the app.
  • Purchased: You can log this event when a person buys an item (such as a product or service) within the app.
  • Rated: You can log this event when a person rates or reviews something (such as a product, location and so on) within the app.
  • Searched: You can log this event when a person conducts a search within the app.
  • Spent Credits: You can log this event when a person uses credits to purchase an item (such as a product or service) within the app.
  • Unlocked Achievement: You can log this event when a person reaches a particular goal in a game or makes a similar accomplishment within the app.
  • Viewed Content: You can log this event when a person views content within the app.

All events will show up in Facebook Analytics. However, custom events which are not one of the fourteen pre-defined events will show up as “Other Mobile App Actions“ in Ads Reporting. In order to see your event broken out in Ads Reporting, you need to use one of the predefined events.

For Unity games, you can use the Unity SDK to log App Events. For other channels utilizing web-view within a native app, one option would be to utilize the App Events API to pass events from your server to the Facebook servers.

Typically, developers find it easier to use the Facebook SDK to integrate App Events. The Facebook SDK helps reduce the amount of coding that is required and provides helpful metadata about your app such as the app version and app name. Using the SDK automatically provides, with minimal development effort, metrics such as time spent, number of sessions, and interruptions. The SDK also is able to collect the Android Advertiser ID or IDFA (if you are using App Events in connection with ad attribution) and handles Limit Ad Tracking for you. However, the limitation of the SDK is that you need to ship a new version of your app if you decide to add additional events. For most developers, the SDK option works best.

The API solution may be a better fit for developers who do not want to have to ship an updated version of their app to integrate App Events or add additional App Events. For developers who have hybrid web apps, integrating with the API may be easier as well. However, the API solution requires you to handle Limit Ad Tracking as well as IDFA and Android Advertiser ID collection on your own. Also, it does not provide the app usage metrics that are collected by the SDK automatically. For developers who wish to track additional metrics such as app version, app name, time spent, number of sessions, and interruptions, they will need to determine those metrics on their own and pass those metrics back as custom parameters through the API.

If you are currently using an MMP to track installs or other actions in your app, you can request that your MMP passes those events server to server to Facebook.

You can use both an MMP SDK and Facebook SDK in your app but you need to make sure that you don't pass the same event twice for both because this could result in double counting.

Prior to launching to the App Store, we recommend loading a test version of your app with updated code on a test device. Go through the most common flows in your app to trigger specific events that you want to test. Those events will now show up in Facebook Analytics. You can filter on the “most recently logged events” filter. To see more details on how to do this: go to the App Events documentation for your specific platform.

You can filter by App Version and event name within the [Most Recent](/docs/analytics/overview

Facebook handles your data in accordance with our Data Policy. This information can be used to improve our ads targeting and delivery capabilities, as well as improve other experiences on Facebook, including News Feed and Search content ranking capabilities.

  • Forget to pass currency or value for a purchase or purchase related event
  • Place the decimal in the wrong place
  • Use a comma instead of a decimal for a numeric value
  • Hardcoding conversion values by guessing the “average” order value as opposed to passing the actual value

To filter your charts to show only Messenger bot data, first create a new segment in the Overview, Activity or People sections of Facebook Analytics. When you've opened the segment options:

  1. Click Select Condition and select Device Info
  2. Click Select Parameters and select Channel
  3. Click Enter a value and select Messenger bot
  4. Click Save to continue and save the segment, or Apply to continue without saving
Was this information helpful?

Ads Questions

Ads Reporting supports fourteen pre-defined App Events. If you are logging an event that does not fall into one of the pre-defined events, it will show up in Ads Reporting under “Other Mobile App Actions“.

Yes, you can build Custom Audiences using App Events. You can find the instructions for how to do so here.

Yes, we deliver your ads to people who are most likely to take specific action at least once at the lowest cost. Create a mobile app install ad set that optimizes for a specific app event via the API. This is similar to a regular mobile app install or mobile app engagement ad set except:

  • optimization_goal: Set to OFFSITE_CONVERSIONS
  • billing_event: Set to IMPRESSIONS
  • promoted_object: Set custom_event_type to the app event you want to optimize.
  • For mobile app engagement ads, optimize for standard App Events, except App Launch. These options available in Power Editor and the API. See Ads Help Center, Optimizing for App Events and Marketing API, Ad Set.

    Automatic In-App Purchase Logging for iOS

    First, ensure that you have v3.22 (or higher) of the Facebook iOS SDK installed within your app. Second, ensure that you are calling the ActivateApp method.

    1. Go to My Apps.
    2. Select your app.
    3. Click on the settings tab on the left nav.
    4. Find the section labeled iOS.
    5. Enable the switch called "Automatically Log In-App Purchase Events on iOS".

    By enabling the switch for in-app purchase logging, the following App Events will be tracked: Initiate Checkout, Purchase, and Purchase Cancellation.

    Automatic logging reduces the amount of time needed to accurately log App Events. Instead of having to manually collect the events and determine what parameters to pass, all of that work is handled for you. For instance the following parameters are automatically logged: Product ID, quantity, total amount, currency, product title and product description. Also, if you are using version 3.22 or higher, you can automatically enable this without having to submit an updated client to the App Store.

    If you are currently logging in-app purchases there is no need to enable this feature. However, you would like to adopt this functionality, you will want to stop explicitly logging in-app purchases events otherwise you may see duplicate counts in your reporting.

    We recommend logging all events that are relevant to your app. You can use this best practices guide as a starting point to determine what events would be relevant for your business.