PokiSDK: Construct 3

Integrating the Poki SDK in Construct 3: the same five event moments as every engine, with Construct 3-specific setup.

Integration outline

  1. Set up the SDK for Construct 3. Install the community-built Poki addon (made by Ossama Jouini) via the Construct addon manager.
  2. Signal loading: fire gameLoadingFinished() when your game is done loading, so conversion to play is measured correctly.
  3. Gameplay events: fire gameplayStart() on the player's first input and every return to gameplay; gameplayStop() on every interruption (pause, level end, game over, menu).
  4. Ads: implement commercialBreak() at natural breaks before returning to gameplay, and rewardedBreak() for opt-in rewards. Mute audio and disable input during ads.
  5. Test with the Poki Inspector to verify the event flow.

Event rules and the full order-of-events reference live in the SDK overview.

Made by Ossama Jouini.

This is a Poki plugin for the Construct 3 engine. It helps you integrate the PokiSDK into your Construct 3 game.

What the plugin provides

  • A preview project showing how the SDK is implemented through the addon
  • The Poki SDK Construct 3 addon

Once you install and enable the extension, you can test the PokiSDK integration in preview mode (in the browser) and make web-mobile builds that can be uploaded to the Poki platform.

Install the SDK

  • Download the source or release: download the extension archive poki_sdkV2.

Or download the source code as a zip file:

git clone https://github.com/skymen/poki_sdkV2

Once that's done, add the extension via Menu > View > Addons Manager. You can also download an example project that shows how the Construct 3 Poki SDK can be implemented. Upload the addon by clicking Install new addon... and selecting the .c3addon you downloaded. To enable it, refresh the page; the Poki SDK addon should now appear in your Addon Manager.

Gameplay events

Use gameplay started to mark when players are playing your game (for example level start and unpause), and gameplay stopped to mark when they aren't (for example level finish, game over, pause, or quit to menu). The Construct 3 SDK ships with two trigger functions for these events; place them at the right points in your event sheet so they fire in the correct locations for your game.

commercialBreak

Commercial breaks show video ads and should be triggered at natural breaks in your game. We recommend triggering one before every gameplay started, that is, whenever the player has shown intent to continue playing. The addon provides a trigger for this, similar to the gameplay triggers.

Important information about commercialBreaks Not every commercial break will trigger an ad. Poki's system decides when a player is ready for another ad, so feel free to signal as many commercial break opportunities as possible.

rewardedBreak

Rewarded breaks let a player choose to watch a rewarded video ad in exchange for a benefit in the game (more coins, for example). When using a rewarded break, make it clear to the player beforehand that they're about to watch an ad. Check whether the ad was completed: if it wasn't, don't give the player a reward.

About the rewardedBreak timer The rewarded break affects the timing of the commercial break: when a player interacts with a rewarded break, our system's ad timer is reset so they don't immediately see another ad.

Upload and test your game in Poki for Developers

Congratulations, you've implemented the PokiSDK. Now upload your game to the Poki Inspector and test it there. When you're happy with the implementation, send us a review request and we'll play the game. If you get stuck, reach out via developersupport@poki.com.