Информация по оплате донатов доступна на странице Информация для плательщиков.
Если вы администратор сообщества ВКонтакте — перед работой с приложением настоятельно рекомендуем полностью ознакомиться с содержимым этой страницы. При возникновении каких-либо вопросов обратитесь в нашу техподдержку.
Для подключения сервиса необходимо установить приложение в ваше сообщество, затем зайти в сообщество и открыть приложение по кнопке справа. После выполнения этих действий ваше сообщество будет зарегистрировано в нашей системе и вы сможете приступить к настройке.
Внимание! Первичную установку и настройку приложения необходимо производить с ПК. Из-за особенностей ВКонтакте виджет невозможно устанавливать в группу с мобильных устройств.
В настройках сообщества в разделе «Приложения» необходимо установить для пункта «видимость» значение «для всех пользователей» — это необходимо для того, чтобы все пользователи могли открыть приложение.
Такое же значение нужно установить для пункта «видимость виджета приложения» — это необходимо для того, чтобы виджет в группе видели все пользователи, а не только администраторы.
Настройки в сообществе
Панель управления
Панель управления приложением доступна для администраторов группы. В панели управления доступно несколько разделов, которые обозначены соответствующими иконками:
Страница оплаты состоит из трех основных блоков — формы оплаты, описания проекта и списка донатов.
В форме оплаты вы можете настроить следующие элементы:
Основной текст приложения. В тексте вы можете поприветствовать пользователя и вкратце рассказать, на что вы хотели бы собрать средства. В этом тексте можно использовать переменные и , которые будут автоматически заменены на имя и фамилию пользователя соответственно.
Текст в поле ввода сообщения отображается, если поле ввода пустое. Здесь можно написать что-то вроде «Напиши админу сообщение».
Вы можете задать текст кнопки оплаты, а также цвет этой кнопки и цвет текста в кнопке. Например, можно перекрасить кнопку в фирменные цвета вашего сообщества.
В разделе «Описание проекта» вы можете подробно рассказать пользователям о вашем сообществе и вашей деятельности. Вы можете задать до 10 различных блоков, в которых может содержаться обычный текст, картинка или видео с YouTube или ВК. Для вставки картинки необходимо указать URL изображения, размещенного ВКонтакте (ПКМ по картинке — копировать URL изображения). Для вставки видео достаточно просто указать ссылку на видео.
Виджет — это блок, который выводится непосредственно в группе. Для автоматического обновления виджета необходимо предоставить приложению доступ с помощью соответствующей кнопки в настройках.
В настройках вы можете выбрать один из трёх типов виджета:
Краудфандинг — в таком виджете можно указать цель сбора средств и вывести полоску прогресса, которая постепенно заполняется с поступлением новых донатов. При достижении целевой суммы полоска перекрасится в зелёный цвет.
Пример виджета «Краудфандинг»
Плитки — здесь выводятся большие аватарки донатеров, а также их имена, сообщение и сумма доната. При отсутствии донатеров будет выводиться аватарка вашей группы и указанный вами текст, например «Место свободно — занять место!». Такие приёмы повышают конверсию.
Пример виджета «Плитки»
Список — этот тип похож на «Плитки», но здесь можно вывести до 6 донатеров. Также в виджете «Список» можно вывести время, когда были сделаны донаты. Аватарки при таком типе виджета становятся меньше по размеру по сравнению с «Плитками». Кроме того, есть два типа списка — обычный и компактный. При компактном типе кнопка «оплатить» отображается справа от пункта списка, а текст сообщения обрезается до 100 символов. При обычном типе списка текст сообщения ограничивается длиной в 300 символов, а кнопка находится под этим текстом.
Пример виджета «Список»
После того, как вы оформите обложку для вашей группы в соответствии с шаблоном, сохраните её на ПК, а затем загрузите её в группу через настройки сообщества. После загрузки зайдите в панель управления в приложении, выберите раздел Настройка обложки и нажмите на базовую обложку для ее обновления. Теперь все новые донаты будут автоматически наноситься поверх этой обложки, а затем получившаяся картинка будет загружена в группу.
Кроме базовой обложки также необходимо получить ключ, чтобы обложка могла обновляться автоматически при поступлении новых донатов.
Если вы захотите изменить оформление фона обложки, нужно сначала загрузить новую обложку в группу, а затем в панели управления обновить базовую обложку. При обычном изменении настроек (изменение аватарок, шрифта или цветов) базовую обложку обновлять не требуется.
Пошаговая инструкция по настройке обложки
Типы обложек
Тип 1. На такую обложку может быть нанесено от 1 до 6 донатов. Донаты отображаются горизонтально, с большой аватаркой, именем и фамилией пользователя под ней. Вывод суммы доната можно отключить. Вы можете настроить:
Несколько примеров обложек первого типа (картинки кликабельны):
Тип 2. На такую обложку может быть нанесено от 1 до 3 донатов. В отличие от первого типа, здесь также будет выводиться сообщение от пользователя, если он его оставил. Несколько примеров обложки второго типа:
Вы можете использовать API сервиса в своих проектах. В целях безопасности следите, чтобы ваш ключ API не оказался в чужих руках.
Обращение к API осуществляется путём отправки POST или GET запроса по адресу https://api.vkdonate.ru. На запросы к API действует ограничение — не более одного запроса в секунду. В случае недоступности данного адреса попробуйте использовать альтернативный эндпоинт — https://vkdonate.ru/api
В запросе обязательно указывать параметр key — это ваш секретный ключ API. Вторым обязательным параметром является action — выполняемое действие. В зависимости от значения action необходимо передавать различные дополнительные параметры, как указано в таблице ниже.
Ответы от сервера приходят в формате JSON. Структура ответов также представлена в таблице ниже.
action
Описание
donates
Получение списка донатов для сообщества. Не более 50 донатов за один запрос.
Дополнительные параметры: count — количество донатов (от 1 до 50, по умолчанию 10) offset — смещение для поиска более ранних донатов (по умолчанию 0) sort — порядок сортировки донатов. Возможные значения — date (по дате), sum (по сумме доната). По умолчанию date. order — тип сортировки (asc — по возрастанию, desc — по убыванию). По умолчанию desc.
Сервер возвращает объект со следующими полями: count — общее количество донатов в вашем сообществе donates — массив объектов донатов. Каждый объект состоит из следующих полей: ‘id’ : уникальный ID платежа (целое число) ‘uid’ : VK ID донатера (целое число) ‘date’ : дата доната в формате YYYY-MM-DD HH:MM:SS (строка, время московское) ‘sum’ : сумма доната, целое число ‘msg’ : сообщение от пользователя ‘anon’ : если донат отправлен анонимно, то 1. Иначе 0. ‘visible’ : видимость доната в группе (меняется в панели управления). 0 или 1.
Пример запроса: https://api.vkdonate.ru?action=donates&count=20&sort=sum&key=.
В результате запроса вы получите объект с 20 донатами, отсортированными по сумме в порядке убывания.
Источник
Как настроить группы донатов
Этот гайд поможет вам подключить сервис DonationAlerts. С его помощью вы сможете:
Настроить личный кабинет DonationAlerts;
Установить OBS Studio;
Подключить уведомления о донатах к OBS Studio.
Как зарегистрироваться на DonationAlerts
Зарегистрироваться на DonationAlerts можно с помощью аккаунта Twitch, YouTube, Facebook, VK, Одноклассников, Smashcast, Mixer или Dailymotion:
Перейдите на сайт и нажмите «Начать использовать» на главной странице;
Выберите одну из платформ, через которую вы хотите зарегистрироваться;
Введите логин и пароль для авторизации и подтвердите доступ приложения DonationAlerts; Замечание: Лучше привязать к DonationAlerts дополнительную платформу для авторизации. Так, если вы утратите доступ к основному аккаунту (например, из-за временного бана), то все равно сможете получить доступ к нашему сервису. Сделать это можно в разделе «Основные настройки»;
Выберите имя пользователя. Оно будет использоваться в вашей ссылке на страницу с донатами. Идеально, если оно совпадает с вашим ником стримера.
Все получилось? Отлично, теперь давайте настроим ПО для стриминга.
Как настроить OBS Studio
О том, как настроить трансляцию с Android и iOS, читайте в отдельном гайде. Чтобы настроить ПО для захвата изображения и звука на ПК или Mac, нужно:
Перейти на сайт OBS Studio, выбрать операционную систему и скачать установщик;
Установить OBS Studio, лучше всего на самый объемный раздел жесткого диска;
Запустить мастер автоматической настройки, выбрать разрешение, привязать используемый сервис (Twitch/YouTube и т.д.); Замечание: Автонастройка проверит ваши аудио- и видеоустройства, скорость интернета и производительность компьютера;
В левом нижнем углу экрана создайте сцену и добавьте источник видео (игра/экран/окно);
Проверьте, все ли работает корректно, запустив запись или трансляцию на несколько минут.
Как связать OBS Studio и DonationAlerts
Чтобы донаты отображались на стриме, нужно подключить виджет DonationAlerts к OBS Studio. Делается это просто:
В разделе «Виджеты» выберите «Оповещения»;
Нажмите «Показать ссылку для встраивания» в разделе «Группа 1» и скопируйте ее;
В нижнем левом углу OBS Studio в разделе «Источники» добавляете «Браузер» и вставляете вашу ссылку в строку «Адрес URL»;
Теперь можно проверить, как уведомление будет отображаться у вас на стриме. Для этого в том же разделе сайта (виджет оповещений) нажмите на шестеренку и выберите «Сделать тестовое оповещение». Уведомление отобразится в OBS Studio. Замечание: Чтобы все уведомления отображались корректно, добавьте в OBS ссылку из Группы 1, даже если все ваши виджеты находятся в другой группе.
Как кастомизировать уведомления и настроить минимальную сумму доната
В разделе «Оповещения» вы можете:
Включить функцию «Синтез речи» и установить минимальный порог доната, при котором он будет работать;
Выбрать, где на экране вашей трансляции будет отображаться изображение и текст доната;
Выбрать одну из 34 готовых картинок или загрузить свою. Для этого в разделе «Изображения» нажмите на название файла справа от картинки. Рекомендуем использовать GIF или PNG изображения размером не более 4 Мб;
Настроить громкость оповещения, а также выбрать один из 16 пресетов или загрузить свой файл в разделе «Звук»;
Выбрать шрифт, настроить анимацию, цвет и другие параметры в разделе «Текст». В заголовке уведомления по умолчанию отображается имя донатера и размер пожертвования. Вы можете поменять их порядок или добавить в шаблон что-то от себя.
В разделе «Страница отправки сообщений» в настройках вы можете изменть:
Внешний вид страницы;
Размер сообщений;
Текст с информацией/приветствием для зрителей;
Минимальную сумму доната.
Как добавить топ донатов
Чтобы добавить топ донатов или другую информацию о стриме, откройте раздел «Внутристримовая статистика» и нажмите «Добавить новый виджет».
Замечание: В разделе «Основное» содержится техническая информация — название виджета, его описание и фон (не отображается, если вы стримите через OBS Studio).
На экран можно выводить топ донатеров или донатов, последние сообщения и другую информацию. Здесь же можно настроить, как будут отображаться эти данные (список, сторка, слайдер) и как будут выглядеть сообщения.
После того, как вы сохраните ваш виджет, его нужно добавить в OBS Studio. Для этого:
Скопируйте ссылку для встраивания;
В нижнем левом углу OBS Studio в разделе «Источники» добавьте «Браузер» и вставьте вашу ссылку в строку «Адрес URL».
Как добавить голосование
Вы можете сделать ваш стрим более интерактивным, запустив опрос. Для этого:
В разделе «Виджеты» выберите «Голосования»;
Задайте вопрос в названии голосования. Оно будет отображаться на стриме вместе с вариантами ответа;
Нажмите «Создать голосование».
Замечание: Голосование может считаться по количеству донатов (один донат, один голос) или по их размеру (больше денег, больше голосов). Также вы можете дать зрителям возможность добавлять свои варианты ответов. Они смогут сделать это на вашей странице отправки сообщений.
Как добавить цель на сбор средств
Виджет «Сбор средств» позволяет поставить поставить целью определенную сумму и отображать прогресс ее достижения на стриме. Для этого:
Нажмите «Добавить новую цель сбора»;
Добавьте заголовок, сумму и срок сбора средств;
Сохраните цель.
Теперь виджет нужно добавить в OBS Studio. Для этого:
Скопируйте ссылку для встраивания;
В нижнем левом углу OBS Studio в разделе «Источники» добавьте «Браузер» и вставьте вашу ссылку в строку «Адрес URL».
Готово! Теперь вы знаете о стриминге практически все.