Meta App Events

The Meta App Events plugin embeds the native iOS and Android Meta (Facebook) SDKs directly into your Median-wrapped app. This gives you access to Facebook App Events — Meta's analytics and ad measurement system — without relying on the web-based Facebook Pixel. You can capture standard events like App Install and App Launch automatically, and send fully custom events from your web content using the JavaScript Bridge. Because the events flow through the native SDKs, you get more reliable data collection and a broader set of measurable actions than the Pixel alone can provide.

Why use Meta App Events?

• Auto events: Enable auto logging for standard events such as App Install and App Launch.
• Custom events: Send custom events (e.g. level achieved, purchases) via the JavaScript Bridge.
• Native SDKs: iOS and Android Meta SDKs integrated by Median App Studio when enabled and configured.
• Ad performance: Measure Meta Ad performance and build audiences for Meta Ad targeting using the Facebook SDK.

Prerequisites

• A Median.co app with JavaScript Bridge enabled
• A Facebook Application created in the Facebook Developer Account (for Android, add your app's release key hash from Median App Studio under Facebook App Events)
• Facebook Application ID and Facebook Display Name from your Facebook Developer Account

When to use this plugin

Meta App Events is essential for apps that need to:

What you'll do

Use this section as a fast navigation map into the full setup and implementation details:

1. Create your Facebook Application: Go to Plugin Setup and complete Enable the Plugin with your Facebook Application ID and Display Name.
2. Configure your settings: Review Configuration Options to set up auto logging and any additional preferences.
3. Implement event tracking: Use the methods in JavaScript Bridge Functions to enable auto logging and send custom or purchase events.
4. Validate your integration: Use Code Examples to confirm your implementation pattern.
5. Verify and debug: Check Troubleshooting if events aren't appearing in your Meta dashboard.

Plugin Setup

Enable the plugin

1. Create a Facebook Application within your Facebook Developer Account. For Android, add your app's release key hash (found in Median App Studio under Facebook App Events).
2. Configure in Median App Studio: Add your Facebook Application ID and Facebook Display Name from your Facebook Developer Account to your Median app's configuration.

The published Median doc page does not ship static screenshot assets in its HTML export; follow the steps above in the Facebook Developer console and in Native Plugins → Facebook App Events in App Studio.

Configuration Options

JavaScript Bridge Functions

Auto Events

Enable or disable auto logging for standard events (e.g. App Install, App Launch).

↔️Median JavaScript Bridge

median.facebook.setAutoLogging(true | false);

Parameters:

Custom events

Regular events

Send a custom event to Facebook. Create a JavaScript object with:

• event (required): String that identifies the event type.
• valueToSum (optional): A number to sum up.
• parameters (optional): Object of additional parameters.

↔️Median JavaScript Bridge

var data = {
  event: 'fb_mobile_level_achieved',
  parameters: { 'fb_level': '1' }
};
median.facebook.events.send(data);

Parameters:

Event name and parameter key constants can be found in the Facebook SDK source (Android: AppEventsConstants.kt; iOS: FBSDKAppEvents.m).

Purchase Events

Send a purchase event. Facebook's SDK sends purchase events more immediately than regular events.

↔️Median JavaScript Bridge

var data = {
  purchaseAmount: 2.56,
  currency: 'USD'
};
median.facebook.events.sendPurchase(data);

Parameters:

Testing Checklist

Use this checklist to verify Meta App Events is working correctly before going to production:

Troubleshooting

var data = {
  purchaseAmount: 2.56,  // number, not "2.56"
  currency: 'USD'        // ISO 4217 currency code
};
median.facebook.events.sendPurchase(data);

📘

Still having trouble?

For Meta SDK and App Events behavior outside Median’s bridge, refer to Meta App Events documentation.