Подключите магазин. Покажите товары.

Товары и уведомления работают отдельно

Используйте Монетизация в SSN, чтобы продвигать публичные товары и страницы поддержки, получать активность или делать и то и другое. Это руководство охватывает Fourthwall, Ko-fi и Buy Me a Coffee. Для NinjaBacker, Throne, Amazon и eBay см. руководство по монетизации.

Подключить уведомления · Fourthwall · Ko-fi · Buy Me a Coffee · Импортировать товар · OBS и QR-коды · Устранение неполадок

Подключение уведомлений об активности

1. Открыть Monetization → Fourthwall, Ko-fi & Buy Me a Coffee alerts («Монетизация → Уведомления Fourthwall, Ko-fi и Buy Me a Coffee») и выберите провайдера.
2. Нажмите Настройка приёмника. Включите существующий переключатель удалённое управление расширением через API , затем оставьте SSN включённым.
3. Вернитесь в раздел Monetization и нажмите Копировать URL вебхука. Вставьте этот приватный адрес в настройки вебхука провайдера, описанные ниже.
4. Проверьте состояние приёмника. Приёмник подключён означает, что SSN ожидает события, а не что настройка провайдера проверена. Строка последнего события обновляется, когда это работающее приложение получает разобранное неповторное событие провайдера; после перезапуска она сбрасывается.
5. Используйте Предпросмотр примера уведомления чтобы проверить внешний вид на отдельной странице примера. Это не отправляет платёж, не меняет суммы, не запускает Event Flow и не проверяет доставку вебхука.

Эти три существующих адреса с URL сеанса полагаются на его конфиденциальность; текущая настройка SSN не принимает их секреты подписи. Они подходят для уведомлений трансляции, но не служат доказательством оплаты для исполнения заказа. Не публикуйте адрес вебхука и не используйте его как адрес QR-кода для зрителей.

Fourthwall

1. В Fourthwall откройте Settings → For Developers → Webhooks («Настройки → Для разработчиков → Вебхуки»).
2. Создайте вебхук и вставьте URL Fourthwall, скопированный из SSN.
3. Выберите нужные поддерживаемые события: ORDER_PLACED, GIFT_PURCHASE, DONATION и SUBSCRIPTION_PURCHASED.
4. Сохраните вебхук и оставьте SSN работающим.

Заказы отображаются как покупки, подаренные товары — как подарки, новые подписки — как платные подписки. Для совместимости обычные заказы Fourthwall по-прежнему несут своё существующее значение пожертвования. Заказы с погашением подарочной карты не добавляют предоплаченную сумму повторно. Помеченные тестовые события пропускаются.

Документация вебхуков Fourthwall · Предпросмотр примера покупки

Ko-fi

1. Открыть Вебхуки Ko-fi.
2. Вставьте URL Ko-fi, скопированный из SSN, в URL вебхука, затем сохраните или обновите запись.
3. Оставьте SSN работающим. Публичные чаевые, оплата подписок, заказы магазина и индивидуальные заказы используют одно подключение.

Приватные платежи исключаются. Оплата подписок отображается как активность подписок; заказы магазина и индивидуальные заказы — как покупки без увеличения суммы пожертвований. Ko-fi не передаёт через этот вебхук уведомления об отмене подписки.

Проверка: сначала используйте изолированный предпросмотр примера SSN. Тестовые платежи Ko-fi могут выглядеть как настоящие и запускать уведомления, подсчёт сумм и действия, если отправлены активному приёмнику. Не используйте тест провайдера в сеансе с включёнными платными наградами.

Документация вебхуков Ko-fi · Предпросмотр примера поддержки

Buy Me a Coffee

1. Открыть Интеграции в панели автора и выберите New webhook («Новый вебхук»).
2. Дайте ему имя и вставьте URL Buy Me a Coffee из SSN в качестве конечной точки.
3. Выберите donation.created, extra_purchase.created, commission_order.created, wishlist_payment.created и membership.started по необходимости.
4. Сохраните и оставьте доставку включённой. Для поиска ошибок используйте историю доставки событий провайдера.

Заказы магазина и индивидуальные заказы считаются покупками. Платежи по списку желаний — взносами на подарки. Начало подписки — объявление о подписке, а не отдельное подтверждённое списание. Скрытые заметки остаются скрытыми, а анонимные сторонники — анонимными. Тесты из панели управления с меткой live_mode: false пропускаются без платных уведомлений. Возвраты и обновления жизненного цикла не создают платежи и не уменьшают существующие итоговые суммы.

Документация вебхуков Buy Me a Coffee · Предпросмотр примера взноса

Импортировать товар Fourthwall

1. В разделе Fourthwall Settings → For Developers («Настройки → Для разработчиков»), создайте Токен Storefront. Для доступа к публичному каталогу используйте токен витрины, а не административный API-ключ.
2. В SSN откройте Products & support links → Set up products and links → Import a Fourthwall product («Товары и ссылки поддержки → Настроить товары и ссылки → Импортировать товар Fourthwall»).
3. Вставьте публичный URL товара и токен, затем нажмите Загрузить данные товара.
4. Проверьте загруженные название, изображение, цену и публичный URL. Убедитесь, что URL относится к тому же магазину, что и токен, включая собственный домен. Токен определяет, каталог какого магазина запрашивается.
5. Выберите Shop, Gift, Support или Join («Купить», «Подарить», «Поддержать» или «Присоединиться»), чтобы указать действие зрителей. Нажмите Добавить товар или ссылку, включите Products & support links («Товары и ссылки поддержки»), затем Сохранить настройку.

Импорт получает по одному доступному публичному товару через Storefront API Fourthwall. Токен используется для этого запроса, затем очищается; он не сохраняется и не отправляется оверлеям. При разных ценах вариантов и комплектов цена остаётся пустой, чтобы не создавать впечатление фиксированной суммы покупки. Импорт — это снимок: цены, остатки и изображения не обновляются автоматически. Повторите импорт или измените данные при их обновлении. Каталог вмещает до 20 записей; повторное добавление создаёт ещё одну запись.

Создайте токен Storefront · Поля товара Fourthwall

Показ товаров, публичных ссылок и QR-кодов

Вы также можете вручную добавить публичную ссылку на товар или поддержку с любого сайта, включая Shopify, Tiltify и Patreon. Добавьте URL изображения и необязательную цену, выберите назначение, включите каталог и сохраните. Добавление ссылки не подключает поток платежей.

1. Выберите Товары и ссылки поддержки в разделе Ссылка оверлея для.
2. Открыть Параметры ссылки оверлея. Выберите витрину товара, карточку поддержки, уведомления об активности или объединённый вид.
3. Нажмите Копировать ссылку OBS и вставьте её в источник «Браузер» OBS. Начните с размера 800 × 600. Для раздельных слоёв рекламы и активности создайте источник для каждого представления.
4. В Display options закрепите первый товар или включите смену записей. Включите QR-коды, чтобы зрители могли сканировать публичный адрес. Используйте Копировать публичную ссылку рядом с записью, чтобы самостоятельно отправить её кликабельный адрес в чат.

Витрина показывает изображение товара, если оно задано; меньшая карточка поддержки скрывает его. Уведомления об активности работают независимо и не добавляют QR-код несвязанного сменяющегося товара. Сохраняйте публичную ссылку читаемой и проверьте QR-код телефоном в итоговом макете OBS. Изменение масштаба ссылки OBS или слишком тесная обрезка могут затруднить сканирование.

Для Multi-Alerts или ленты активности используйте их существующие ссылки оверлеев с тем же сеансом SSN. Этим оверлеям активности не требуется включённый каталог товаров. Общему представлению активности Monetization каталог необходим. В Event Flow триггер Donation по-прежнему применяется к строкам с hasDonation; для покупок или завершения подарка используйте Event Type. См. сопоставление событий.

Если ничего не появляется

• Приёмник выключен: включите удалённое управление расширением через API. Другие переключатели API служат другим задачам.
• Отключено: оставьте SSN включённым и проверьте доступ к сети. Этот статус относится к общему подключению приёмника, а не к состоянию доставки в панели провайдера.
• Событие не получено: проверьте выбранного провайдера, приватный URL и настройки доставки провайдера. Успешный локальный предпросмотр проверяет только внешний вид.
• Событие пропущено: помеченные тесты, приватные платежи, неподдерживаемые типы событий и недопустимые суммы исключаются. В состоянии не показываются сведения о покупателе.
• Событие получено, но оверлей не появился: проверьте сеанс и пароль, фильтры источников, категории событий, правила SSN и видимость в OBS. Покупки не являются подписками; большинство покупок не являются пожертвованиями.
• Дубликаты: не передавайте один платёж одновременно через прямое подключение провайдера и агрегатор. Устранение повторных доставок использует идентификаторы доставки провайдера.
• Ошибка импорта: проверьте идентификатор товара в URL и токен Storefront, а также публичность и доступность товара. Ручной ввод остаётся доступным.

Это активность трансляции, а не журнал заказов. Для подтверждения оплаты, возвратов и исполнения заказов используйте панель провайдера. У Shopify теперь есть отдельная настройка импорта товаров и подписанных событий оплаченных заказов. Активность кампаний Tiltify и платные подписки Patreon пока остаются будущими интеграциями.