Unity SDK Integration

Sayollo Events:

To use the Sayollo events you first need to add the next using statement:

                                 using SayolloPlayer;

●  Ads status event

This event will trigger every time there will be a change in the SDK ads state, and provides the developer the option to track on 2 given states:

• • • • –  AdsStatus.HaveAdsToPlay
      • –  AdsStatus.NoHaveAdsToPlay

        These Events will allow you to decide what to do with the Player when there are no ads to play. Since we don’t want to remove the Player element for you since it may be an integral part of the game’s design, we have allowed you to decide whether you want to show it when there are no ads. If no ads exist, we will show a default video of your choice.

        In order to register a method that will trigger when the state is changed, you will need to add the following line to your code:

                    SayolloEvents.RegisterAdsStatusEventAsync(MyFunctionAdsState);
        

        “MyFunctionAdsState” method signature should look like this:

        Task MyFunctionAdsState(AdsStatus adsStatus){ … }

        ●  SDK Status event

        This Event will trigger every time the game start, and provides the developer the option to track on 2 given SDK states:

    • –  SDKStatus.Active
    • –  SDKStatus.InActive

      Again, you can choose what to do when the SDK is inactive and remove the player completely. The SDK may be inactive due to settings (for example, the player has a very old OS you don’t want us to support).

      In order to register a method that will trigger when the state is change you will need to add the following line to your code:

                        SayolloEvents.RegisterSdkStatusEventAsync(MyFunctionSdkState);
      

      “MyFunctionSdkState” method signature should look like this :

      Task MyFunctionSdkState(SDKStatus sdkStatus){ … }

       

       Do’s and Don’ts

      1. Don’t break the Prefab structure – the included prefab in our SDK is the prototype prefab
         that you should use in all the implementation of the sdk in your game.
         It’s unnecessary to try to rebuild a new screen, just use the prefab as is. Don’t use the SDK Render Area

         material or texture area on other game objects, it may cause unexpected

         behavior.

      2. You can nest our prefab into a new prefab with other game objects.
      3. Screens with very wrong aspect ratio (where width/height < 1.4 or > 2.4) will not play any ads.
      4. Placeholder – You can replace the sayollo_logo.mp4 with your own video to get an in-house user

         experience.

      GDPR & CCPA

      In order to config GDPR & CCPA settings, it is required to send the following values to the SDK, as part of the implementation in the game’s code:

      a. GDPRConsent.UserAcceptConsent – this parameter is used to indicate whether the user accepts a GDPR consent or not as part of the game’s Terms & Condition.

      1. Acceptable values: true / false
      2. Default value: false

      b. CCPAOptOut.UserRequestOptOut – (bool ExpliciteNotice, bool OptOutSale, bool LSPA). ** For more info regarding CCPA please refer to the ​iab documentation

      1. Acceptable values for each parameter: null / true / false
      2. Default value for each parameter: false

      Example:

      using UnityEngine; using SayolloPlayer;

      public class config : MonoBehaviour {

      void Start() {

      GDPRConsent.UserAcceptConsent = true;

      CCPAOptOut.UserRequestOptOut = (true, false, null);

      }

      }

       

      Troubleshoot Android

      Ads don’t return after a build is completed: Go to Edit > ​Project Settings

      

      Player -> Other Settings (android) -> Configuration -> Internet Access​.

      Change the value to “Require”