Difference between revisions of "Fruit Swipe Match 3 Kit Monetization"

From gamevanilla wiki
Jump to: navigation, search
(Created page with "{| style="width: 920px; horizontal-align: left;" | = Unity Ads = The kit provides a rewarded ad button in the level scene that is automatically enabled if you have enabled...")
 
(Unity IAP)
 
(7 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
= Unity Ads =
 
= Unity Ads =
  
The kit provides a rewarded ad button in the level scene that is automatically enabled if you have enabled Unity Ads in your project. In order to enable Unity Ads in your project, please follow [https://unity3d.com/services/ads/quick-start-guide this guide] (stop at the part where code starts to get written, as we have already written the code for you). These are the main steps you need to perform:
+
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.
  
* Go to your '''Build Settings''' and switch your platform to iOS or Android (the platforms supported by Unity Ads).
+
There are several settings related to Unity Ads that you can tweak from the Fruit Swipe Match 3 Kit editor ('''Window/Fruit Swipe Match 3 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:
  
https://wiki.gamevanilla.com/images/unity_ads_build_settings.png
+
* '''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].
 +
* '''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].
 +
* '''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.
  
* Go to the '''Window''' menu and select the '''Services''' option. Select an organization and click on '''Create'''.
+
https://wiki.gamevanilla.com/images/fruit_swipe_match_3_kit/unity_ads_editor.png
 
+
https://wiki.gamevanilla.com/images/unity_ads_services_1.png
+
 
+
* Click on '''Ads''' and enable the '''SDK''' on your project.
+
 
+
https://wiki.gamevanilla.com/images/unity_ads_services_2.png
+
 
+
* With Unity Ads properly configured for your project, you can now tweak the amount of rewarded coins from the Fruit Swipe Match 3 Kit editor ('''Window/Fruit Swipe Match 3 Kit/Editor'''). Go to the '''Game settings''' tab and open the '''Monetization''' sub-tab. You can set the desired number of coins in the '''Coins''' field belonging to the '''Rewarded ad''' category.
+
 
+
https://wiki.gamevanilla.com/images/unity_ads_editor.png
+
 
+
'''NOTE: ''' If, after following these steps, you still do not have ads enabled on your project, you may want to disable and re-enable the service again. In our experience, Unity is finicky sometimes when it comes to detecting it.
+
  
 
= Unity IAP =
 
= Unity IAP =
Line 46: Line 37:
 
* Add the '''FRUIT_SWIPE_ENABLE_IAP''' preprocessor define to your '''Scripting Define Symbols''' in your '''Player Settings'''.
 
* Add the '''FRUIT_SWIPE_ENABLE_IAP''' preprocessor define to your '''Scripting Define Symbols''' in your '''Player Settings'''.
  
https://wiki.gamevanilla.com/images/candy_match_3_kit/unity_iap_player_settings.png
+
https://wiki.gamevanilla.com/images/fruit_swipe_match_3_kit/unity_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 Fruit Swipe Match 3 Kit editor ('''Window/Fruit Swipe Match 3 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.
 
* With Unity IAP now properly configured for your project, you can now tweak the available in-app purchasable items from the Fruit Swipe Match 3 Kit editor ('''Window/Fruit Swipe Match 3 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/candy_match_3_kit/unity_iap_editor.png
+
https://wiki.gamevanilla.com/images/fruit_swipe_match_3_kit/unity_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]).
 
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].
 
<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.
 +
 
|}
 
|}

Latest revision as of 00:56, 26 November 2020

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.

There are several settings related to Unity Ads that you can tweak from the Fruit Swipe Match 3 Kit editor (Window/Fruit Swipe Match 3 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.
  • 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.
  • 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_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 this guide. These are the main steps you need to perform:

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

unity_iap_services_1.png

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

unity_iap_services_2.png

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

unity_iap_services_3.png

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

unity_iap_services_4.png

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

unity_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 Fruit Swipe Match 3 Kit editor (Window/Fruit Swipe Match 3 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.

unity_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 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.