Native SDK
From Справочник сервиса Kadam.net
Native SDK отличается от прочих форматов тем, что владелец сайта сам занимается размещением и отображением рекламного блока на странице.
Contents
Установка
Для использования Native SDK необходимо подключить библиотеку на сайт, разместив код вызова библиотеки в блоке <head> Вашего сайта, а также установить переменную с рекламным доменом.
<head>
<script>
var kdmDomain = 'hdbcode.com';
</script>
<script src="https://hdbcode.com/abcdef.js"></script>
</head>
Использование
После подключения SDK станет доступен вызов функции для получения списка рекламных объявлений window.getKdm(options)
Описание объекта options
| Название параметра | Тип данных | Описание | Примечания | Необходимость |
|---|---|---|---|---|
| blockId | integer | ID рекламного блока | Можно получить в интерфейсе рекламного кабинета | Обязательно |
| imgWidth | integer | Высота картинки | Обязательно | |
| imgHeight | integer | Ширина картинки | Обязательно | |
| amount | integer | Сколько надо вернуть рекламных предложений | По умолчанию равен 1 | Необязательно |
| showAdDescription | boolean | Присылать или нет описание рекламы | По умолчанию false | Необязательно |
| subDomains | integer | Сколько поддоменов (без учёта домена верхнего уровня) оставлять в location.host и location.href при отправке на сервер параметров domain и page | По умолчанию равен 0. Доменное имя sub2.sub1.test.com при subDomains=1 превратится в test.com; при subDomains=2 — в sub1.test.com | Необязательно |
| callback | Function([Object]) | Функция, которая будет вызвана после получения ответа с сервера | В аргумент функции передаётся массив с объектами, содержащими рекламные материалы (см. описание ниже) | Обязательно |
Пример получения рекламных материалов
window.getKdm({
blockId: 311785,
amount: 1,
imgWidth: 200,
imgHeight: 250,
showAdDescription: true,
callback: function(data) {
console.log(data);
}
});
Описание параметров объекта рекламного материала
После отправки запроса ответ будет передан в функцию callback, в качестве аргумента передается массив рекламных материалов.
| Название параметра | Тип данных | Описание | Примечания | Необходимость |
|---|---|---|---|---|
| description | string | Описание рекламы | Необязательно | |
| title | string | Заголовок | Обязательно | |
| image | URL | URL картинки | Обязательно | |
| url | url | URL клика | Обязательно | |
| calcCpm | float | Расчетный CPM | Расчетная стоимость 1000 показов этого материала | Обязательно |
| cpcCost | float | Стоимость клика | Обязательно | |
| payMode | integer | 0 — CPC; 2 — CPM; 4 — CPATarget | Обязательно | |
| cur | string | Валюты оплаты | USD | Обязательно |
| campaignID | integer | Обязательно | ||
| adID | integer | Обязательно | ||
| notificationFunction | Function(void) | Функция, которую надо вызвать на показе рекламы (или на попадании рекламы в видимую область) | Стоит использовать только если не подходит функция notify | Обязательно |
| nofity | Function(Object) | Функция, которая автоматически отстучится о показе рекламы после попадания её в область видимости в течении указанного времени | Если условия отстука сложнее, можно самостоятельно реализовать их и отстучаться о показе с помощью notificationFunction | Обязательно |
| target | HTMLElement | Ссылка на DOM-элемент с креативом | Обязательно | |
| delay | integer | Сколько миллисекунд рекламный материал должен находиться в видимой области | По умолчанию равен 1000 | Необязательно |
| visibilityPercent | integer | Какой процент рекламного материала должен находиться в видимой области | По умолчанию равен 50 | Необязательно |
