[[apiV5Client/qurator/scenario|Назад]]
===== Получения очереди рекламных блоков =====
http://q5.yovoads.com/api/gs?id=1&token=12345678901234567890123456789012
==== Post params ====
ResetQueue int (default=0). 0 - не обнулять сценарий. 1 - обнулить.
Если параметр 1 рекламная очередь не учитывает прошлые показы рекламы по данному
девайсу. (Рекламная очередь формируется с начала)
SessionId string (параметр из ответа запроса init)
AdTypeId int по какому типу рекламы получать очередь. -1 - по всем
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 - ширина экрана в пикселях
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)
Справочники
* [[apiV5Client/enums/device_types|Device_Types]]
* [[apiV5Client/enums/networkconn|NetworkConnection_Types]]
=== OK Response ===
{
"Data": {
"Queue": [
{
"AdTypeId": 0,
"Rules": [
{
"Id": 156,
"AdNetworkId": 4,
"Limit": 1,
"Value": 0,
"ShowTime": 30,
"AdUnitPrice": 0,
"AdBlocks": null
},
{
"Id": 146,
"AdNetworkId": 0,
"Limit": 1,
"Value": 0,
"ShowTime": 5,
"AdUnitPrice": 0,
"AdBlocks": [
{
"YovoAdId": "127_iGmNsplnZbkidyZm",
"ClickURL": "http://rd.yovoads.com/r?a=127_iGmNsplnZbkidyZm&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/P5Zuif6mg_246.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/P5Zuif6mg_96.png",
"VideoURL": "",
"Title": "Banner Golyboy",
"Description": "Banner Golyboy",
"ImgH": 120,
"ImgW": 246
}
]
},
{
"Id": 147,
"AdNetworkId": 0,
"Limit": 2,
"Value": 0,
"ShowTime": 5,
"AdUnitPrice": 0,
"AdBlocks": [
{
"YovoAdId": "123_geudiQPKyPiYxdiL",
"ClickURL": "http://rd.yovoads.com/r?a=123_geudiQPKyPiYxdiL&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/Q08fiB6mg_246.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/Q08fiB6mg_96.png",
"VideoURL": "",
"Title": "Banner Grey",
"Description": "Banner Grey",
"ImgH": 120,
"ImgW": 246
},
{
"YovoAdId": "115_HSyZWUSdDMnbxuew",
"ClickURL": "http://rd.yovoads.com/r?a=115_HSyZWUSdDMnbxuew&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/A26C4I6iR_246.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/A26C4I6iR_96.png",
"VideoURL": "",
"Title": "Banner Purpur",
"Description": "Banner Purpur",
"ImgH": 120,
"ImgW": 246
}
]
},
{
"Id": 145,
"AdNetworkId": 0,
"Limit": 3,
"Value": 0,
"ShowTime": 7,
"AdUnitPrice": 0,
"AdBlocks": [
{
"YovoAdId": "114_uwIVchNxswznvUQh",
"ClickURL": "http://rd.yovoads.com/r?a=114_uwIVchNxswznvUQh&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/g9tjVIeiR_246.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/g9tjVIeiR_96.png",
"VideoURL": "",
"Title": "Banner Green",
"Description": "Banner Green",
"ImgH": 120,
"ImgW": 246
},
{
"YovoAdId": "116_zGNKgAHFrvkqbZNY",
"ClickURL": "http://rd.yovoads.com/r?a=116_zGNKgAHFrvkqbZNY&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/Kmtq4S6mR_246.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/Kmtq4S6mR_96.png",
"VideoURL": "",
"Title": "Banner Red",
"Description": "Banner Red",
"ImgH": 120,
"ImgW": 246
},
{
"YovoAdId": "116_RHHBSHNRdTpoqumJ",
"ClickURL": "http://rd.yovoads.com/r?a=116_RHHBSHNRdTpoqumJ&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/Kmtq4S6mR_246.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/Kmtq4S6mR_96.png",
"VideoURL": "",
"Title": "Banner Red",
"Description": "Banner Red",
"ImgH": 120,
"ImgW": 246
}
]
}
]
},
{
"AdTypeId": 1,
"Rules": [
{
"Id": 149,
"AdNetworkId": 0,
"Limit": 2,
"Value": 0,
"ShowTime": 1,
"AdUnitPrice": 0,
"AdBlocks": [
{
"YovoAdId": "126_luZzUzkZkTnAgAXR",
"ClickURL": "http://rd.yovoads.com/r?a=126_luZzUzkZkTnAgAXR&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/ElEPmfemg_610.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/ElEPmfemg_144.png",
"VideoURL": "",
"Title": "Inter Orange",
"Description": "Inter Orange",
"ImgH": 298,
"ImgW": 610
},
{
"YovoAdId": "119_rEcKbgIrWHTqyCrW",
"ClickURL": "http://rd.yovoads.com/r?a=119_rEcKbgIrWHTqyCrW&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/7z9nDoeig_610.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/7z9nDoeig_144.png",
"VideoURL": "",
"Title": "Inter Green",
"Description": "Inter Green",
"ImgH": 298,
"ImgW": 610
}
]
},
{
"Id": 151,
"AdNetworkId": 0,
"Limit": 1,
"Value": 0,
"ShowTime": 1,
"AdUnitPrice": 0,
"AdBlocks": [
{
"YovoAdId": "122_LaxvbKyquUxllTYG",
"ClickURL": "http://rd.yovoads.com/r?a=122_LaxvbKyquUxllTYG&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/c3p-_aeig_610.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/c3p-_aeig_144.png",
"VideoURL": "",
"Title": "Inter Yellow",
"Description": "Inter Yellow",
"ImgH": 298,
"ImgW": 610
}
]
},
{
"Id": 150,
"AdNetworkId": 0,
"Limit": 1,
"Value": 0,
"ShowTime": 1,
"AdUnitPrice": 0,
"AdBlocks": [
{
"YovoAdId": "121_zBPxwRiXMzrGCtjw",
"ClickURL": "http://rd.yovoads.com/r?a=121_zBPxwRiXMzrGCtjw&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/BDo6Do6mg_610.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/BDo6Do6mg_144.png",
"VideoURL": "",
"Title": "Inter Red",
"Description": "Inter Red",
"ImgH": 298,
"ImgW": 610
}
]
}
]
},
{
"AdTypeId": 2,
"Rules": [
{
"Id": 144,
"AdNetworkId": 4,
"Limit": 1,
"Value": 0,
"ShowTime": 30,
"AdUnitPrice": 0,
"AdBlocks": null
},
{
"Id": 152,
"AdNetwork": 0,
"Limit": 1,
"Value": 0,
"ShowTime": 30,
"AdUnitPrice": 0,
"AdBlocks": [
{
"YovoAdId": "172_eRWINrbUfJyLdYXc",
"ClickURL": "http://rd.yovoads.com/r?a=172_eRWINrbUfJyLdYXc&p=a&t=YeLyuXBYCIHvOnhRhVCcTHxBNExNjNzp",
"ScreenshotURLImg": "http://pics.yovoads.com/zsMmDZLiR/_ag-UZnWR_720x1280.png",
"IconURLImg": "http://pics.yovoads.com/zsMmDZLiR/_ag-UZnWR_144x144.png",
"VideoURL": "http://pics.yovoads.com/zsMmDZLiR/video/_ag-UZnWR_720x1280.mp4",
"Title": "PupPur 720_1280",
"Description": "PupPur 720_1280",
"ImgH": 1280,
"ImgW": 720
}
]
}
]
}
]
},
"Error": ""
}
* **AdTypeId** = [int] - тип рекламного блока, как описано в [[apiV5Client/enums/ad_types|Ad Types]]
* **Queue** = []object - очередь, порядок рекламы
* **Id** = [int] - ID правила (RuleID - передается в дальнейшем клиентом при показе рекламы)
* **AdNetworkId** = [int] - тип рекламной сети, как описано в [[apiV5Client/enums/ad_networks|Ad Networks]]
* **Limit** = [int] - количество показов данного правила (-1 = бесконечно)
* **Value** = [int] - количество показов которое осталось показать (-1 = бесконечно)
* **ShowTime** = [int] - длительность показа рекламного блока в секундах (inter, banner)=(использувать только для Cross, Exchange, Advertising)
* **AdUnitPrice** - стоимость рекламного блока
* **AdBlocks** - список рекламных блоков для типа AdNetworkId =0 (CrossPromo)