Facebook Login for Gaming Use Case

This document shows you how to create and customize an app with the Facebook Login for Gaming use case on the App Dashboard.

Before you start

You need the following:

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 Authenticate and request data from users with Facebook Login 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.

You will be able to customize your use case later on the app Dashboard.

Step 3. Login type

You will be asked if you are building a game, select Yes and click Next.

Step 4. App details

In this step you will add:

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

Click Create App to save your app's details.

Step 5. Customize your app

In the Get gaming login and request user data section you will see that Facebook Login for Gaming and the gaming_profile and gaming_user_picture permissions have automatically been added to your app. This allows your app to use Facebook Login and ask your app users for permission to access their gaming profile information and profile picture.

Click the Customize button.

Customize Facebook Login and requesting user data

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 get the code to implement Facebook Login for Gaming into your app.

Permissions

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

gaming_profile – Automatically added and can not be removed
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 and is ready to publish and complete App Review permission testing requirements
Ready to testing – You can test API calls to endpoints that require this permission
Verification required – This permission requires a verified Meta Business Account added to the app

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

Step 6. Add more use cases

Click the Go back button in the upper right or Use cases in the left side menu to add more use cases to your app.

These are the use cases most commonly used with the use case you chose when you created this app. You will customize most of the use cases listed on the app Dashboard then implement code to use them by following the instructions in the developer documentation.

We recommend completing each use case before adding another one. This will allow you to view the functionality each use case provides so you don't add a use case that your app will not need.

Use case	Permissions to add and Products to implement
Help players find friends so they can play together – Get more players for your game by helping current players find their friends so they can play together.	`user_friends`
Share your gameplay on Facebook and Instagram – Players can share screenshots and video clips of their gameplay to Instagram and Facebook, including Stories and Facebook Groups	Sharing for Gaming
Track engagement with App Events – Meta App Events allows your app to understand how people engage with your business across apps, devices, platforms and websites.	Meta App Events
Get real-time notifications with Webhooks – Get automatic HTML notifications when app users make changes related to the permissions that you've added to your app.	Meta Webhooks

Next steps

Now that you have successfully customized your additional use cases, you can test your implementation, add test apps, Pages, and users, and more.