Инструменты пользователя
apiv5client_qurator_scenario_get
Это старая версия документа!
Получения очереди рекламных блоков
http://q5.yovoads.com/api/gs?id=1&token=12345678901234567890123456789012
Post params
resetqueue int (default=0). 0 - не обнулять сценарий. 1 - обнулить. Если параметр 1 рекламная очередь не учитывает прошлые показы рекламы по данному девайсу. (Рекламная очередь формируется с начала)
test int (default=0) - если параметр есть и он больше ноля то тогда тестовый режим включен
adtype* int - (default = -1) по какому типу рекламы запрашивается очередь из справочника AdTypes
(0- banner, 1- interstitial, 2 - rewarded, -1 - по всем)
sessionid* string - данные из запроса init
sdkver* 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)
Справочники
OK Response
{
"data": {
"Queue": [
{
"T": 0,
"Q": [
{
"ID": 156,
"ADN": 4,
"Limit": 1,
"Value": 0,
"ShowTime": 30,
"AdUnitPrice": 0,
"AdBlocks": null
},
{
"ID": 146,
"ADN": 0,
"Limit": 1,
"Value": 0,
"ShowTime": 5,
"AdUnitPrice": 0,
"AdBlocks": [
{
"AdID": "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,
"ADN": 0,
"Limit": 2,
"Value": 0,
"ShowTime": 5,
"AdUnitPrice": 0,
"AdBlocks": [
{
"AdID": "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
},
{
"AdID": "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,
"ADN": 0,
"Limit": 3,
"Value": 0,
"ShowTime": 7,
"AdUnitPrice": 0,
"AdBlocks": [
{
"AdID": "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
},
{
"AdID": "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
},
{
"AdID": "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
}
]
}
]
},
{
"T": 1,
"Q": [
{
"ID": 149,
"ADN": 0,
"Limit": 2,
"Value": 0,
"ShowTime": 1,
"AdUnitPrice": 0,
"AdBlocks": [
{
"AdID": "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
},
{
"AdID": "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,
"ADN": 0,
"Limit": 1,
"Value": 0,
"ShowTime": 1,
"AdUnitPrice": 0,
"AdBlocks": [
{
"AdID": "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,
"ADN": 0,
"Limit": 1,
"Value": 0,
"ShowTime": 1,
"AdUnitPrice": 0,
"AdBlocks": [
{
"AdID": "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
}
]
}
]
},
{
"T": 2,
"Q": [
{
"ID": 144,
"ADN": 4,
"Limit": 1,
"Value": 0,
"ShowTime": 30,
"AdUnitPrice": 0,
"AdBlocks": null
},
{
"ID": 152,
"ADN": 0,
"Limit": 1,
"Value": 0,
"ShowTime": 30,
"AdUnitPrice": 0,
"AdBlocks": [
{
"AdID": "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": ""
}
* **T** = [int] - тип рекламного блока, как описано в [[apiV5Client/enums/ad_types|Ad Types]] * **Dt** = [int64] - unixTime, дата последнего обновления сценария * **Q** = []object - очередь, порядок рекламы * **ID** = [int] - ID правила (RuleID - передается в дальнейшем клиентом при показе рекламы) * **ADN** = [int] - тип рекламной сети, как описано в [[apiV5Client/enums/ad_networks|Ad Networks]] * **Limit** = [int] - количество показов данного правила (-1 = бесконечно) * **Value** = [int] - количество показов которое осталось показать (-1 = бесконечно) * **ShowTime** = [int] - длительность показа рекламного блока в секундах (inter, banner)=(использувать только для Cross, Exchange, Advertising)
apiv5client_qurator_scenario_get.1567609362.txt.gz · Последние изменения: 2019/10/15 08:49 (внешнее изменение)
Инструменты страницы
