Get Started – Web

This guide shows you how to add App Events to your new or existing app by integrating the Facebook SDK then logging these events.

Before You Start

You will need:

• A Facebook Developer Account
• A Facebook Ad Account

Step 1: Configure Your Facebook App

Go to the App Dashboard, click My Apps, and create a new app if you don't already have one. Navigate to Settings > Basic to view the App Details Panel with your App ID, your App Secret, and other details about your app.

Set up your app for advertising by adding the following details:

• App Domains - Provide Google Play Store URL of your app.
• Privacy Policy URL - Provide a Privacy Policy URL. Required to take your app public.
• Terms of Service URL - Provide a Terms of Service URL.
• Platform - Scroll to the bottom of the Settings panel to add the Web Platform. Add the follow details of your app:

  • Google Play Package Name
  • Class Name
  • Development and Release Key Hashes

Save your changes.

To learn more about adding details to your app, such as an icon or category, visit the App Development docs.

Step 2: Link your Ad Account with your App

To run ads and measure installs in the Ads Manager, you need to associate at least one Ad Account with your app.

1. In the app dashboard click Settings > Advanced.
2. In Authorized Add Account IDs, add your Ad Account IDs. You can get your ad account IDs from your Ads Manager.

Step 3: Integrate the Facebook SDK in Your Website

We provide two ways to integrate the Facebook into your web page, using a Quickstart or adding the SDK manually.

Add the SDK by Using the Quickstart

By using the Quickstart Guide from your App Dashboard to add the Facebook SDK to your Website, the code provided will already include your App ID.

Add the SDK Manually

To add the SDK manually copy and paste the following code but be sure to replace {your-app-id} with your App ID and {version} with the Graph API version your app is using.

<script>
  window.fbAsyncInit = function() {
    FB.init({
      appId      : '{your-app-id}',
      xfbml      : true,
      version    : '{version}'
    });
    FB.AppEvents.logPageView();
  };
</script>

<script async defer 
  src="https://connect.facebook.net/en_US/sdk.js"></script>
</script>

Step 4: Add App Events

There are three ways events are tracked in your app:

• Automatically Logged Events - App installs, launches, and in-app purchases are automatically logged with the Facebook SDK.
• The Codeless App Events tool - Use this tool to add Standard Events without adding code to your app.
• Manually Logged Events - Add code to your app to track Standard and Custom Events.

For websites, we recommend triggering the page view event on all pages to ensure accurate user accounts and session durations.

function onButtonClick() {
  // Add this to a button's onclick handler
  FB.AppEvents.logEvent("{my_app_event}");
}

5. Test Your Events

Use Facebook Events Manager

View the most recent events logged by your app or website using the Facebook Events Manager. Choose your app and go to Test Events. Enter your URL to test your events set up.

Use the App Ads Helper Tool

The App Ads Helper allows you to test the app events in your app to ensure that your app is sending events to Facebook.

1. Open the App Ads Helper.
2. In Select an App, choose your app and choose Submit.
3. Scroll down to the bottom and choose Test Events.
4. Start your app and send an event. The event should appear on the web page.

Learn More

For more information and helpful hints on App Events check out:

• Best Practices Guide – View a wide variety of sample apps and how each handles App Events.
• FAQ – Check out our Frequently Asked Questions
• Ads Manager – View information about your ads.
• Events Manager – View information about the events you are tracking.