Unity Ads

The kit provides a rewarded ad button in the level scene that allows the player to earn some extra coins after completely watching an ad provided by Unity Ads. Please make sure to become familiar with how Unity Ads works by reading this guide first.

The Unity Ads integration provided by the kit needs to be enabled by you. In order to do so, the first thing you need to do is to install the Advertisement package from the Package Manager:

Then, you need to add the UNITY_ADS preprocessor define to your Scripting Define Symbols in your Player Settings:

Then, you need to enable the Ads service from your Project Settings. Make sure the service is set as ON and, during development, enable the test mode option. The unique game identifiers for iOS and Android will be automatically retrieved by Unity:

There are several settings related to Unity Ads that you also need to set from the Puzzle Match Kit editor (Tools/Puzzle Match Kit/Editor). Go to the Game settings tab and open the Monetization sub-tab. In the Rewarded ad section you can find the following settings:

• Unity Ads Game ID - App Store: The Unity Ads game ID for the App Store. This value is unique to your game and you need to get it from your Developer Dasboard (or from the Ads tab in your Project Settings).
• Unity Ads Game ID - Google Play: The Unity Ads game ID for Google Play. This value is unique to your game and you need to get it from your Developer Dasboard (or from the Ads tab in your Project Settings).
• Unity Ads - Test mode: Enabled by default, this is useful for testing the Unity Ads integration works correctly before publishing your game. Make sure to disable it once you have confirmed test mode works and you are ready to publish your game.
• Coins: The number of coins to reward the player with.

Unity IAP

The kit provides a coins shop with in-app purchasable packs of coins using Unity IAP. In order to enable Unity IAP in your project, please follow this guide.

The Unity IAP integration provided by the kit needs to be enabled by you. In order to do so, the first thing you need to do is to install the In App Purchasing package from the Package Manager:

Once the package has been imported in your project, please follow these steps:

• In the Services window, select In-App Purchasing.

• Click the Enable button to enable In-App Purchasing.

• Import the Unity IAP package into your project by clicking on the Import button.

• Make sure that Analytics and In-App Purchasing are both labelled ON as shown below.

• Add the PUZZLE_MATCH_ENABLE_IAP preprocessor define to your Scripting Define Symbols in your Player Settings.

• With Unity IAP now properly configured for your project, you can now tweak the available in-app purchasable items from the Puzzle Match Kit editor (Window/Puzzle Match Kit/Editor). Go to the Game settings tab and open the Monetization sub-tab. You can edit the settings of your items in the In-app purchases category.

The Store id needs to be exactly the same identifier you use in your store (App Store, Google Play, etc.), while the rest of the fields are only visual. Please note you will need to have previously defined your available in-app purchasable items in the store/s of your choice (for more details, please follow this guide).

IMPORTANT: Even if the latest versions of Unity provide a built-in IAP package, you still need to perform the previous configuration manually. You can read more about why this is needed here.

Also, and specifically for Android, you can track verified transactions in Unity Analytics by performing the following steps:

• Go to the Window menu -> Unity IAP -> Receipt validation obfuscator.
• Follow the instructions to copy the license key.
• Return to "Receipt validation obfuscator" and paste the key.
• Press the "Obfuscate Google Play License Key".
• Open the "Analytics Dashboard" (following the link on step 4).
• Paste the key also in dashboard and save changes.
• Return to Unity and close "Receipt validation obfuscator".
• Make sure that the key is pasted and active in Services tab -> InApp.
• Go to Purchasing -> Options (if not, paste it there also and press the button).

Please note that, in order to be able to test in-app purchases on Android, you will need to upload your .APK to Google Play (for example, to the closed alpha channel) and test on your mobile phone. A direct build from Unity will not work.