Cas d’utilisation de Facebook Login pour les jeux vidéo

Ce document explique comment créer et personnaliser une application avec le cas d’utilisation Facebook Login pour les jeux vidéo dans l’Espace App.

Avant de commencer

Vous aurez besoin des éléments suivants :

Étape 1 : lancer le processus de création de l’application

Vous pouvez créer une application de plusieurs manières.

Si vous venez de terminer le processus d’inscription, cliquez sur le bouton Créer une première application
Si vous vous trouvez dans l’Espace App , cliquez sur Créer une application en haut à droite
Si vous vous trouvez dans le tableau de bord d’une application existante et que vous voulez créer une nouvelle application, sélectionnez le menu déroulant en haut à gauche, puis cliquez sur le bouton Créer une nouvelle application

Étape 2 : sélectionner le cas d’utilisation

Sélectionnez le cas d’utilisation Authenticate and request data from users with Facebook Login (Authentifiez les utilisateur·ices et demandez-leur des données avec Facebook Login).

Cliquez sur le chevron à droite de la description pour connaître les possibilités offertes par le cas d’utilisation et les exigences correspondantes.

Cliquez sur le bouton Suivant.

Vous pourrez personnaliser le cas d’utilisation ultérieurement dans l’Espace App.

Étape 3. Type de connexion

Vous serez invité·e à indiquer si vous créez un jeu. Sélectionnez Oui et cliquez sur Suivant.

Étape 4 : ajouter les détails de l’application

Au cours de cette étape, vous allez ajouter :

le nom de l’application
l’adresse e-mail à utiliser pour vous contacter au sujet de l’application concernée

Vous pouvez éventuellement associer l’application à un compte business existant à l’aide du menu déroulant. Vous pouvez aussi effectuer cet ajout ultérieurement.

Cliquez sur Créer une application pour enregistrer les détails de l’application.

Étape 5. Personnaliser l’application

Dans la section Installez la connexion aux jeux vidéo et demandez des données utilisateur, vous constatez que Facebook Login pour les jeux vidéo et les autorisations gaming_profile et gaming_user_picture ont automatiquement été ajoutées à votre application. Votre application peut ainsi utiliser Facebook Login et demander à ses utilisateur·ices l’autorisation d’accéder aux informations de leur profil de jeux et à leur photo de profil.

Cliquez sur le bouton Personnaliser.

Personnalisation de Facebook Login et demande des données utilisateur·ice

Paramètres

Facebook Login pour les jeux vidéo vous permet de contrôler les paramètres OAuth, et d’ajouter une URL de rappel d’annulation d’autorisation et un validateur d’URI de redirection.

Démarrage rapide

Grâce à la fonctionnalité de démarrage rapide de Facebook Login pour les jeux vidéo, vous recevez rapidement le code vous permettant d’implémenter Facebook Login pour les jeux vidéo dans votre application.

Autorisations

La liste des autorisations disponibles dans le cas d’utilisation Facebook Login pour les jeux vidéo s’affiche, avec une description complète et les exigences correspondant à chacune.

gaming_profile : ajoutée automatiquement et ne peut être supprimée
gaming_user_picture : ajoutée automatiquement et ne peut être supprimée

Une fois qu’une autorisation est ajoutée à l’application, vous pouvez en voir le statut :

Prête pour le mode Live : l’autorisation a été approuvée par un Contrôle app. Vous pouvez publier l’application et effectuer les tests d’autorisation exigés pour le Contrôle app
Prête pour le test : vous pouvez réaliser un test en effectuant des appels d’API sur des points de terminaison qui requièrent l’autorisation
Vérification requise : cette autorisation nécessite l’ajout d’un compte business Meta vérifié à l’application

Vous pouvez également connaître le nombre d’appels d’API qui ont été effectués sur des points de terminaison requérant les différentes autorisations et qui ont abouti.

Étape 6. Ajouter d’autres cas d’utilisation

Cliquez sur le bouton Retour en haut à droite ou sur Cas d’utilisation dans le menu de gauche pour ajouter d’autres cas d’utilisation à l’application.

Voici les cas d’utilisation les plus couramment utilisés avec le cas d’utilisation que vous avez choisi lors de la création de cette application. Vous devrez personnaliser la plupart des cas d’utilisation répertoriés dans l’Espace App, puis implémenter le code en suivant les instructions de la documentation développeur·se pour pouvoir les utiliser.

Nous vous recommandons de terminer chaque cas d’utilisation avant d’en ajouter d’autres. Vous pourrez ainsi visualiser les fonctionnalités apportées par chaque cas d’utilisation et vous limiter aux cas d’utilisation nécessaires.

Cas d’utilisation	Autorisations et produits nécessaires
Aidez les joueurs à trouver des amis, afin qu’ils puissent jouer ensemble : augmentez la popularité de votre jeu en aidant les joueurs et joueuses à inviter leurs ami·es pour jouer ensemble.	`user_friends`
Partager votre gameplay sur Facebook et Instagram : autorisez les joueurs et joueuses à prendre des captures d’écran et des vidéo-clips de leur gameplay sur Instagram et Facebook, y compris dans leurs Stories et groupes Facebook.	Partage dans les jeux
Suivez les interactions avec les évènements d’application : les évènements d’application Meta permettent à votre application de comprendre comment les internautes interagissent avec votre entreprise selon les applications, les appareils, les plateformes et les sites Web.	Évènements d’application Meta
Recevez des notifications en temps réel avec Webhooks : recevez automatiquement des notifications HTML quand des utilisateur·ices de l’application modifient les autorisations accordées à votre application.	Webhooks Meta

Étapes suivantes

Après avoir personnalisé vos nouveaux cas d’utilisation, vous pouvez tester votre implémentation, ajouter des applications tests, des Pages et des utilisateur·ices, et bien plus encore.