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

Товари та сповіщення незалежні

Використовуйте Монетизація у SSN, щоб просувати публічні товари й сторінки підтримки, отримувати активність або робити обидва. Цей посібник охоплює Fourthwall, Ko-fi та Buy Me a Coffee. Для NinjaBacker, Throne, Amazon і eBay дивіться посібник із монетизації.

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

Підключіть сповіщення про активність

1. Відкрити Монетизація → Сповіщення Fourthwall, Ko-fi та Buy Me a Coffee і виберіть свого постачальника.
2. Натисніть Налаштування приймача. Увімкніть наявний віддалене керування розширенням через API перемикач, а потім залиште SSN увімкненим.
3. Поверніться до Monetization і натисніть Копіювати URL вебхука. Вставте цю приватну адресу в налаштування вебхука постачальника нижче.
4. Перевірте стан приймача. Приймач підключено означає, що SSN слухає, а не що налаштування постачальника перевірено. Рядок останньої події оновлюється, коли розібрана недубльована подія постачальника надходить до цього запущеного застосунку; після перезапуску він скидається.
5. Використовуйте Переглянути приклад сповіщення щоб перевірити вигляд на окремій сторінці прикладу. Це не надсилає платіж, не оновлює підсумки, не запускає Event Flow і не перевіряє доставку вебхука.

Ці три наявні кінцеві точки з URL сесії покладаються на таємність URL; поточне налаштування SSN не приймає їхні секрети підпису. Вони придатні для сповіщень трансляції, але не як доказ оплати для виконання замовлення. Не публікуйте адресу вебхука й не використовуйте її як ціль QR-коду для глядачів.

Fourthwall

1. У Fourthwall відкрийте Налаштування → Для розробників → Вебхуки.
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. Відкрити Інтеграції на панелі автора та виберіть Новий вебхук.
2. Дайте йому назву й вставте URL SSN для Buy Me a Coffee як кінцеву точку.
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 у розділі Налаштування → Для розробників, створіть Токен Storefront. Використовуйте токен Storefront для доступу до публічного каталогу, а не адміністративний ключ API.
2. У SSN відкрийте Товари та посилання підтримки → Налаштувати товари й посилання → Імпортувати товар 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. Відкрити Параметри посилання оверлею. Виберіть Product showcase, Support card, Activity alerts або комбінований вигляд.
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. Покупки не є підписками; більшість покупок не є донатами.
• Дублікати: не подавайте той самий платіж одночасно від прямого постачальника й агрегатора. Усунення дублікатів повторних доставок використовує ID доставки постачальника.
• Імпорт не вдався: перевірте ідентифікатор товару в URL, токен Storefront і те, що товар публічний та доступний. Ручне введення залишається доступним.

Це активність живої трансляції, а не реєстр замовлень. Для підтвердження оплати, повернень і виконання замовлень використовуйте панель постачальника. Shopify тепер має власне налаштування імпорту товарів і підписаних подій оплачених замовлень. Активність кампаній Tiltify і платне членство Patreon залишаються майбутніми інтеграціями.