Инструменты пользователя

Инструменты сайта


apiv5client_qurator_scenario_init

Назад

Иницилизация

http://q5.yovoads.com/api/init?id=1&token=12345678901234567890123456789012

или

http://q5.yovoads.com/api/gs?id=1&token=12345678901234567890123456789012

Post params

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 - по всем

Справочники

OK Response

{
    "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
                ]
            }
        ]
    }
}
  • 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 из справочника Advertising networks
  • AdTypes: массив из справочника Advertising types
  • ContentRating: ENUM(«Children»,«Teen»,«Adult»)
apiv5client_qurator_scenario_init.txt · Последние изменения: 2022/04/20 07:50 — serg