SDK implementation
The SDK is not supported if the app launches in Unity Editor.
On the previous steps, we added the SDK to a project and made a connection to gameofwhales.com. Now we are ready to implement the SDK. Do the following steps for this.
Pay attention that the SDK will ask the following permissions on the Android user's device:
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />Init the GOW SDK when you start your app.
If you use Unity In-App Purchasing service you can do the initialization like this:
GameOfWhales.Init(GameOfWhales.GetCurrentStore());In other cases you should specify the default store manually. For example:
#if UNITY_IOS
string store = GameOfWhales.STORE_APPLEAPPSTORE;
#else
string store = GameOfWhales.STORE_GOOGLEPLAY;
#endif
GameOfWhales.Init(store);Check that Android Bundle Identifier and Android Public License Key (for Android app) and iOS Bundle Identifier (for iOS app) have been filled on Game Settings page before you will make a purchase.
Pay attention! Game of Whales doesn't support purchases from Unity editor directly.
To send information about purchases to Game of Whales, add InAppPurchased call when you make a purchase.
PurchaseProcessingResult IStoreListener.ProcessPurchase(PurchaseEventArgs e)
{
GameOfWhales.InAppPurchased(
e.purchasedProduct.definition.id,
(float)e.purchasedProduct.metadata.localizedPrice,
e.purchasedProduct.metadata.isoCurrencyCode,
e.purchasedProduct.transactionID,
e.purchasedProduct.receipt);
}If you don't use Unity IAP Service you need creating receipt value in the special format.
If you want to use Game of Whales for purchases validation, subscribe to the following events:
void Start()
{
GameOfWhales.OnPurchaseVerified += OnPurchaseVerified;
}The verify state can be:
- VERIFY_STATE_LEGAL - a purchase is normal.
- VERIFY_STATE_ILLEGAL - a purchase is a cheater's.
- VERIFY_STATE_UNDEFINED - GOW server couldn't define the state of a purchase.
You need to do this chapter steps only if you want to use special offers from Game of Whales in your app.
Before any product can be used in a special offer it has to be bought by someone after SDK has been implemented into the game. Please make sure your game has at least one purchase of the product that is going to be used in the special offer. If you want to create a special offer for an in-game resource, please, make sure your game has at least one converting event with the appropriate resource.
In order to receive the information regarding special offers' availability, subscribe to the following events when the application is initialized:
GameOfWhales.OnSpecialOfferAppeared += OnOfferAppeared;
GameOfWhales.OnSpecialOfferedDisappeared += OnOfferDisappeared;
GameOfWhales.Instance.OnFutureSpecialOfferAppeared += OnFutureSpecialOfferAppeared;Pay attention that the subscriptions are not supported if you launch the app from Unity editor.
You should decide what you want to do with the offer if the appropriate event has happened. For example, once OnOfferDisappeared event is received, you should remove all the graphical indications for the special offer from the game.
In order to receive special offer call the following method:
SpecialOffer offer = GameOfWhales.GetSpecialOffer(id);
if (offer != null)
{ ....Special offer can influence a product's price(except in-app purchases):
if (offer.HasPriceFactor())
{
price *= offer.priceFactor;
}Special offer can also influence count (count of coins, for example) which a player receives by purchase:
if (offer.HasCountFactor())
{
coins *= offer.countFactor;
}It's possible to pass custom data to special offers. In order to get the data in game's side, use customValues parameter of SpecialOffer class.
string str = offer.customValues["your_string"].ToString();
int number = int.Parse (offer.customValues["your_int"].ToString());
bool boolean = bool.Parse (offer.customValues["your_bool"].ToString());You need to do this chapter steps only if you want to receive push notifications from Game of Whales in your app.
Register your project in the Firebase console.
Add Firebase to your Unity Project and register your firebase token in the SDK when you are getting it.
public void OnTokenReceived(object sender,
Firebase.Messaging.TokenReceivedEventArgs token) {
Debug.Log("Received Registration Token: " + token.Token);
//register your token at SDK
GameOfWhales.UpdateToken(token, GameOfWhales.PROVIDER_FCM);
}Open GameOfWhalesSettings form (in the Unity editor menu: go to Window >> Game of Whales) and enter Android Project ID which will be used to get a token. You can also specify Firebase Sender ID instead of Android Project ID.
If you don't use "Google Cloud Messaging" leave the "Android Project ID" field on the Unity settings as blank.
Check that the following libraries were added to your android project:
play-services-base-xxx.aar
play-services-basement-xxx.aar
play-services-gcm-xxx.aar
play-services-identity-xxx.aar
play-services-iid-xxx.aar
play-services-tasks-xxx.aar
support-v4-yyy.aar
Enable the Push Notifications option in the Xcode.
If you are building your iOS project with unity cloud build, you need to enable Remote Push Notification Capability.
Call RegisterForNotifications() method in any place of your app where the user should approve receiving notifications.
GameOfWhales.RegisterForNotifications();Add a receiver to send the information about notifications to your manifest and specify your Android Bundle Identifier instead APP_BUNDLE.
<receiver
android:name="com.gameofwhales.sdk.util.GOWBroadcastReceiver"
android:permission="com.google.android.c2dm.permission.SEND">
<intent-filter>
<action android:name="com.google.android.c2dm.intent.RECEIVE" />
<category android:name="APP_BUNDLE"/>
</intent-filter>
</receiver>
...
</application>Add the next permissions to your manifest and specify your Android Bundle Identifier instead APP_BUNDLE.
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<permission android:name="APP_BUNDLE.permission.C2D_MESSAGE" android:protectionLevel="signature" />
<uses-permission android:name="APP_BUNDLE.permission.C2D_MESSAGE" />If you haven't had an android manifest in your project yet, you can use GOWAndroidManifest.xml from SDK, but you need renaming of it to AndroidManifest.xml and replace APP_BUNDLE to your Android Bundle Identifier wherever it is defined.
In order to send the information to Game of Whales regarding a player's reaction on a push notification (to increase push campaign's Reacted field) of an already started app call the following method:
GameOfWhales.OnPushDelivered += OnPushDelivered;
...
private void OnPushDelivered(SpecialOffer offer, string campID, string title, string message)
{
//Show the notification to a player and then call the following method
GameOfWhales.PushReacted(campID);
}
In order to enable or disable push notifications, use the following method:
GameOfWhales.SetPushNotificationsEnable(false);Pay attention that this step is actual only for Unity 2017.
If you want to send push notifications with images on iOS devices, you need to do the following steps:
- Open GameOfWhalesSettings form in Unity project (go to Window >> Game of Whales) and check Notification Service option.
- Create a certificate for
{your_app_id}.notificationservicebundle. - Specify extension's bundle id in Bundle postfix field of GameOfWhalesSettings form in Unity project.
- Generate XCODE project by using Unity. Notification Service Extension will be automatically added to the project.
Make sure that deployment target is 10 because in some cases Notification Service Extension does not work on devices with the iOS version less than deployment target version.
In order to check notifications implementation send a test notification.
You can send additional data about your players by using the Profile method. Profile method should be called if key parameters of your app or a player have changed.
In order to work with AI offers you should send at least 5 number-type properties and at least one progress based parameter.
If you send more than 3000 properties, Game of Whales will sort all properties alphabetically and will save only the first 3000.
If the length of a string-type property is more than 64 characters, Game of Whales will save only the first 64 characters.
For example:
GameOfWhales.Profile(new Dictionary<string, object> {
{"coins", coins},
{"class", userClass},
{"gender", gender},
{"location", location},
{"level", level}
});If you are going to use AI offers functionality you need to send to Game of Whales information about players' game activity by using Converting method. Converting method should be called when you buy or get some in-game objects, coins, currency, etc. Read more...
For example:
Someone bought one bike_1 for 1000 coins and 50 gas. You should call the following method for this purchase:
GameOfWhales.Converting(new Dictionary<string, int> {
{"coins", -1000},
{"gas", -50},
{"bike_1", 1}
}, "shop");You can also use the following methods:
-
Consume- to buy items for game currency. For example:
GameOfWhales.Consume("coins", 1000, "gas", 50, "shop");It means that someone spent 1000 "coins" for 50 "gas" in "shop".
-
Acquire- can be used for in-app and in game items. It's important to callacquiremethod for in-app items afterInAppPurchased. For example:
GameOfWhales.Acquire("coins", 10000, sku, 1, "bank");It means that someone has acquired 10000 "coins" for 1 "sku" in "bank".
It's supported since version 2.0.20 of SDK for Unity.
To handle the ads set in Game of Whales, you need to do some actions:
Subscribe to the following events to get the information about the current state of the ads:
GameOfWhales.OnAdClosed += OnAdClosed;
GameOfWhales.OnAdLoadFailed += OnAdLoadFailed;
GameOfWhales.OnAdLoaded += OnAdLoaded;Start to load the ads at any place of your code (for example, during the launch of the game):
GameOfWhales.LoadAd();Add the following code to the part of your game where you want to show the ads:
if (GameOfWhales.IsAdLoaded())
{
GameOfWhales.ShowAd();
}
else
{
GameOfWhales.LoadAd();
}You can find code examples here.
Pay attention that the SDK sends immediately only "login" and "purchase" events. Other events ("token", "profile", etc) are collected in the bulk and sent time by time.