View source for Bubble Shooter Kit Monetization

{| style="width: 920px; horizontal-align: left;" 
|

= 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 [https://unityads.unity3d.com/help/monetization/getting-started 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:

https://wiki.gamevanilla.com/images/common/unity_ads_package.png

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

https://wiki.gamevanilla.com/images/common/unity_ads_define.png

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:

https://wiki.gamevanilla.com/images/common/unity_ads_service.png

There are several settings related to Unity Ads that you also need to set from the Bubble Shooter Kit editor ('''Tools/Bubble Shooter 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 [https://unityads.unity3d.com/help/resources/dashboard-guide#project-settings 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 [https://unityads.unity3d.com/help/resources/dashboard-guide#project-settings 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.

https://wiki.gamevanilla.com/images/fruit_swipe_match_3_kit/unity_ads_editor.png

= 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 [https://docs.unity3d.com/Manual/UnityIAPSettingUp.html 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:

https://wiki.gamevanilla.com/images/common/unity_iap_package.png

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

* In the '''Services''' window, select '''In-App Purchasing'''.

https://wiki.gamevanilla.com/images/unity_iap_services_1.png

* Click the '''Enable''' button to enable In-App Purchasing.

https://wiki.gamevanilla.com/images/unity_iap_services_2.png

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

https://wiki.gamevanilla.com/images/unity_iap_services_3.png

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

https://wiki.gamevanilla.com/images/unity_iap_services_4.png

* Add the '''BUBBLE_SHOOTER_ENABLE_IAP''' preprocessor define to your '''Scripting Define Symbols''' in your '''Player Settings'''.

https://wiki.gamevanilla.com/images/bubble_shooter_kit/iap/player_settings.png

* With Unity IAP now properly configured for your project, you can now tweak the available in-app purchasable items from the Bubble Shooter Kit editor ('''Window/Bubble Shooter 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.

https://wiki.gamevanilla.com/images/bubble_shooter_kit/iap/iap_editor.png

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 [https://docs.unity3d.com/Manual/UnityIAPSettingUp.html this guide]).

<span style="color:red">'''IMPORTANT:'''</span> 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 [https://forum.unity.com/threads/will-unityiap-use-unity-packagemanager.534990 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.

|}