Youtube

Prepare promo assets (Developer)

Prepare the promo assets required by YouTube Playables:

  • Icon
  • Banners / thumbnails
  • Make sure the images are not cropped or stretched

Build (Developer)

  • YouTube Playables does not allow scripts to be fetched from a remote server, so you need to download the connector library from our server and include it in the build.

You can download the latest version of the connector from connector.latest.js.

Add connector to the index.html. Replace your_project_id with your projectId. The projectId is the code name of the project you created in our admin panel. It is derived from your game's name, converted to a single lowercase word without spaces or separators (e.g. Relax Puzzles -> relaxpuzzles).

<script src="connector.latest.js?studioId=your_studio_id&projectId=your_project_id&source=youtube"> </script>
  • The game must support both portrait and landscape orientation on mobile (even if the game is meant to be vertical). Otherwise certification will fail.
  • The build must not contain purchases, shares, tournaments or CRM — these are disabled automatically when source=youtube.
  • Create a .zip archive of your build.
  • Validate the archive with the official Bundle Analyzer. If everything is correct it returns an empty result; otherwise it lists the problems (unsupported characters in filenames, files that are too large, etc).

Test the build (Manager)

  • Go to the YouTube Playables Test Suite.
  • Paste the link to your game into the frame and make sure it loads correctly and all checks are green.
  • Fix any issues before moving on.

Create a game (Manager)

  • Go to the Developer Portal and click Add a new game.
  • Set an ID following the rule publisher_name_game_name, e.g. slimmerbits_magic_bottles.
  • Select the .zip file with your build and press Submit.

Upload information and create a release (Manager)

  • Fill out the information about the game and upload the promo assets, then press Save draft.
  • Press Create a release and wait until the platform finishes building it. Two links will appear on the right when it is ready.
  • Use the upper link to test the game inside the YouTube environment on both Desktop and the mobile YouTube app.

Age rating (Manager)

  • Go to the Age rating tab.
  • Get a new age rating by completing the questionnaire, or choose Import an existing certificate if the game already has an IARC certificate (e.g. from Instant or Partner Center).
  • Make sure your IARC status is Complete.

Verify and test (Manager)

  • Go to the Verify and Test tab.
  • Complete all sections by answering the questions.
  • Once all sections are complete, send the game for certification.
  • Wait for the QA results, which are delivered via email and shown in the certification tab.

Add appId to config

After the game is certified, copy your game's id from the Developer Portal and add it to your project config.

"youtube": {
    "appId": "..."
}

Public launch

  • Once the game is certified, wait for the public launch.
  • When notified, check the Playables catalogue (use a VPN for US, Canada or UK) and confirm the game is live.