Launch a Game on Facebook Use Case

This document shows you how to create and customize an app with the Launch a Game on Facebook use case on the Apps Dashboard. Launch a game that players can find and play directly in their Feed or Messenger conversations, on both desktop and mobile devices. This use case uses Instant Games and Facebook Login for Gaming.

This guide assumes that you have read and implemented the requirements for creating an app with Meta.

Step 1: Start the app creation process

There are a number of ways to create an app.

If you just came from the registration flow, click the Create First App button
If you are on the App Dashboard , click Create App in the upper right
If you are on the dashboard for an existing app and want to create a new app, select the dropdown menu in the upper left, and click the Create New App button

Step 2: Select your use case

Select the Launch a game on Facebook use case.

You can click the chevron to the right of the description to view what else you can do with this use case and the requirements for this use case.

Click the Next button.

Step 3. App details

your app's name for your app
the email address to be used to contact you about this particular app

Optionally, you can link this app to an existing Business Account using the dropdown menu, or you can add this at a later date.

Click Create App to save your app's details.

Step 4. Customize this app

Under Launch a game on Facebook use case, you can see that the following have been added to your use case:

Facebook Login for Gaming
Instant Games
The gaming_profile permission
The gaming_user_picture permission

Click the Customize button to the right of Launch a game on Facebook to customize the following items for your use case:

Details – Add a tagline, description, images and icons, game preview videos, and more
Localize – Translate your game content in up to 104 languages
Web hosting – Upload your game client code directly to Facebook instead of hosting it on your own servers
Login settings – Add more permissions to ask users for access
Feedback – Get all feedback submitted from players within the last 90 days

Facebook Login for Gaming

Settings

Facebook Login for Gaming allows you to control oAuth settings, and add a deauthorization callback URL and redirect URI validator.

Quickstart

The Facebook Login for Gaming quickstart allows you to quickly implement Facebook Login for Gaming in your app.

Permissions

You will see a list of permissions that are available in the Instant Games use case with a full description and requirements for each.

email – Can be added if your app needs a person's email address
gaming_profile – Automatically added and can not be removed
gaming_user_locale – Can be added if your app needs a person's locale
gaming_user_picture – Automatically added and can not be removed

After you add a permission to your app, you can see the status for that permission:

Ready for live mode – This permission has been approved in App Review
Ready to Testing – You can test API calls to endpoints that require this permission
Verification Required – This permission has not yet been approved in App Review

You can also see the number of successful API calls you have made to endpoints that require each permission.

Next Steps

Now that you have successfully customized your Launch a game on Facebook use case, you can add additional use cases or update the settings for your app in the app Dashboard.