[[apiv5|Назад]]
===== Запрос на получение рекламы YovoExchange =====

<code>
http://exc.yovoads.com/get?id=1&token=12345678901234567890123456789012
</code>
==== Post params ====

<code>
test      int (default = 0) - если параметр есть и он больше ноля то тогда тестовый режим включен 
ruleID*   int - ID правила по которому показывается реклама (в нем "зашит" таргетинг)
bundle*   string - пакеджнейм приложения
adtype    int  - ad type тип рекламного блока
ver       string (default = "") - версия клиента
os*       string - операционная система клиента
osv       string (default = "") - версия операционной системы
h         int (default = 0) - высота экрана (максимальная по длине сторая является высотой)
w         int (default = 0) - ширина экрана
page      int (default = 0) - ориентация экрана  (0-"portrait"||1-"landscape")
lang      string (default = "EN") - Язык клиента
did*      string - Hardware device ID (e.g., IMEI);
gaid*     string - Platform device ID (e.g., Google Adv ID or iOS ID);
* -обязательные поля
</code>

==== RESPONSE ====

<code>
YovoAdID         string уникальный идентификатор рекламного блока
ClickURL         string ссылка по которой перейти после клика по рекламе
ScreenshotURLImg string ссылка на картинку (банер)
ShowTime         int - время показа баннера в секундах
Title            string - название баннера
Description      string - краткое описание 
IconURLImg       string ссылка на иконку (если пустая - imageonly показ)
ImgH             int - высота картинки в пикселях
ImgW             int - ширина картинки в пикселях

</code>


**Пример запроса**
<code>
POST http://exc.yovoads.com/get?id=1&token=12345678901234567890123456789012
POSTFORM
ruleID:1
bundle:com.test1.com
adtype:0
ver:1.01 beta
os:Android
osv:8.1
h:800
w:600
page:0
lang:RU
did:TEST_DEVICE_ID
gaid:TEST_GAID_4
</code>

**Пример ответа**

<code>
{
    "ad": {
        "AdID": "3_IPixEdrdBnNNBKPf",
        "ClickURL": "http://rd.yovoads.com/r?a=3_IPixEdrdBnNNBKPf",
        "ScreenshotURLImg": "http://banner3.jpg",
        "IconURLImg": "http://banner3.ico",
        "ShowTime": 30,
        "Title": "banner_3",
        "Description": "test description",
        "ImgH": 610,
        "ImgW": 298,
        "Error": ""
    },
    "error": ""
}
</code>