Разработчикам

С ЧЕГО НАЧАТЬ

Подключаем скрипт плеера в то место на сайте, где вы хотите, чтобы загружался плеер, заменив %SITE_ID% на идентификатор площадки:

<div id="___seedrPlayerContainer" data-gid="%SITE_ID%"></div>
<script type="text/javascript">
    (function (a, b, c, d, e, f, g, h) {
        g = b.createElement(c);
        g.src = d;
        g.type = "application/javascript";
        g.async = !0;
        h = b.getElementsByTagName(c)[0];
        h.parentNode.insertBefore(g, h);
        a[f] = [];
        a[e] = function () {
        a[f].push(Array.prototype.slice.apply(arguments));
    }
}) (window, document, "script", (document.location.protocol === "https:" ? "https:"
: "http:") + "//cdn01.seedr.com/js/seedr-player.min.js", "SeedrPlayer", "seedrInit");
</script>

Код требуется установить на площадку только один раз. Он автоматически показывает видео из кампании, в которой вы участвуете. Управление ведется через личный кабинет паблишера Seedr. Если вы участвуете в нескольких кампаниях одновременно, приоритет отдается кампании с наибольшей ценой за просмотр. Если вы не участвуете ни в одной кампании, то плеер показываться не будет, пока вы не присоединитесь хотя бы к одной.

ЧАСТОТА ПОКАЗА

Если пользователь уже посмотрел ролик, второй раз он ему не покажется. Используйте fallback onSeedrPlayerAPINoLoaded, чтобы показать другую рекламу либо основной контент.

ТАРГЕТИНГ

В кампании может быть установлен гео таргетинг или таргетинг по полу, возрасту или другим аудиторным сегментам. Реклама может не показываться конкретному пользователю. Используйте fallback onSeedrPlayerAPINoLoaded, чтобы показать другую рекламу либо основной контент.

ФОРМАТ РЕКОМЕНДУЕМОЕ ВИДЕО

Видео ставится в контенте под статьей или в теле статьи. Запускается пользователем по клику. Формат подходит почти всем, наиболее высокий заработок гарантируется, если плеер ставится в тело текстового контента. Для установки формата требуется только поставить код в необходимое место.

ФОРМАТ IN-STREAM

Этот формат подойдет вам, если у вас есть видеоконтент в вашем плеере. Пользователь нажимает на кнопку воспроизведения в вашем плеере, ему показывается рекламное видео. Запускается по клику. Он может либо пропустить рекламу, либо досмотреть до конца, после чего автоматически запускается основное видео. Реализовать этот формат можно или через запрос VAST тега (если ваш плеер поддерживает JS VPAID), либо самостоятельно.

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

Если ваш плеер поддерживает JS VPAID, то получить ваш VAST тег можно по ссылке https://stats.seedr.com/group/%SITE_ID%/vast?surl=[referer_url], где [referer_url] — URL-адрес страницы (url-encoded), на которой воспроизводится видео. В свою очередь тег подгрузит VPAID креатив. В данном случае устанавливать код на страницу не нужно.

Самостоятельная реализация

После то того, как пользователь нажал кнопку play в вашем плеере, вы запускаете код Seedr, таким образом чтобы элемент ___seedrPlayerContainer оказался в том же контейнере, что и ваш основной плеер, но поверх него.

Если вызывается callback onSeedrPlayerAPINoLoaded, значит для текущего пользователя доступных кампаний нет, и вы можете либо показать другую рекламу, либо запустить показ основного контента.

Если вызывается onSeedrPLayerAPIReady, значит плеер загрузился и готов к просмотру.

Если вы хотите, чтобы рекламный плеер сам показывал кнопку пропустить, укажите параметр конфигурации. Кнопка «Пропустить» может появиться сразу или спустя несколько секунд после начала воспроизведения видео (максимум 20) в зависимости от настроек кампании.

<script>
    seedrPlayer = {
        skipControl : true
    }
</script>

Если пользователь успешно пропустил рекламу, сработает callback:

function onSeedrPlayerAPIAdSkipped () {
    // нужно начать воспроизведение основного видео
}

Кнопку «Пропустить» можно показывать и свою, в этом случае не устанавливайте skipControl: true. Когда будет возможен показ кнопки, сработает callback:

function onSeedrPlayerAPIAdSkippableStateChange (player) {
    console.log('SKIP READY, player);
    if ( player.getAdSkippableState()) {
        // кнопку нужно показать
    } else {
        // кнопку нужно убрать
    }
}

Когда пользователь нажимает на вашу кнопку «Пропустить», нужно вызвать player.skipAd(). «Пропускать» рекламу следует только с помощью этого метода.

Если пользователь успешно пропустил рекламу, сработает callback:

function onSeedrPlayerAPIAdSkipped () {
    // нужно начать воспроизведение основного видео
}

Если пользователь досмотрел рекламу до конца, сработает callback:

function onSeedrPlayerAPIComplete () {
    // нужно начать воспроизведение основного видео
}

КОНФИГУРАЦИЯ ПЛЕЕРА

Перед кодом плеера можно указать параметры, с которым он будет создан и указать колбэки на события следующим образом:

<script>
    seedrPlayer = {
        width: 480,
        height: 360
    }
</script>

Параметры

width
Тип: int
Ширина плеера в пикселах.
По умолчанию: 640

height
Тип: int
Высота плеера в пикселах.
По умолчанию: 390

mode
Тип: string
mode: "fillParent" используется, чтобы плеер динамически заполнял весь предоставленный ему родительским элементом размер.

skipControl
Тип: boolean
Опция skipControl указывает плееру на то, что у пользователя будет возможность пропустить рекламу. Кнопка «Пропустить» может появиться сразу или спустя несколько секунд после начала воспроизведения видео (максимум 20) в зависимости от настроек кампании.
По умолчанию: false

debug
Тип: boolean
Позволяет загружать демо-кампанию всегда. Используется для настройки показа плеера и отладки.
По умолчанию: false

Доступные javascript колбэки:

onSeedrPLayerAPIReady(player)
Тип: function
Срабатывает когда плеер загрузился и готов к просмотру. В параметре передается ссылка на экземляр плеера.

onSeedrPlayerAPIPlay
Тип: function
Срабатывает при старте видео.

onSeedrPlayerAPIComplete
Тип: function
Срабатывает при завершении просмотра.

onSeedrPlayerAPINoLoaded
Тип: function
Срабатывает, если видео не загрузилось по каким-либо причинам. Например, нет доступных кампаний.

onSeedrPlayerAPIAdSkippableStateChange(player)
Тип: function
Срабатывает, когда разрешен показ кнопки «Пропустить».

onSeedrPlayerAPIAdSkipped
Тип: function
Срабатывает, когда пользователь пропустил рекламу.

Почему не засчитываются просмотры?

Убедитесь, что домен, на котором размещается плеер совпадает с доменом сайта, который был указан при добавлении новой площадки в Сидр.

Убедитесь, что кампания активна.

Напишите на support@seedr.ru