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 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.

See Also

To learn more about the concepts, endpoints, and permissions mentioned in this document, please visit the following guides:

• Facebook Login for Gaming
• Instant Games
• Permissions Reference