For Stencyl 3.4 9280 and above
Stencyl extension for “UnityAds” (http://unityads.unity3d.com) for iOS and Android. This extension allows you to easily integrate UnityAds on your Stencyl game / application. (http://www.stencyl.com)
This Extension Required the Toolset Extension Manager https://byrobingames.github.io
UnityAds will automatically present users with an opportunity to opt-out of targeted advertising. See https://unityads.unity3d.com/help/legal/gdpr
It is also possible to set the consent programmatically, use the set consent to YES/NO block. (see documentation and block section)
To install this Engine Extension, go to the toolset (byRobin Extension Mananger) in the Extension menu of your game inside Stencyl.
Select the Extension from the menu and click on “Download”
If you not have byRobin Extension Mananger installed, install this first.
Go to: https://byrobingames.github.io
Step 1: If you don’t have an account, create one on https://operate.dashboard.unity3d.com
Step 2: Create an project and add your platfom (iOS/Andoid)
Step 3: Open Project and get your Game id of the Platform you work with.
Fill your Game id in the Toolset Manager
Step 4: Use the initialize UniAds block in when created event of your first (loading)scene.
If your game is not live yet, enable Testads in the Toolset Manager, don’t forget to disable Testads when your uploading your game to the store.
Step 5: Open the Platform you work with (iOS or Android) and get your Integration Id of the placements your added.
In this example i use iOS platform:
The Integration Id of Ad Placement Video is video
The Integration Id of Ad Placement Rewarded Video is rewardedVideo,
make sure you have enabled the Rewarded Video.
Step 6: Show Video with placement id.
Show Unityads Video with placement id block,
Step 7: Show Rewarded Video.
Show Unityads Rewarded Video with placement id block,
Create and Alert title and Message that ask the player if he wants to watch the Rewarded Video or not. If Alert title is empty no Alert box will show.
Step 8: Can Show Ads
Check if ads with placement id can be show , it return true when it can show and false if ads cannot be show.
Step 9: Callbacks
Use the callback blocks in an Updated event in an if statement.
– did show
– is completed
– is skipped (Video only, Rewarded cannot be skipped)
Show Banner with PlacementId
Show the banner, by defeault at the bottom.
Hide the banner.
Move the banner to top or back to bottom.
This block is optional for UnityAds.
But if you want to set the consent programmatically you can use this block.
YES: Yes, i agree to personalized experience.
NO: No, I do not want personalized experience.
Go to https://unityads.unity3d.com/help/legal/gdpr for more information.
Return true(YES) if consent is set to YES and return false(NO) when consent is set to NO.
If you want to check if a user is in Europe, you can use the “User is in Continetn: Europe” boolean block from https://byrobingames.github.io
This software is opensource.
If you want to contribute you can make a pull request
Need help with a pull request?
Add the issue on GitHub
Need help with creating a issue?
Author: Robin Schaafsma
The MIT License (MIT)
Copyright (c) 2014 byRobinGames http://www.byrobin.nl
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.