Track app installs and in-app activity, and measure ad performance for your Facebook and Instagram campaigns.
What is Facebook Analytics?
Facebook (Meta) Analytics lets you track how users interact with your app and measure the performance of your Facebook and Instagram ad campaigns. It logs standard events automatically (app installs, sessions, purchases) and lets you send custom events to understand deeper engagement.
Prerequisites
This feature requires the Unlimited or Lifetime plan. See all plans
A Facebook Developer account.
iOS:
Your iOS app is already published in the Natively Dashboard.
Facebook Configuration
Create your Facebook app
Go to My Apps in Meta for Developers and click Create App.
Select None as the app type.
Enter your app name and contact email.
Configure your platform(s)
In your app, go to Settings > Basic.
Scroll down and click Add platform.
Select Android or iOS, and click Next.
Natively supports Google Play. Other Android app stores may work but are unsupported.
In Add platform, select Google Play from the list of stores.
Generate your Key Hash:
Go to your Google Play Console, open your app's page, and navigate to Protected With Play > Play Store protection > Protect app signing key > Manage Play App Signing.
Copy the SHA-1 certificate fingerprint under Upload key certificate.
Go to a Hex to Base64 converter.
Paste your SHA-1 value and click Convert Hex to Base64.
Copy the resulting Base64 value.
Repeat for the App signing key certificate SHA-1 fingerprint.
Paste both Base64 values into the Key hashes field.
Enter your Package Name - found in the Natively Dashboard under Publish > Android Build > Bundle Identifier.
Enter your Class Name:
{YOUR_ANDROID_APP_BUNDLE_ID}.MainActivity- e.g.com.example.natively.MainActivityClick Save changes.
Go to Settings > Advanced, and copy your Client Token and App ID.
The App ID and Client Token are the same for iOS and Android - if you support both platforms, you only need to enter them once, but you must rebuild each app separately.
Enter your Bundle ID - found in the Natively Dashboard under Publish > iOS Build > Bundle Identifier.
Enter your iPhone/iPad Store ID - found in the Natively Dashboard under Publish > iOS Build > App Store App ID. This value is the same for iPhone and iPad (if iPad Support is enabled).
Click Save changes.
Go to Settings > Advanced, and copy your Client Token and App ID.
The App ID and Client Token are the same for iOS and Android - if you support both platforms, you only need to enter them once, but you must rebuild each app separately.
Natively Dashboard Setup
Open your Natively app dashboard and navigate to Features > Analytics > Facebook.
Toggle the feature to Enabled.
Enter the App ID and Client Token you copied from Facebook.
(iOS only) Enter the Permission Description.
Click Save.
Rebuild your app(s).
The Permission Description is the text shown to iOS users when the OS asks them to grant tracking permission (App Tracking Transparency). This field only applies to iOS. Explain clearly why your app needs this permission - for example: "We use your data to provide personalized advertisements that are relevant to your interests".
You must rebuild your app for these changes to take effect.
Implementation
Natively doesn't expose a dedicated Facebook-specific method - standard events (app installs, sessions, and purchases) are logged automatically once configured, with no additional call required.
For any event beyond the automatic ones - such as registration_completed or viewed_product - send it yourself using Custom Event. These events cannot be configured entirely within the Facebook Events Manager; the dashboard can map, report, and optimize on events, but your app must actually send each event at the moment the action happens.
How to use
Facebook's Events Manager data isn't real-time. Standard events typically appear within seconds to minutes, but delivery timing can vary - Facebook's own documentation notes it can take up to 30 minutes in some cases. Don't assume a missing event is broken until you've allowed for this delay.
Standard events are logged automatically; no setup needed
Once configured, app installs, sessions, and in-app purchases are tracked without any additional call.
Use Custom Event for everything beyond standard events
For engagement, feature usage, or funnel tracking, use Custom Event - it's forwarded to Facebook automatically once configured.
Stick to Facebook's event name limit
Facebook allows up to 1,000 distinct event names per app - reuse a small, consistent set of event names rather than generating dynamic ones per event.
Verify your integration before launching campaigns
Use Facebook's Test Events tool (see Testing on the Custom Event page) to confirm events are actually reaching Facebook before you spend budget attributing campaigns to it.
Troubleshooting
Standard events aren't showing up on Facebook
Go through this checklist:
Confirm the feature is enabled and both the App ID and Client Token are entered correctly in the Natively Dashboard.
Confirm the app has been rebuilt.
Confirm you've allowed enough time for data to propagate.
iOS setup fails, or the app isn't recognized
Confirm your Bundle ID and iPhone/iPad Store ID exactly match what's configured in the Natively Dashboard.
Last updated