Připojte svůj obchod. Ukažte své produkty.

Produkty a upozornění jsou samostatné

Použijte Zpeněžení (Monetization) v SSN pro propagaci veřejných produktů a stránek podpory, příjem aktivity nebo obojí. Tento průvodce se zabývá Fourthwall, Ko-fi a Buy Me a Coffee. Pro NinjaBacker, Throne, Amazon a eBay viz průvodce zpeněžením.

Připojte upozornění · Fourthwall · Ko-fi · Buy Me a Coffee · Importujte produkt · OBS a QR kódy · Řešení potíží

Připojte upozornění na aktivitu

1. Otevřít Zpeněžení → Upozornění Fourthwall, Ko-fi a Buy Me a Coffee (Monetization → Fourthwall, Ko-fi & Buy Me a Coffee alerts) a vyberte svého poskytovatele.
2. Klikněte na Nastavení přijímače. Zapněte stávající přepínač vzdálené ovládání rozšíření přes API (remote API control of extension) a poté nechte SSN zapnuté.
3. Vraťte se do části Zpeněžení (Monetization) a klikněte na Kopírovat URL webhooku. Vložte tuto soukromou adresu do níže uvedeného nastavení webhooku poskytovatele.
4. Zkontrolujte stav přijímače. Přijímač připojen znamená, že SSN naslouchá, nikoli že byla ověřena konfigurace poskytovatele. Řádek poslední události se aktualizuje, když tato spuštěná aplikace přijme zpracovanou, neduplicitní událost poskytovatele; při restartu se vynuluje.
5. Použijte Náhled ukázkového upozornění pro kontrolu vzhledu na samostatné ukázkové stránce. Neodešle se platba, neaktualizují se součty, nespustí se Event Flow ani se neověří doručení webhooku.

Tyto tři stávající koncové body s URL relace spoléhají na utajení URL; současné nastavení SSN nepodporuje jejich tajné klíče pro podepisování. Hodí se pro upozornění ve vysílání, nikoli jako doklad o zaplacení pro vyřízení objednávky. Adresu webhooku nezveřejňujte ani ji nepoužívejte jako cíl QR kódu pro diváky.

Fourthwall

1. Ve Fourthwall otevřete Nastavení → Pro vývojáře → Webhooky (Settings → For Developers → Webhooks).
2. Vytvořte webhook a vložte URL Fourthwall zkopírovanou z SSN.
3. Vyberte podporované události, které potřebujete: ORDER_PLACED, GIFT_PURCHASE, DONATION a SUBSCRIPTION_PURCHASED.
4. Uložte webhook a nechte SSN spuštěné.

Objednávky se zobrazují jako nákupy, darování produktů jako dárky a nová předplatná jako členství. Kvůli kompatibilitě běžné objednávky Fourthwall nadále nesou svou stávající hodnotu daru. Objednávky uplatňující dárkové karty znovu nepřičítají předplacenou hodnotu. Označené testovací události se přeskakují.

Dokumentace webhooků Fourthwall · Náhled ukázkového nákupu

Ko-fi

1. Otevřít Webhooky Ko-fi.
2. Vložte URL Ko-fi zkopírovanou z SSN do URL webhooku, potom jej uložte nebo aktualizujte.
3. Nechte SSN spuštěné. Veřejná spropitná, platby za členství, objednávky obchodu i zakázky používají stejné připojení.

Soukromé platby jsou vyloučeny. Platby za členství se zobrazují jako aktivita členství; objednávky obchodu a zakázky se zobrazují jako nákupy a nezvyšují součet darů. Ko-fi prostřednictvím tohoto webhooku neposkytuje oznámení o zrušení členství.

Testování: nejprve použijte oddělený ukázkový náhled SSN. Ukázkové platby Ko-fi mohou vypadat jako skutečné a při odeslání aktivnímu přijímači spustit upozornění, součty a akce. Test poskytovatele nepoužívejte v relaci se zapnutými placenými odměnami.

Dokumentace webhooků Ko-fi · Náhled ukázkové podpory

Buy Me a Coffee

1. Otevřít Integrace (Integrations) v řídicím panelu tvůrce a vyberte Nový webhook (New webhook).
2. Pojmenujte jej a jako koncový bod vložte URL SSN pro Buy Me a Coffee.
3. Vyberte donation.created, extra_purchase.created, commission_order.created, wishlist_payment.created a membership.started podle potřeby.
4. Uložte nastavení a ponechte doručování zapnuté. Při hledání příčin selhání použijte historii doručování událostí u poskytovatele.

Objednávky obchodu a zakázek jsou nákupy. Platby ze seznamu přání jsou příspěvky na dárky. Zahájení členství představuje oznámení o členství, nikoli samostatnou potvrzenou platbu. Skryté poznámky zůstávají skryté a anonymní podporovatelé zůstávají anonymní. Testy z řídicího panelu označené live_mode: false se přeskakují bez upozornění na platbu. Vrácení peněz a aktualizace životního cyklu nevytvářejí platby ani nesnižují stávající součty.

Dokumentace webhooků Buy Me a Coffee · Náhled ukázkového příspěvku

Importovat produkt z Fourthwall

1. V části Fourthwall Nastavení → Pro vývojáře (Settings → For Developers), vytvořte Token Storefront. Pro veřejný přístup ke katalogu použijte token Storefront, nikoli administrátorský klíč API.
2. V SSN otevřete Produkty a odkazy na podporu → Nastavit produkty a odkazy → Importovat produkt z Fourthwall (Products & support links → Set up products and links → Import a Fourthwall product).
3. Vložte veřejnou URL produktu a token, potom klikněte na Načíst podrobnosti produktu.
4. Zkontrolujte načtený název, obrázek, cenu a veřejnou URL. Ověřte, že URL patří stejnému obchodu jako token, a to i při použití vlastní domény. Token určuje, z katalogu kterého obchodu se načítá.
5. Vyberte Nákup (Shop), Dárek (Gift), Podpora (Support) nebo Členství (Join) podle toho, co budou diváci dělat. Klikněte na Přidat produkt nebo odkaz, zapněte Produkty a odkazy na podporu (Products & support links) a poté Uložit nastavení.

Tímto způsobem se přes Storefront API Fourthwall importuje vždy jeden dostupný veřejný produkt. Token se použije pro daný požadavek, poté se vymaže a neukládá se ani neodesílá do překryvů. Rozdílné ceny variant a ceny balíčků zůstávají prázdné, aby nenaznačovaly pevnou celkovou částku objednávky. Import je jednorázový snímek: ceny, zásoby a obrázky se automaticky neaktualizují. Při změně je znovu importujte nebo upravte. Katalog pojme až 20 položek; opětovné přidání vytvoří další položku.

Vytvořit token Storefront · Pole produktu Fourthwall

Zobrazujte produkty, veřejné odkazy a QR kódy

Veřejný odkaz na produkt nebo podporu můžete zadat i ručně z libovolného webu, včetně Shopify, Tiltify nebo Patreon. Přidejte URL obrázku a volitelnou cenu, vyberte účel, zapněte katalog a uložte jej. Přidání odkazu nepřipojí zdroj plateb.

1. Vyberte Produkty a odkazy na podporu (Products & support links) v nabídce Odkaz na překryv pro.
2. Otevřít Možnosti odkazu na překryv. Vyberte Produktová prezentace (Product showcase), Karta podpory (Support card), Upozornění na aktivitu (Activity alerts) nebo kombinované zobrazení.
3. Klikněte na Kopírovat odkaz pro OBS a vložte jej do zdroje Prohlížeč v OBS. Začněte s rozlišením 800 × 600. Pro samostatné propagační vrstvy a vrstvy aktivity vytvořte zdroj pro každé zobrazení.
4. V Možnostech zobrazení (Display options) připněte první produkt nebo nastavte střídání položek. Zapněte QR kódy, aby diváci mohli naskenovat veřejnou cílovou adresu. Použijte Kopírovat veřejný odkaz vedle položky a sami sdílejte její klikací adresu v chatu.

Prezentace obsahuje obrázek produktu, pokud je k dispozici; menší karta podpory jej skrývá. Upozornění na aktivitu fungují nezávisle a nepřipojují QR kód nesouvisejícího produktu z rotace. Veřejný odkaz udržujte čitelný a QR kód vyzkoušejte telefonem při zobrazení finálního rozvržení OBS. Změna měřítka odkazu OBS nebo příliš těsný ořez mohou skenování ztížit.

Pro multi-alerts nebo přehled aktivity použijte jejich stávající odkazy na překryvy se stejnou relací SSN. Pro tyto stávající překryvy aktivity není nutné mít zapnutý katalog produktů. Obecné zobrazení aktivity v části Zpeněžení (Monetization) vyžaduje zapnutý katalog. V Event Flow zůstává Dar (Donation) spouštěčem pro řádky s hasDonation; pro nákupy nebo dokončení dárku použijte Typ události (Event Type). Viz mapování událostí.

Pokud se nic nezobrazuje

• Přijímač vypnutý: zapněte vzdálené ovládání rozšíření přes API. Ostatní přepínače API slouží k jiným účelům.
• Odpojeno: nechte SSN zapnuté a zkontrolujte přístup k síti. Tento stav označuje sdílené připojení přijímače, nikoli stav doručování v řídicím panelu poskytovatele.
• Nebyla přijata žádná událost: zkontrolujte vybraného poskytovatele, soukromou URL a nastavení doručování u poskytovatele. Úspěšný místní náhled ověřuje pouze vzhled.
• Událost přeskočena: označené testy, soukromé platby, nepodporované typy událostí nebo neplatné částky jsou vyloučeny. Ve stavu se nezobrazují žádné údaje kupujících.
• Událost přijata, ale překryv se nezobrazuje: zkontrolujte relaci/heslo, filtry zdrojů, kategorie událostí, pravidla SSN a viditelnost OBS. Nákupy nejsou předplatné; většina nákupů nejsou dary.
• Duplicity: nepřivádějte stejnou platbu současně přímo od poskytovatele i přes agregátor. Odstranění duplicit při opakovaném doručení používá ID doručení poskytovatele.
• Import selhal: zkontrolujte identifikátor produktu v URL a token Storefront a ověřte, že je produkt veřejný a dostupný. Ruční zadání je nadále k dispozici.

Jde o aktivitu živého vysílání, nikoli evidenci objednávek. Pro potvrzení plateb, vrácení peněz a vyřízení objednávek používejte řídicí panel poskytovatele. Shopify nyní nabízí vlastní import produktů a nastavení podepsaných událostí zaplacených objednávek. Aktivita kampaní Tiltify a placená členství Patreon zůstávají plánovanými integracemi.