[[apiV5Client/qurator/scenario|Назад]]
===== Иницилизация =====

<code>
http://q5.yovoads.com/api/init?id=1&token=12345678901234567890123456789012
</code>
или
<code>
http://q5.yovoads.com/api/gs?id=1&token=12345678901234567890123456789012
</code>
==== Post params ====

<code>
Test            int    (default=0) - если параметр есть и он больше ноля то тогда тестовый режим включен

SDKVerC*        string - версия SDK клиента

OS*             string - операционная система девайса (ENUM('ios','android')) case insensitive
OSV             string (default="Unknown") - версия операционной системы

Bundle*         string - android packagename приложения/ios itunesid приложения
BundleVer*      string - версия кода приложения (bundle version code)

H*              int - высота экрана в пикселях (максимальная по длине сторона является высотой)
W*              int - ширина экрана в пикселях
RealHeight      int - реальна высота экрана включительно со статус баром и виртуальной клавиатурой

PageOrientation int (0 - OrientationLandscape
	             1 - OrientationPortable)
GAID*           string(40) - Google Advertising ID/для iOS - IDFA;
IsRandomGAID    int - (default=0) Если gaid недоступен, то 1 и в gaid идет рендомное значение. Иначе 0

ConnectionType  int    (default=0) - Тип соединения клиента с интернетом из справочника NetworkConnection_Types
DeviceType      int    (default=0) - тип устройства из справочника Device_Types
Make            string (default="Unknown") - производитель девайса (например "Apple", "Samsung", "Xiaomi")
Model           string (default="Unknown") - модель девайса (например "G935F", "XS")
Lang            string (default="en") - 2х буквенный язык пользователя согласно [[https://en.wikipedia.org/wiki/ISO_639-1]]

YOB             int    (default=0) - год рождения пользователя
Gender          string (default="O") - пол пользователя (“M” = male, “F” = female, “O” = omitted = unknown)

ResetQueue      int    (default=0). 0 - не обнулять сценарий. 1 - обнулить. 
                       Если параметр 1 рекламная очередь не учитывает прошлые показы рекламы по данному       
                       девайсу. (Рекламная очередь формируется с начала)     
AdTypeId        int по какому типу рекламы получать очередь. -1 - по всем

</code>
Справочники
  * [[apiV5Client/enums/device_types|Device_Types]]      
  * [[apiV5Client/enums/networkconn|NetworkConnection_Types]]
=== OK Response ===
<code>
{
    "Error": "",
    "SessionId":"vE8LZwPHE8uuMKj8GVg1JTgb_tficxIvrtLCY3mGFX_3K3rD_CigIJ7B9KCoLAfzauUCrpW8CWzTSFwo9FI8Y7EW00HNlbaMpHkSwGUb_Xyzzo1ofPr_6-9xwmhfHCRGa3dE9owwFdvA7_VZO30a80Y=",
    "RewardData": {
        "MaxCountPerDay": 100,
        "MinimumPeriodSec": 10,
        "Shows24": 0,
        "NextShow": 0
    },
    "Settings": {
        "Application": {
            "ContentRating":"Children",
            "MaxCountPerDay":0,
            "MinimumPeriodSec":0 
        },
        "GlobalSettings": {
            "SessionPeriod": "13",
            "BannerLowDuration": "30",     * - to be deleted in SDK 6.0
            "BannerMediumDuration": "40",  * - to be deleted in SDK 6.0
            "BannerHighDuration": "50"     * - to be deleted in SDK 6.0
        },
        "AdNetworks": [
            {
                "Id": 0,
                "AdTypes": [
                    0,
                    1,
                    2
                ]
            },
            {
                "Id": 1,
                "AdTypes": [
                    0,
                    1,
                    2
                ]
            },
            {
                "Id": 2,
                "AdTypes": [
                    0,
                    1,
                    2
                ]
            },
            {
                "Id": 3,
                "AdTypes": [
                    0,
                    1,
                    2
                ]
            },
            {
                "Id": 4,
                "AdTypes": [
                    0,
                    1,
                    2
                ]
            },
            {
                "Id": 5,
                "AdTypes": [
                    0,
                    1,
                    2
                ]
            }
        ]
    }
}
</code>
  * **SessionId** [string] - session id который необходимо передавать в дальнейшем для запроса рекламы в /gs
  * **Settings/SessionPeriod** [string] - получаем от сервера период с какой частотой отправлять запрос session в секундах
  *  **BannerLowDuration** [string] - время показа дешевых баннеров сторонних сетей (AdMob, Facebook) в секундах
  *  **BannerMediumDuration** [string] - время показа средних баннеров сторонних сетей (AdMob, Facebook) в секундах
  *  **BannerHighDuration** [string] - время показа дорогих баннеров сторонних сетей (AdMob, Facebook) в секундах
  * **MaxCountPerDay** [int] максимальное количество показов Rewarded рекламных блоков за 24 часа. -1 - неограниченное количество. Выставляется в веб-интерфейсе на приложение
  *  **MinimumPeriodSec** [int] минимальный промежуток в секундах между показами Rewarded рекламы. Выставляется в веб-интерфейсе на приложение
  *  **Shows24** [int] фактическое количество показанных рекламных блоков Rewarded рекламы (с параметром ignore=0) на протяжении последних 24 часов. Обнуляется при команде ResetScenario
  *  **NextShow** [int] количество секунд до следующего возможного показа ревард рекламного блока
  *  **AdNetworks** массив данных по доступным рекламным сетям для разных рекламных провайдеров/типов рекламы
  * Id: AdNetworkID из справочника [[apiV5Client/enums/ad_networks|Advertising networks]]
  * AdTypes: массив из справочника [[apiV5Client/enums/ad_types|Advertising types]]
  * **ContentRating**: ENUM("Children","Teen","Adult")