Building games for Instant Games requires that you build your game in HTML5. Here's a list of Best Practices while developing your Instant Game:
Initial loading shouldn't take more than 5 seconds: Instant Games need to be "instant", and players will tend to churn away if the initial loading takes too long. The total size of your bundle can be up to 200MB, but we'll only load the files explicitly required by your
index.html during initial loading. So make sure to use that time to only load essential assets for the first session and postpone loading of other assets for when they are needed.
Report initial loading progress: During initial loading, you should inform us on your loading progress by using
Avoid secondary loading screens: Once the native loading ring shows completion at 100%, the player shouldn't be thrown into another waiting experience - they should be able to play right away.
Optimize for mobile: Although Instant Games works on desktop browsers, the majority of sessions are from Mobile devices. It's a good idea to optimize rendering and aspect ratio for popular iOS and Android devices.
Load resources in parallel with
initializeAsync: You shouldn't wait for the
initializeAsync promise to resolve before downloading your resources. You can download in parallel.
Include a short, non-intrusive tutorial for first-time players, if your game is not self-explanatory.
Allow seasoned players to come back to the tutorial if they choose to. It can be that they haven't played the game in a while, or that they want to show the tutorial to a friend. Take note not to force the tutorial in every session, but give experienced players the opportunity to jump right into play.
Consider group settings for new players who join the group later. You should ensure that these players see the tutorial on their first play.
Use playable tutorials over text if possible. The best tutorials are those that users do not know are tutorials.
Make sure to handle interruptions by implementing the
onPause callback. This will allow your game to gracefully handle situations in which the player was interrupted (by a notification, phone call, app switch, etc.). You should also pause the music and sounds of your game.
Make sure all list items in the lobby have a CTA: if you're developing a turn-based asynchronous game it's a very good practice to implement a lobby screen, where players can easily navigate all current and suggested matches. For this lobby screen consider the following sections with corresponding CTAs.
|Section Name||User Filter||Suggested CTA||CTA Action|
Connected players who are active in other threads but don't have any active matches with the current player
"Start new match"
Waiting for your turn
Matches in which the other players are waiting for the current player to play their turn
"Play your turn"
Waiting for their turn
Matches in which the current player is waiting for other players to play their turn
Previous matches that have ended already
Enable single-player mode for players who are waiting for their turn, or have run out of challenges for the day.
Tailor the experience for the context type: since an Instant Game can be played in many different types of contexts (one-to-one conversations, group conversations, news feed posts, etc.), make sure that your game always reads
FBInstant.context.getType() and loads the appropriate experience for that context type.
Localize your game: players tend to engage more with the game if they can play in a language that's natural to them. The table below will help you decide which languages to translate your game content to:
EN (English), ES (Spanish), PT (Portuguese), FR (French), AR (Arabic), ID (Indonesian), VI (Vietnamese), TH (Thai), TR (Turkish), DE (German)
Top 10 Languages
IT (Italian), ZH (Chinese), RU (Russian), PL (Polish), JA (Japanese), NL (Dutch), SV (Swedish), HU (Hungarian), EL (Greek), CS (Czech)
Next Top 10 Languages
Encourage group play: players interacting in large groups (3 people or more) tend to show much better retention, so even if your game was designed to be 1 vs. 1, you should make sure to provide a good in-game experience for people playing in larger groups. You can encourage group play by designing competitive features such as per-group leaderboards or collaborative features such as boss raids.
Sharing and inviting should be meaningful: players respond much better to an invite if the message they receive has meaningful social context. For instance a message like "Your friend is stuck in this level, can you help them?" and that opens the game directly on the corresponding level is recommended over a generic "Your friend invited you to play this game".
Custom updates should be relevant and contextual, for instance a custom update that shows a player overtaking another in the leaderboard is preferred over one that only shows the new score of the player.
Use data payloads on custom updates to provide a contextual experience, for instance, if a custom update message says "Your friend is asking for your help to defeat this boss", the CTA of the message should take the invited player directly to that boss battle and not to the initial screen of the game.
Home screen shortcuts (Android): Make sure to prompt your players if they want to save a shortcut directly to your game. You can use our SDK's method
canCreateShortcutAsync to infer if that session supports creation of a shortcut. This feature can radically improve your player's retention
Timely: Build an option screen in your game client that gives the players control to switch bot messages on/off and also gives them control about what time of the day to receive their messages.
Relevant: Bot messages should have some game or social context. Messages like "your expedition has finished, come back to collect your rewards" is preferred over messages like "you haven't played in a while, please come back to the game".
Valuable: Make sure your players have the right incentives open the game via a bot message by using the message payload to reward them in-game with something valuable. A bot message is usually not valuable if it opens your game in the start screen.
Provide relevant, timely and valuable updates to the players. For more information, visit our Best Practices section.
Give the user control (for example, by confirming they would like to be notified, and with what frequency).
Use entry point data on play buttons to load the game in contextually relevant ways.
Name the bot the same as the game.
Make use of social updates like turn reminders, tournaments results, timed rewards and challenges.
Make sure your players have the right incentives open the game via a bot message by using the message payload to reward them in-game with something valuable. A bot message is usually not valuable if it opens your game to the start screen.
Use a persistent menu to provide common actions, such as launching the game.
Set default action to use
game_play on custom updates, so that the entire image takes you into the game.
Use bots to announce new features or content.
Optimize time of day for message sends per user, being sensitive to timezones.
Follow the general best practices for Messenger Bots.
Send a message immediately after the player closes the game.
Send messages to re-engage the player with no context (e.g.: "Come back to the game now!"). Instead prefer re-engagement messages with rich context (e.g.: "Your scout has come back with more info")
Adopt the voice of other Facebook users or mislead players to believe their friends are communicating with them.
Continue to send a user bot messages when they repeatedly do not engage. Policy limits will apply and block your message from being sent. Current limits are 5 messages over 10 days of last game play session. When testing your bot, make sure to play your game at least once every 5 messages.
messaging_type to any other value than
Use the Messenger Platform's Broadcast API as it is currently not yet available for game bots. Please reach out to your partner manager if you are interested in using it.
Link to any app store.