Ce document a été mis à jour.
La traduction en Français (France) n’est pas encore terminée.
Anglais mis à jour : 14 juin 2022
Français (France) mis à jour : 6 juil. 2021

Instant Games FAQ

Answers to questions about developing, managing, and monetizing Instant Games.

General Info

Connectez-vous à Facebook.com et cliquez sur le signet Jeux à gauche ou visitez https://www.facebook.com/games/instantgames.

Permalien

Developing a Game

Assurez-vous que votre app se trouve dans la catégorie Jeux. Le produit Jeux instantanés n’apparaît pas pour les apps qui n’appartiennent pas à cette catégorie.

Permalien

Nous n’imposons pas de limite stricte quant à la taille du jeu mais nous recommandons que la taille de téléchargement initial ne dépasse pas cinq secondes. Vous pouvez héberger des packs de jeux de 200 Mo maximum, mais vous devez uniquement télécharger les fichiers nécessaires lors du chargement initial. Pour en savoir plus, consultez notre section Meilleures pratiques.

Permalien

Plusieurs options s’offrent à vous pour vous aider à choisir l’emplacement dans lequel stocker vos informations :

  1. Recourir à un serveur backend tiers avec lequel votre jeu communique via XMLHttpRequest, fetch, WebSocket ou EventSource. Cette option implique plus de flexibilité, mais également des coûts d’hébergement proportionnels à l’audience de votre jeu.

  2. Utiliser nos solutions SDK, qui prennent instantanément en charge plusieurs fonctionnalités du serveur prêtes à l'emploi. Pour stocker des informations relatives au joueur, utilisez nos méthodes player.getDataASync et player.setDataAsync. Concernant les classements, consultez notre guide de l’API Leaderboard

  3. Les services tiers tels que PlayFab, qui proposent des plateformes backend en tant que surface intégralement multiplateforme et conçues pour prendre en charge LiveOps, les demandes de match et les analyses. Parcourez d’autres outils.

Permalien

The minimum system requirements for playing instant games are iOS 9.0 or Android 5.0.

Permalien

Signalez directement les problèmes sur la page Github Howler.js. Mettez « [IG] » dans le titre du problème pour que les développeurs puissent lui donner la priorité.

Permalien

Assurez-vous d’appeler window.innerWidth et window.innerHeight après avoir résolu FBInstant.startGameAsync().

Permalien

Vous pouvez utiliser (et modifier) des pistes de la banque de sons de Facebook dans vos jeux. Le contenu de la banque de sons peut uniquement être utilisé sur la plate-forme Facebook, pour que n’importe quelle version de votre jeu qui utilise du contenu de la banque de sons puisse être diffusée sur notre plate-forme uniquement.

Permalien

Adding features to a Game

Notre méthode FBInstant.context.shareAsync() contient un paramètre intent qui accepte des valeurs comme 'INVITE', 'SHARE', etc. À partir de la version 4.0, ce paramètre ne remplit aucune fonction particulière. Elle a été ajoutée afin de développer le SDK et proposera des changements destinés aux utilisateurs à l’avenir.

Permalien

Lorsque vous défiez un autre joueur dans le fil pour la première fois, il n’existe aucune méthode de SDK pour récupérer les informations concernant la personne défiée. Nous vous recommandons d’utiliser un nom de remplacement comme « adversaire » jusqu’à ce que le second joueur réponde à l’invitation. Une fois que l’autre joueur a accepté l’invitation à jouer, vous pouvez utiliser FBinstant.player pour remplir sa photo et son nom.

Permalien

Game Bots

La cause la plus courante lorsqu’un bot ne reçoit pas de webhooks est une mauvaise configuration de l’application. Consultez notre page Configuration de bot pour obtenir un guide complet sur la configuration du bot de votre jeu.

Accédez à votre tableau de bord Développeur pour vérifier les points suivants :

  1. Vous devez configurer une Page d’application dans la section Jeux instantanés.
  2. Vous devez être abonné(e) aux évènements messages et messaging_game_plays dans la section Messenger.
  3. La page App est configurée dans le panneau Pages abonnées dans la section Messenger.
  4. Votre page appartient à la catégorie Page d’application, et son nom contient celui de votre jeu.
Permalien

Vous recevez des messages d’erreur en réponse aux appels d’envoi de l’API Graph dans l’un des cas suivants :

- Vous essayez d’envoyer des messages et dépassez la limite de cinq messages par utilisateur sur une période de dix jours

- Vous essayez d’envoyer des messages à un utilisateur, alors que celui-ci a supprimé ou bloqué votre bot ou en a coupé le son

- Votre app est en mode développement et vous essayez d’envoyer des messages à des personnes qui n’ont pas le rôle d’administrateur ou de développeur dans l’app

Pour en savoir plus, consultez la documentation de l’API Send.

Permalien

Data Management

Les paramètres d’app Facebook offrent aux utilisateurs la possibilité de demander à votre app de supprimer les informations qu’elle a obtenues de Facebook à votre sujet.

Dans la réponse à la demande de l’utilisateur, vous devez confirmer la réception de la demande de suppression des données utilisateur à l’aide des moyens techniques proposés, et fournir un lien ainsi qu’un numéro de confirmation. Le lien et le numéro de confirmation doivent permettre à l’utilisateur d’accéder à une explication compréhensible de l’état de sa demande, ce qui inclut une justification légitime de tout refus de suppression (le terme « légitime » varie suivant les juridictions et notre interprétation, au cas par cas, de notre politique en ce qui concerne les motifs énoncés).

Pour analyser la demande et y répondre, vous devez mettre en œuvre un rappel de « demande de suppression de données ». Votre rappel doit utiliser le protocole HTTPS sécurisé et figurer dans le champ Data Deletion Request URL (URL de demande de suppression de données) de la page Jeux instantanés > Détails de votre application, dans l’espace app.

Permalien

Troubleshooting

Si vous suivez notre guide Démarrage rapide ou Tester, publier, partager, vous devez connaître notre concept par rapport au lecteur intégré. Il s’agit d’une façon de tester votre Jeu instantané qui est lancé depuis un service HTTP local de votre ordinateur, lié à toutes les fonctions actives du SDK Instant Games.

Parfois, lorsque vous essayez cette approche, votre jeu peut être bloqué lors du chargement. Parfois, aucun message ne s’affiche dans la console développeur du navigateur ou un message indiquant Failed to execute 'postMessage' on 'DOMWindow' apparaît. Ces cas sont la manifestation du même type d’erreur, qui se produit généralement lorsque votre serveur local refuse de fournir des ressources, en raison d’un problème de certificat.

Accédez alors à la racine de votre serveur local (généralement https://localhost:8000 ou https://127.0.0.1:8000) et suivez les instructions de votre navigateur indiquant d’accepter les certificats ou d’ajouter une exception de sécurité pour ce site web. Retournez à l’URL du lecteur intégré après avoir suivi ces instructions. Tout devrait fonctionner correctement.

Permalien

Since we removed "blob:" from our CSP configuration, some games made with Unity might encounter an issue at loading time. The error you might get in your web browser's console will look something like this: Refused to load the script 'blob:https://apps-xxx.apps.fb UnityLoader.js'

To solve this issue, you could try to:

  1. Upgrade to a newer version of Unity
  2. Replace the Unity Loader code to use this version of “loadCode” function: loadCode:function(e,t,r){var s=document.createElement("script");s.src="Build/"+r.url,s.onload=function(){t(r.url.split('.').slice(0,-1).join('.')),delete s.onload},document.body.appendChild(s)},
  3. Contact Unity support team
Permalien

Monetizing a Game

Advertising

Payments

Onboarding with Facebook

Tax details can be found in section 3.9 of our Payments Terms page.

Permalien

Using Payout Account Information

Status of Payout

When you complete a sale on our platform, Facebook will credit the proceeds from that sale, less our service fee, to your Developer Balance. Facebook will earn a 30% service fee, plus any applicable sales tax or VAT, in connection with each Facebook Payments transaction on our platform. Review our Payments Terms for more details.

Permalien

Pour signaler un problème lié à vos paiements récents, envoyez une demande à l’aide du formulaire Assistance Paiements Facebook pour la monétisation et sélectionnez Jeu/app (développeur) > Paiements > J’ai une question sur mon dernier règlement.

Pour les questions relatives aux paiements et rapports, contactez l’assistance de Paiements Facebook.

Permalien

Faire remonter le problème ou ouvrir un ticket supplémentaire compliquera votre demande existante auprès de notre équipe chargée des opérations de paiement. Nous conseillons vivement à tous nos partenaires de canaliser toutes mesures de suivi via le canal de communication que vous avez ouvert avec l’équipe des opérations de paiement.

Permalien

Privacy and Security


Getting Help on Payments

Si vous avez besoin d’aide pour mettre à jour les informations de votre compte, consultez notre page d’aide de Paiements. Lorsque vos informations financières sont mises à jour, nous mettons votre compte en attente pendant 10 jours avant tout traitement de paiement. Nous pouvons supprimer ce temps d’attente plus rapidement si vous nous envoyez une preuve de la détention du compte bancaire ou PayPal. En guise de preuve, vous pouvez nous envoyer un relevé bancaire, une lettre de la banque sur papier à en-tête approprié ou une capture d’écran de PayPal.

Permalien

Si vous êtes l’administrateur du compte, le nom de l’établissement financier associé à votre compte dans votre tableau de bord de votre Business Manager. Si vous souhaitez être ajouté en tant qu’administrateur financier du compte, faites-en la demande auprès d’un administrateur de votre entreprise. Une fois amis sur Facebook, il pourra vous ajouter directement sur le site Facebook pour les développeurs.

Permalien

Veuillez utiliser notre formulaire Assistance Paiements Facebook pour la monétisation, puis sélectionnez Jeu/app (développeur) > Mettre à jour les informations du compte > Modifier l’organisation associée avec mon app ou Page Facebook.

Permalien

Rendez-vous sur notre formulaire Assistance Paiements Facebook pour la monétisation, sélectionnez Jeu/app (développeur) > Mettre à jour les informations du compte > Modifier l’organisation associée avec mon app ou Page Facebook.

Permalien

Si vous avez développé des apps utilisant les fonctionnalités de paiement et d’inscription de Facebook, vous pouvez obtenir une répartition complète de vos activités de remboursement et de rejet de débit en utilisant la fonctionnalité Rapports de Paiements Facebook. Un guide complet est disponible dans notre page Rapports de Paiements.

Permalien

Nous n’avons pas de système de notification, mais nous incluons les informations de remboursement dans le PDF de remise que nous envoyons chaque mois.

Permalien

Les remboursements sont versés mensuellement, mais la période de paiement est de 60 jours, c’est-à-dire que les activités de paiement de janvier seront versées en mars, par exemple.

Permalien

Chaque joueur peut y accéder à partir des Paramètres, et plus particulièrement dans la section Paiements. Suggérez aux joueurs d’en apprendre davantage dans Paiements Facebook.

Permalien

Publishing a Game

General Info

Pour restreindre l’accès du jeu à une liste personnalisée de pays :

  1. Dans le tableau de bord de l’application, accédez à Paramètres/Avancé.
  2. Activez Restrictions de pays.
  3. Sélectionnez des pays à partir du sélecteur Pays autorisés.
  4. Cliquez sur Enregistrer les modifications.
Permalien

Lorsque vous soumettez votre jeu instantané pour examen, vous devez fournir l’ID d’une équipe de développeurs Apple conformément aux directives d’examen 4.7 de l’App Store. d’Apple. Cela permet de distribuer votre jeu sous iOS. Si vous utilisez un ID d’équipe de développeurs non valide ou expiré, votre jeu peut être supprimé.

Vous pouvez trouver votre ID d’équipe en vous connectant à votre compte de développeur Apple.

Permalien

Developer game submissions and launches are limited to three per week (7 consecutive days starting from the first submission/launch time). Three games can be reviewed by Facebook per week, and three games can be published per week, once they have been reviewed and approved. We created this limit to help you be successful as you launch your game.

To learn more about the review process, see the Submitting for Review section in the Launch Checklist.

Permalien

Review Process

L’onglet Examiner du tableau de bord des développeurs vous permet de soumettre votre jeu à notre équipe en vue de son examen.

Vous devez soumettre votre jeu afin qu’il obtienne les certifications suivantes :

  1. Jeux instantanés
  2. Achats intégrés
  3. Pages_messaging (pour bots)

Vous avez besoin d’un Gestionnaire de monétisation pour soumettre votre jeu :

  1. Monétisation des publicités Audience Network.
Permalien

Avant d’envoyer votre jeu en certification IAP, l’application doit être approuvée pour le réseau Audience Network.

En savoir plus sur l’envoi de votre app pour certification.

Permalien

Notre équipe responsable des opérations de développement met généralement moins d'une semaine à traiter votre envoi.

Permalien

The purpose of each review is to ensure quality and integrity standards are met for on-boarding to the Instant Games platform.

Specifically, we screen games for compliance with functionality and adherence to the Facebook Platform Terms and Developer Policies.

Before submitting for review, make sure to check the Release guidelines.

Permalien

If your current submission requires additional information, you can go to your app dashboard and visit the required actions tab to check the warning period and required steps.

Permalien

Notre équipe de certification utilise les instructions que vous fournissez pour tester les intégrations de votre app à Facebook.

Si vous pensez que notre examinateur a refusé à tort votre app, vous devez la renvoyer pour certification avec des instructions à jour qui fournissent davantage d’informations à l’examinateur.

Le processus de certification est le meilleur moyen de communiquer avec votre examinateur. Il vous suffit de mettre à jour vos notes pour tenir compte du retour que vous avez reçu.

Permalien

Vous ne pouvez pas utiliser l’ID d’app Facebook créé pour votre Jeu instantané avec une autre plate-forme. Pour en savoir plus, consultez notre documentation.

Permalien

Pour le Contrôle app, les soumissions de jeux devront être associées à une entreprise (vérifiée ou non).

Lors des lancements mondiaux et par pays, l’entreprise associée à l’app doit être vérifiée pour que le jeu soit lancé sur nos espaces de découverte (liste de jeux, etc.). Le jeu sera toujours jouable après le processus d’approbation.

Pour vérifier votre entreprise, vous devez créer un Business Manager. Vous trouverez plus d’informations sur Vérification d’entreprise ici.

Permalien

Vous pouvez toujours trouver l’état de vérification de l’entreprise et des contrats ainsi que les étapes à suivre dans le panneau de vérification de l’entreprise qui se trouve dans l’onglet Contrôle app du tableau de bord de l’application. Nous vous enverrons des notifications tout au long du processus pour vous informer des mesures à prendre.

Permalien

Si vous avez déjà un compte Business Manager, nous vous recommandons de connecter l’application au Business Manager existant.

Si plusieurs comptes Business Manager appartiennent à l’entreprise, nous recommandons de déterminer le rôle de chacun d’eux et d’associer l’app au Business Manager le plus approprié. Si l’entreprise dispose d’une ligne de crédit établie par l’intermédiaire du Business Manager, nous vous recommandons de connecter l’app au Business Manager qui dispose de cette ligne de crédit.

Permalien