Automatic App Event Logging

You can make changes directly in the app code or through the toggle for Automatic App Event Logging in your app event developer dashboard or Events Manager. Please note in the event of conflicting values between the AutoLogAppEventsEnabled flag and the toggle, we will honor the value in the Automatic App Event Logging toggle. In particular, when launching an app in Korea, please note that Automatic App Event Logging can be disabled.

When you use the versions of the Facebook SDK listed below, events related to user interaction with your app are collected automatically.

This applies to the following Facebook SDKs:

  • Facebook SDK for Android v4.27 (and higher)
  • Facebook SDK for iOS v4.19 (and higher)
  • Facebook SDK for Unity v7.11 (and higher)

For Android, call callbackManager.onActivityResult to pass the login results to the callbackManager. iOS does not require any code to collect events.

Automatically Logged Events

When using the Facebook SDK, certain events in your app are automatically logged and collected for Facebook Events Manager unless you disable automatic event logging. These events are relevant for all use cases - targeting, measurement and optimization.

There are three key events collected as part of the Automatic App Event Logging: App Install, App Launch, and Purchase. When automatic logging is enabled, advertisers are able to disable these events, as well as other Facebook internal events such as login impression events. However, if you have disabled automatic logging, but still want to log specific events, such as install or purchase events, manually implement logging for these events in your app.

EventDetails

App Install

The first time a new user activates an app or the first time an app starts on a particular device.

App Launch

When a person launches your app, the Facebook SDK is initialized and the event is logged. However, if a second app launch event occurs within 60 seconds of the first, the second app launch event is not logged.

In-App Purchase

When a purchase processed by the Apple App Store or Google Play has been completed. If you use other payments platforms, you will need to add purchase event code manually.

Facebook SDK Crash Report

(For Facebook Use Only.)

If your app crashed due to the Facebook SDK, a crash report is generated and sent to Facebook when your app is restarted. This report contains no user data and helps Facebook ensure the quality and stability of the SDK. To opt out of logging this event, disable automatically logged events.

Disabling Automatic App Event Logging

If you do not want the Facebook SDK to collect app events automatically, you can disable automatic logging. If you have disabled automatic logging but still want to log specific events for Facebook Analytics, you must manually implement logging for these events in your app.