YovoAds

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
[[apiV5Client/qurator/scenario|Назад]]

===== Получения очереди рекламных блоков =====

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

==== Post params ====

<code>
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)

</code>
Справочники
  * [[apiV5Client/enums/device_types|Device_Types]]      
  * [[apiV5Client/enums/networkconn|NetworkConnection_Types]]
=== OK Response ===
<code>
{
    "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": ""
    }
</code>

  
  * **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)
YovoAds

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

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

Инструменты страницы
