The ayeT-Studios Unity SDK allows you to easily monetize your app and reward your users with in-app currency. Your users get access to our offerwall, allowing them to earn virtual currency.
2022-04-25: v1.8 - Updated to latest Android & iOS SDKs, fixed some warnings, based on Unity
2021 2020-06-11: v1.7.1 - Updated documentation to introduce new parameters to differentiate chargebacks from conversions
2020-07-29: v1.7 - Updated to latest Android & iOS SDKs, based on Unity 2019 LTS 2019-07-19: v1.6 - Updated wrapper & SDKs with adslot changes, recompiled iOS SDK with Swift 5
2019-02-01: v1.5 - Fixed conversion tracking issues under certain conditions (application lifecycle monitoring improved)
2018-12-04: v1.4 - Updated to Android SDK 3.0 - support for API 26+ build targets, bugfixes & improved handling under poor network conditions
2018-09-29: v1.3 - Updated iOS SDK to Xcode 10 and Swift 4.2, stripped debug symbols
2018-07-09: v1.2 - Removed Simulator Code from iOS SDK, fixed iTunes validation issues with Xcode 9+
2018-07-02: v1.1 - Updated Unity SDK (iOS) to Unity 2018 / Swift 4.1 / XCode 9.4, added post-install script for automatic XCode configuration
2018-01-20: v1.0 - Initial Release of our Publisher SDK (Unity)
The below table shows all Placement & AdSlot Type combinations that allow you to utilize the Unity SDK integration.
If you integrate the Unity SDK while using a different Placement & AdSlot combination in the ayeT-Studios dashboard, you won't be able to initialize the Offerwall.
Before you start with the integration, make sure you have:
You will find more details here:
You have to create separate placements and AdSlots for each platform you intend to build on.
Create one Placement and AdSlot for your Android App.
Create one Placement and AdSlot for your iOS App.
The minimum required OS version is iOS 11.0 (and Swift 5.x ABI) and Android 5.1+.
You can download the lastest version of our publisher package here:
Open your Unity Project
Assets -> Import Package -> Custom Package
Select the AyetUnityPlugin_vVersion.unitypackage file
Press the "Import" button to complete the process
If you're planning to build against Android, please make sure you have an AndroidManifest.xml file in Assets/Plugins/Android/. If no AndroidManifest exists, you can check out the following template: Appendix: AndroidManifest.xml Template.
Add these app permissions to the manifest:
Add our Offerwall activity to your scope:
In this step, we are going to initialize the SDK. We also use callbacks to track the user's account balance - this is optional and not required if you're planning to manage user balances on your own servers.
Attention: The username or external identifier passed in the init call (e.g. username, hashed email address, etc.) will be accessible in the conversion callbacks through the {external_identifier} parameter.
First, the SDK needs to be initialized like this (APP_KEY is the placement identifier you can find in your dashboard in the android or ios placement details):
Implement the SdkUserBalance interface in order to get notified when user balance changes occur:
userBalanceInitialized is triggered after calling AyetSdk.init().
userBalanceChanged is triggered if the user balance changes while running the app.
If you want to spend user currency, for example if the user clicks a "purchaseInAppItem" button, you can utilize the deductUserBalance function:
Implement the SdkDeductCallback interface in order to get notified if a deduction succeeded:
After initializing the SDK, you can check the current user balances anywhere in your code:
showOfferwall starts our offerwall activity and displays available tasks for the user to complete.
If you're going to use Proguard in your release build to obfuscate your application, make sure to add the following rules to your proguard-rules.pro files:
It's always highly recommended to test your release builds before publishing them on Google Play to verify that they behave as intended!
Learn about:
Setting up callbacks
IP Whitelists
Securing callbacks using HMAC Security Hash
Testing callbacks
Click on the link below:
Placement Type | AdSlot Type | Eligible Integration Type |
---|---|---|
Android App
Offerwall
Unity SDK
iOS App
Offerwall
Unity SDK
The Flutter SDK allows you to easily monetize your app or website. Your users get access to our offerwall, allowing them to earn currency for completing offers.
This is a non-official Flutter SDK and is NOT supported by ayeT-Studios, but built by the community. You are integrating this SDK at your own risk.
The below table shows all Placement & AdSlot Type combinations that allow you to utilize the Flutter SDK integration.
If you integrate the Flutter SDK while using a different Placement & AdSlot combination in the ayeT-Studios dashboard, you won't be able to initialize the Offerwall.
Before you start with the integration, make sure you:
You will find more details here:
You have to create separate placements and AdSlots for each platform you intend to build on.
Create one Placement and AdSlot for your Website.
Create one Placement and AdSlot for your Android App.
Create one Placement and AdSlot for your iOS App.
Learn about:
Setting up callbacks
IP Whitelists
Securing callbacks using HMAC Security Hash
Testing callbacks
Click on the link below:
This covers the ayeT-Studios React Native Publisher SDK. This npm package is a wrapper for our web offerwall that allows effortless integration in react native apps.
The table below shows all Placement & AdSlot Type combinations that allow you to utilize the React Native SDK integration.
If you integrate the React Native SDK while using a different Placement & AdSlot combination in the ayeT-Studios dashboard, you won't be able to initialize the Offerwall.
Before you start with the integration, make sure you have:
You will find more details here:
When working on multiple platforms, we recommend a single "Website" placement and a separate "Offerwall" adslot for each.
This allows better targeting, offer control and individual reporting and history & earnings for every user are available cross-platform:
One "Offerwall" adslot for your Website.
One "Offerwall" adslot for the associated React Native Android App.
One "Offerwall" adslot for the associated React Native iOS App.
You can check out our example app here:
Learn about:
Setting up callbacks
IP Whitelists
Securing callbacks using HMAC Security Hash
Testing callbacks
Click on the link below:
Placement Type | AdSlot Type | Eligibile Integration Type |
---|---|---|
Placement Type | AdSlot Type | Eligible Integration Type |
---|---|---|
Android App
Offerwall
Flutter SDK
iOS App
Offerwall
Flutter SDK
Website
Offerwall
Flutter SDK
Website
Offerwall
React Native SDK