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

The Event Debugging in the Dashboard shows the most recent app events your app sends to Facebook Analytics. In the Dashboard, choose Activity then Event Debugging.

By default, Event Debugging shows you the app 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.

A few things to 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.

Sending Data to Facebook Analytics

When your app runs and you have integrated the Facebook SDK into your app, the Dashboard should display an App Install or an App Launch app event. If your Dashboard does not display any events when you app runs, check that your app is connected to Facebook Analytics. Test the connection by creating a test app using the appropriate Quickstart for your platform.

The Quickstarts contain the minimum amount of code to send the App Install pre-defined app event to Facebook Analytics. If you do not get any events from an app created from the Quickstart procedure, then your network is not connected to the internet. Connect to the internet and then try starting your app and see if the App Install event appears in the dashboard.

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.

Analyzing the data

If the data still doesn't make sense to you, try the following:

  • Check the dates that you use to run your reports.
  • Define your events, parameters, and meta data before implementing an app event to ensure that you are collecting the right data.

App Event Builder

The App Event Builder generates the code for your pre-defined or custom event.

To Generate Code for a Pre-defined Event

  1. Choose the Pre-Defined Event tab.
  2. In Event Name, choose a pre-defined event.
  3. Choose Get Code.
  4. In the window, select a language to see the code to copy and paste into your app.

To Generate Code for a Custom Event

  1. Choose the Custom Event tab.
  2. In Event Name, enter the name of you custom event.
  3. In Use Value to Sum?, choose On if you will have this value.
  4. For each parameter in your custom event, choose Add Event Parameter, enter the name of the parameter, and then choose a data type.
  5. Choose Get Code.
  6. In the window, select a language to see the code to copy and paste into your app.