Интеграция через JS SDK

JS SDK это JavaScript библиотека которая упрощает интеграцию сервиса баннеров на сайт продукта.

Установка

В шаблон HTML страницы подключите внешний скрипт

<script src="https://cdn.np.plat.services/js/pb.min.js"></script>

После этого для инициализации скрипта вставьте следующий JavaScript код

PB.init({
    url: 'https://np.plat.services',
});

В нужных местах ваших страниц вставьте плейсхолдеры с ID ваших промо

<div class="pb" data-id="9ecd23c0-ef8b-487e-b8c2-86fe95971108"></div>

Где data-id обязательный аттрибут который должен содердать ID нужного вам Promo

Класс pb является классом по умолчанию для поиска на странице всех промо, его можно изменить на другой, указав при этом имя класса при инициализации SDK

PB.init({
    url: 'https://np.plat.services',
    className: 'custom',
});

Не рекоммендуется для имен классов использовать слова которые явно обозначают баннеры или рекламу (например: banner, adv, advertise и т.п.), так как такие элементы могут быть заблокированы блокировщиками рекламы.

Параметры инициализации SDK

PB.init({
    url: 'https://np.plat.services',
    className: 'pb',
    breakpoint: null,
    userId: '12345',
    tags: {
        path: '/special'
    },
});

• url - обязательный параметр с адресом интеграции, выдается при подключении к баннерной системе платформы (в данный момент использовать тот что указан в этой документации)

• className - класс плейсхолдеров промо, по умолчанию - pb

• breakpoint - при указании этого параметры будут подгружаться картинки только с указанным брекпоинтом

• userId - ID пользователя в вашей системе, если не указан, то сгенерируется случайный UUID для текущей сессии. Используется в собираемых метриках показа баннеров.

• tags - key - values значения для баннеров у которых заданы контексты