Instant Games FAQ

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

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.

Consultez notre liste de moteurs compatibles.

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.

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.

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

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

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

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.

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.

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.

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.

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.

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.

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.

Make sure your understand the lifecycle of ad instances.

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

Pour en savoir plus, consultez notre page Ressources d'entreprise.

To update your payment information:

1. Go to the Facebook Developers site.
2. Click My Apps and select Audience Network or Developer tab.
3. Click the Payout tab.
4. Select an existing Payout method or create a new one.

We can issue payouts to your bank or PayPal account (does not apply to Audience Netowrk users).

Vous aurez besoin :

• des informations sur le compte de paiement (adresse, type de taxe, identifiant fiscal) ;
• des informations sur le titulaire (nom, adresse, date de naissance) ;
• d’un compte bancaire (nom de la banque, numéro de compte ou IBAN, pays, code SWIFT ou numéro d’acheminement) ;
• d’un compte PayPal (adresse e-mail utilisée pour PayPal, pays, ID de commerçant).

Government agencies use tax ID numbers to identify both individuals and businesses when assessing any taxes required by law. Where you live and how your run your business factors into which tax ID numbers you'll need.

• If you represent a business in the United States or European Union, you'll need to provide a federal employer identification number (FEIN) or a value-added tax identification number (VAT.)
• If you run your business individually as a sole proprietorship, you'll need to provide a social security number (SSN) or other tax identification (ex: country ID or passport number.)
• If you live outside of the United States and European Union, you'll need to provide an applicable identification number issued by a government agency. This number should not only uniquely identify you or your business, but it should also be associated with your Audience Network Account.

Les administrateurs de compte de paiement ont la possibilité de modifier les informations sur l’entreprise, dont les informations financières, tandis que les administrateurs d’application ou de Page ont accès aux fonctionnalités de niveau Page et application, mais ne peuvent pas modifier les informations financières.

You can review them on our Payments Terms page.

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

To update your payout account and financial information, you must be the Financial Admin of your payout account.To update your account information:

• Go to the Facebook Developers site.
• Click your profile photo in the top right corner and select Company Settings.
• Choose the appropriate tab to update your company or financial info. Scroll to the bottom and click Save Changes.

Please note, it may take a few days to finalize any changes you make to your company or financial information. Additionally, your ability to receive your payout may be affected if you edit any info before a payment is scheduled.

You must be the Financial Admin of your payout account to modify or add new users. To update or add someone as an admin:

1. Visit the Facebook Developers site.
2. Click your profile photo in the top right corner and select Company Settings.
3. Click Admins.
4. Enter the name of the new admin and then click Save Changes.

Facebook n’effectue des paiements qu’en dollars américains (USD). Si votre banque a besoin d’un compte intermédiaire ou correspondant pour recevoir des paiements en USD, veuillez fournir les informations suivantes :

• Nom de la banque intermédiaire
• Pays de la banque intermédiaire
• Code SWIFT de la banque intermédiaire

Facebook issues payments twice a month:

1. A payment for activity between the 1st through 15th of the month.
2. A payment for activity between the 16th and the end of the month.
3. A payment for Google Play from two months ago.

Facebook will issue payments approximately 21 days after each bi-monthly period. Visit the Facebook Developer Payments Terms for more information.

Google Play payments will be made approximately 45 days after each monthly period.

To check the status of your payment:

1. Visit the Facebook Developers Site.
2. Click the Audience Network tab.
3. Click the Payout tab.
4. Select Payment Reports to view your app's payments status.

If the status shows "Rejected/Pending Payment", please confirm that your Payout Account Detail Information is accurate. Additionally, you can also contact us by clicking on the "Need Help?" button within the Audience Network Dashboard for further information.

Une facture indique vos gains mensuels au cours d’un mois donné. La facture de votre compte est générée avant paiement par notre équipe en charge des finances. Le numéro de compte indiqué sur cette facture est un numéro interne pour la tenue de nos registres.

Un relevé de paiement affiche le montant versé par Facebook sur votre compte comme revenus mensuels. Lorsque notre banque initie le paiement sur votre compte bancaire, vous recevez une notification de paiement aux alentours de la troisième semaine du mois.

You can view your daily reports and payout reports to calculate your current balance by using our payments API. You can download daily reports for the previous 45 days. For details, see Payments Reports.

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.

Les paiements sont virés sur votre compte associé lorsque vous cumulez au minimum 100 $ de revenus. Si le solde de votre paiement est inférieur à 100 $ lors de n’importe quelle période de paiement, le paiement sera effectué lors du prochain cycle de paiement. Les reconductions continueront jusqu’à ce que votre solde de paiement atteigne 100 $.

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.

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.

To verify you're the Financial Admin of your payout account, please visit the Facebook Developers site.

Facebook vous remercie pour la confiance que vous nous accordez et prend les mesures nécessaires pour empêcher les accès non autorisés à vos informations. Nous conservons vos informations financières sur des serveurs sécurisés et prenons des mesures supplémentaires pour protéger ces données contre les pirates informatiques.

Même si nous pouvons partager vos coordonnées ou autres informations de profil conformément à notre politique d’utilisation des données, aucune coordonnée bancaire ni information PayPal n’est partagée, à moins que cela ne soit nécessaire pour effectuer des paiements ou respecter les exigences légales.

Facebook peut conserver vos informations pour vous éviter de les saisir à nouveau lors de futurs paiements. En outre, si vous devez demander à Facebook d’apporter des modifications à vos informations de paiements, nous pouvons conserver certaines preuves témoignant de ces modifications (par exemple : des coordonnées bancaires).

Si vous rencontrez des problèmes ou si vous avez des questions sur les paiements, dites-le nous et nous travaillerons avec vous pour nous assurer que le problème est résolu.

Si vous n’avez pas reçu votre paiement avant le 21 du mois, veuillez vérifier ce qui suit avant de contacter l’assistance :

1. Vérifiez que vous avez accumulé au moins 100 $ de revenus.
2. Contactez votre banque pour vous assurer qu’elle n’a pas refusé le paiement et que votre compte peut recevoir des paiements en dollars américains (USD).
3. Vérifiez les informations de votre compte de paiement pour vous assurer qu’elles sont exactes.

Si vous avez des questions ou rencontrez des difficultés en ce qui concerne votre compte de paiement, n’hésitez pas à nous contacter.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

Si votre envoi actuel nécessite des informations supplémentaires, vous disposez de 30 jours à compter de la réception de la demande pour la résoudre et la soumettre de nouveau pour certification. Pendant ces 30 jours, l'équipe Contrôle app vous demandera peut-être de fournir plus d'informations. Veuillez noter que la fenêtre de 30 jours ne sera pas réinitialisée à chaque nouvelle présentation pendant cette période.

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.

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.

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.

Découvrez comment créer un Business Manager

Découvrez comment vérifier une entreprise.

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.

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.