To build the best possible experience for your players, it is important to track how they are interacting with your app and how this changes over time. To make informed decisions and design new features in your game it is important to test, measure, and learn from effective instrumentation. In this guide we will cover important tools you can use to measure your game like App Events and referral tracking.
In order to measure X you will need to be logging events with an instrumentation solution. One such solution is App Events, which unlocks some powerful marketing automation.
Adding support for App Events is simple when using the Facebook SDK for your platform, or if you are server inclined you can use our App Events API. Integration is lightweight and in the simplest case, each event only takes adding a single line of code. These events can be one of several predefined events or a custom event you define for your app.
In addition to common events shared across most genres of apps, there are 3 predefined events for games:
Event Name | Event Description | Parameter |
---|---|---|
Level Achieved | The player has achieved a level in the app. |
|
Tutorial Completed | The player has completed a tutorial in the app. |
|
Achievement Unlocked | The player has unlocked an achievement in the app. |
|
To get started visit the Facebook App Events documentation and follow the directions for your relevant platform. Find best practices and vertical-specific examples on the App Events Best Practices Guide.
For games on Facebook.com, players can reach your game through a number of surfaces. It can be helpful to measure these traffic sources through the use of referral parameters. When a player navigates to your game from a location on Facebook.com, like bookmarks, Feed, or a person's Profile, a query string parameter fb_source
will be appended to the URL. You can use this parameter to measure incoming traffic to your game.
This list refers to the set of fb_source
parameters returned when a user clicks on the bookmarks or recommendations while playing a game on Facebook.com (i.e. from apps.facebook.com/*).
Name | Description |
---|---|
| When your app is visited from a bookmark shown while playing a game on Facebook (i.e. from https://apps.facebook.com/*). |
| When a user is brought to your app via the recommendations section. |
| When a user is brought to your app via the Games You May Like recommendations section. |
This list refers to the set of fb_source
parameters returned when a user clicks on the bookmarks on the Facebook sidebar. The sidebar is shown to a selection of targeted, active app users and appears on the right hand side of every page, if the user's screen size is wide enough to support it. This unit, if enabled for the viewing user, appears above the chat and ticker sections of their sidebar.
Name | Description |
---|---|
| When your app is visited from a bookmark located on the sidebar. |
| When a user is brought to your app via the recommendations section of the sidebar. |
This list refers to the set of fb_source
parameters returned when a user clicks on the bookmarks on the user's homepage.
Name | Description |
---|---|
| When your app is visited from a bookmark on the user's homepage under the Apps section. |
| When your app is visited from a bookmark on the user's homepage under the Favorites section. |
This list refers to the set of fb_source
parameters returned when a user clicks on the links on the right side column of the user's homepage.
Name | Description |
---|---|
| When your app is visited from a reminder on the user's homepage. At the top of the right hand column on the Feed, where reminders for commonly played games are surfaced. These appear near birthday reminders, pokes, and other notifications. |
| When a user is brought to your app via the recommendations on the right side column of the user's homepage. |
There is a search bar is present on many pages within Facebook. If a user reached your app from the Facebook search bar, we will add the search fb_source parameter.
Name | Description |
---|---|
| When your app is visited from the Facebook search bar. |
There are a variety of ways a user can be sent a notification about your app, see [Game Requests] and [App Notifications]. If a user reached your app from the Facebook notification tray, we will add the notification fb_source parameter.
Name | Description |
---|---|
| When your app is visited from the Facebook notifications tray. |
This list refers to the set of fb_source
parameters returned when a user installs apps from the App Center.
Name | Description |
---|---|
| When a user installs an app from the App Center homepage, category pages or an App Detail page. |
| When a user clicks on an invite or request from within App Center. |
Feed stories are surfaced in many places around the site. If a user reached your app through one of these stories, we will add the feed
fb_source parameter.
Name | Description |
---|---|
| When your app is visited from a Feed story within Facebook. |
Facebook users can choose to show what Apps and Games they use on their Facebook profiles. If a user reached your app from the timeline of a Facebook user, we will add on the timeline fb_source parameter.
Name | Description |
---|---|
| When your app is visited from the timeline of a Facebook user. |
While fb_source
defines broad referral categories, you may look into fbs
parameters that refer to specific UI elements.
fbs | Description |
---|---|
| APPCENTER |
| APPCENTER_CURATED |
| APPCENTER_EXTERNAL |
| APPCENTER_FRIENDSUSING |
| APPCENTER_MOBILE |
| APPCENTER_MYAPPS |
| APPCENTER_RELATEDAPPS |
| APPCENTER_REQUEST |
| APPCENTER_SEARCH |
| APPCENTER_SEARCH_TYPEAHEAD |
| APPCENTER_SUGGESTION |
| APPCENTER_TOPLIST |
| APPCENTER_SALES |
| APPCENTER_GETTING_STARTED |
| APPCENTER_USAGE |
| APPCENTER_DETAIL_PAGE_CTA |
| APPCENTER_HERO_FEATURED |
| APPCENTER_HOMEPAGE_CAROUSEL |
| APPCENTER_CONTEXT_MENU |
| APPCENTER_APP_PAGE_CAROUSEL |
| APPCENTER_BROWSE_GRID |
| APPCENTER_MOST_POPULAR_LIST |
| APPCENTER_POPULAR_AMONG_FRIENDS |
| APPCENTER_TOP_GROSSING |
| APPCENTER_DIRECT_NAV |
| APPCENTER_BROWSE_GRID_FEATURED |
| APPCENTER_HERO |
| APPCENTER_HOMEPAGE_CAROUSEL_FEATURED |
| APPCENTER_HOMEPAGE_TOP_LIST |
| APPCENTER_HOMEPAGE_TOP_LIST_FEATURED |
| APPCENTER_APP_PAGE_HEADER |
| APPCENTER_APP_POPOVER_HEADER |
| APPCENTER_CONTEXT_MENU_FEATURED |
| APPCENTER_APP_PAGE_CAROUSEL_FEATURED |
| APPCENTER_SALE_BANNER |
| APPCENTER_HOMEPAGE_BOOKMARK |
| APPCENTER_DESKTOP_APP_LINK |
fbs | Description |
---|---|
| CANVAS_BOOKMARK |
| CANVAS_BOOKMARK_FEATURED |
| CANVAS_RECS |
| CANVAS_RECS_FEATURED |
| CANVAS_GAMEBAR |
| CANVAS_GAMEBAR_CAROUSEL |
| CANVAS_GAMEBAR_CAROUSEL_FEATURED |
| CANVAS_GAMEBAR_SLIDER |
| CANVAS_GAMEBAR_SLIDER_FEATURED |
| CANVAS_GAMEBAR_BOOKMARKS |
| CANVAS_PA_SLIDER |
| CANVAS_TRENDING |
| CANVAS_LIVE_PLAYERS |
| CANVAS_TOP_LISTS |
| CANVAS_GAME_SUGGESTIONS |
| CANVAS_BOOKMARKS_LIST |
| CANVAS_DESKTOP_SEARCH |
| CANVAS_BLUEBAR_BOOKMARKS |
| CANVAS_JEWEL |
| CANVAS_RHC_DESKTOP_APP_DOWNLOAD_UNIT |
| CANVAS_DESKTOP_DOWNLOAD_LEARN_MORE |
| CANVAS_SPOTLIGHT |
| CANVAS_SPOTLIGHT_FEATURED |
| CANVAS_RHC_DESKTOP_APP_PLAY_ON_APP_DOWNLOAD_UNIT |
| CANVAS_BANNER_DESKTOP_APP_DOWNLOAD_UNIT |
fbs | Description |
---|---|
| BOOKMARK |
| BOOKMARK_APPS |
| BOOKMARK_DEVELOPER |
| BOOKMARK_FAVORITES |
| BOOKMARK_FEATURED |
| BOOKMARK_SEEALL |
| BOOKMARK_RIGHTCOL |
| BOOKMARK_ARCADE |