Debugging App Events

This topic gives you some tips to ensure that you are logging your events effectively to ensure that Facebook Analytics processes your events.

Debugging Events

You have the following ways to debug events in your app or web page:

  • Events Manager - use for debugging the events that you send from your app or web page. This is the fastest way to see events from your app.
  • Event Debugging - use for debugging any event sent by your app or web page. can look at the events you send through your app by using the Events Manager or you can look at the events sent by all of your users by using Event Debugging in the Dashboard.

Events Manager

Use the Events Manager to see only the events that you send. The Events Manager is especially useful if several users have installed your app and you only want to see the events you send.

To open the Events Manager, go to https://www.facebook.com/events_manager and choose your app.

Event Debugging

Use Event Debugging to see all of the events sent by your app. You can filter the app events by choosing a filter in Include:

  • Just My Event which is under All Events - shows the app events sent from your device after you log into the Facebook mobile app on your device or simulator. Alternatively, you can use Facebook Login to log into your app on that device.
  • Events from ID - shows the app events from the device with the ID that you entered in the box. For iOS devices, enter the Identifier for Advertising (IDFA). For Android devices, enter the Google Play Services Advertising ID.
  • All Device OSes - you can filter the page to show only the app events sent by a chosen operating system.
  • All App Versions - you can filter the page to show only the app events sent by a specific app version.

To open Event Debugging, open the Dashboard for your app and choose Activity then Event Debugging.

Keep in Mind:

  • The client SDK may batch events for up to 15 seconds unless you explicitly flush them. Generally, events should show up a few seconds after being sent, so expect about 30 seconds between an event happening and it showing up in Event Debugging.
  • Event Debugging only shows data that's sent after the page is opened. It does not show event history and only collects events while the page is open.

Missing Events

If you do not see new app events in the dashboard, try the following:

  • Install the latest version of the Facebook SDK.
  • Check your app event function for the correct syntax. You can use the App Event Builder to generate your app event code.
  • Check that the function implementing the app event executes correctly.
  • Check that the names of app events and parameters are between 2 and 40 characters and must consist of alphanumeric characters, underscores (_), or spaces. The parameter value must be less than 100 characters.

Android

  • Use the correct strings.xml or AndroidManifest.xml files.
  • Use the correct Development and Release key hashes.
  • Use the correct import statements.

iOS Swift

  • Use the correct AppDelegate.swift file * Use the correct information property list file.
  • Check that your code for the correct import statements.
  • Check that the AppEventsLogger.activate(application) statement is in the applicationDidBecomeActive function

Web

  • Check that you set the fbAsyncInit property and then call a function.

Collecting the Right Data

If you have confirmed that your app is sending data to Facebook Analytics but the events in the dashboard are not displaying the right data, you can check the following:

  • Check the syntax of your app event to ensure you are using the correct event name and are sending the correct Value to Sum and parameter values. You can use the App Event Builder to generate the code for your app event.
  • Check that your app event is passing the correct parameter values.

Remove unused events or events that record deprecated features to make the log easier to review.