Различия

Здесь показаны различия между двумя версиями данной страницы.

--- apiv5client_qurator_scenario_get [2019/08/31 06:49]
serg
+++ apiv5client_qurator_scenario_get [2019/10/17 09:14] (текущий)
serg
@@ Строка 1: / Строка 1: @@
 [[apiV5Client/qurator/scenario|Назад]]
-===== Получания сценария =====
+===== Получения очереди рекламных блоков =====
 <code>
@@ Строка 10: / Строка 10: @@
 <code>
-test            int    (default=0) - если параметр есть и он больше ноля то тогда тестовый режим включен
+ResetQueue      int    (default=0). 0 - не обнулять сценарий. 1 - обнулить.
+                       Если параметр 1 рекламная очередь не учитывает прошлые показы рекламы по данному
+                       девайсу. (Рекламная очередь формируется с начала)
+SessionId       string (параметр из ответа запроса init)
+AdTypeId        int по какому типу рекламы получать очередь. -1 - по всем
-adtype*         int -  (default = -1) по какому типу рекламы запрашивается очередь из справочника AdTypes
+Test            int    (default=0) - если параметр есть и он больше ноля то тогда тестовый режим включен
-(0- banner, 1- interstitial, 2 - rewarded, -1 - по всем)
-sdkver*         string - версия SDK клиента
+SDKVerC*        string - версия SDK клиента
-os*             string - операционная система девайса (ENUM('ios','android')) case insensitive
+OS*             string - операционная система девайса (ENUM('ios','android')) case insensitive
-osv             string (default="Unknown") - версия операционной системы
+OSV             string (default="Unknown") - версия операционной системы
-bundle*         string - android packagename приложения/ios itunesid приложения
+Bundle*         string - android packagename приложения/ios itunesid приложения
-bundlever*      string - версия кода приложения (bundle version code)
+BundleVer*      string - версия кода приложения (bundle version code)
-h*              int - высота экрана в пикселях (максимальная по длине сторона является высотой)
+H*              int - высота экрана в пикселях (максимальная по длине сторона является высотой)
-w*              int - ширина экрана в пикселях
+W*              int - ширина экрана в пикселях
-gaid*           string(40) - Google Advertising ID/(что для iOS??????);
+PageOrientation int (0 - OrientationLandscape
+- OrientationPortable)
+GAID*           string(40) - Google Advertising ID/для iOS - IDFA;
+IsRandomGAID    int - (default=0) Если gaid недоступен, то 1 и в gaid идет рендомное значение. Иначе 0
-connectiontype  int    (default=0) - Тип соединения клиента с интернетом из справочника NetworkConnection_Types
+ConnectionType  int    (default=0) - Тип соединения клиента с интернетом из справочника NetworkConnection_Types
-devicetype      int    (default=0) - тип устройства из справочника Device_Types
+DeviceType      int    (default=0) - тип устройства из справочника Device_Types
-make            string (default="Unknown") - производитель девайса (например "Apple", "Samsung", "Xiaomi")
+Make            string (default="Unknown") - производитель девайса (например "Apple", "Samsung", "Xiaomi")
-model           string (default="Unknown") - модель девайса (например "G935F", "XS")
+Model           string (default="Unknown") - модель девайса (например "G935F", "XS")
-lang            string (default="en") - 2х буквенный язык пользователя согласно [[https://en.wikipedia.org/wiki/ISO_639-1]]
+Lang            string (default="en") - 2х буквенный язык пользователя согласно [[https://en.wikipedia.org/wiki/ISO_639-1]]
-yob             int    (default=0) - год рождения пользователя
+YOB             int    (default=0) - год рождения пользователя
-gender          string (default="O") - пол пользователя (“M” = male, “F” = female, “O” = omitted = unknown)
+Gender          string (default="O") - пол пользователя (“M” = male, “F” = female, “O” = omitted = unknown)
 </code>
@@ Строка 43: / Строка 49: @@
 <code>
 {
- "error":"",
+    "Data": {
- "data":{
+        "Queue": [
-    "Queue":[
+            {
-             {"T":0,"Q":[{"ID":5,"ADN":1,"Limit":1,"Value":1,"ShowTime":30},{"ID":10,"ADN":5,"Limit":1,"Value":1,"ShowTime":30}]},
+                "AdTypeId": 0,
-             {"T":1,"Q":[{"ID":5,"ADN":1,"Limit":1,"Value":1,"ShowTime":30},{"ID":10,"ADN":5,"Limit":1,"Value":1,"ShowTime":30}]},
+                "Rules": [
-             {"T":2,"Q":[{"ID":5,"ADN":1,"Limit":1,"Value":1,"ShowTime":30},{"ID":10,"ADN":5,"Limit":1,"Value":1,"ShowTime":30}]}
+                    {
-            ],
+                        "Id": 156,
-    "Modified": UNIXTIME
+                        "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>
-  * **T** = [int] - тип рекламного блока, как описано в [[apiV5Client/enums/ad_types|Ad Types]]
+  * **AdTypeId** = [int] - тип рекламного блока, как описано в [[apiV5Client/enums/ad_types|Ad Types]]
-  * **Dt** = [int64] - unixTime, дата последнего обновления сценария
+  * **Queue** = []object - очередь, порядок рекламы
-  * **Q** = []object - очередь, порядок рекламы
+    * **Id** = [int] - ID правила (RuleID - передается в дальнейшем клиентом при показе рекламы)
-    * **ID** = [int] - ID правила (RuleID - передается в дальнейшем клиентом при показе рекламы)
+    * **AdNetworkId** = [int] - тип рекламной сети, как описано в [[apiV5Client/enums/ad_networks|Ad Networks]]
-    * **ADN** = [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

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

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

Различия

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