Verbinde deinen Shop. Zeige deine Produkte.

Produkte und Meldungen sind getrennt

Verwende Monetarisierung in SSN, um öffentliche Produkte und Unterstützungsseiten zu bewerben, Aktivität zu empfangen oder beides zu tun. Dieser Leitfaden behandelt Fourthwall, Ko-fi und Buy Me a Coffee. Für NinjaBacker, Throne, Amazon und eBay siehe den Monetarisierungsleitfaden.

Meldungen verbinden · Fourthwall · Ko-fi · Buy Me a Coffee · Ein Produkt importieren · OBS und QR-Codes · Fehlerbehebung

Aktivitätsmeldungen verbinden

1. Öffnen Monetarisierung → Fourthwall-, Ko-fi- & Buy-Me-a-Coffee-Meldungen und wähle deinen Anbieter.
2. Klicke auf Empfängereinstellung. Aktiviere den vorhandenen Fernsteuerung der Erweiterung über API (remote API control of extension) Schalter, und lass SSN dann eingeschaltet.
3. Kehre zu Monetarisierung zurück und klicke auf Webhook-URL kopieren. Füge diese private Adresse unten in die Webhook-Einstellungen deines Anbieters ein.
4. Prüfe den Empfängerstatus. Empfänger verbunden bedeutet, dass SSN empfängt, nicht dass deine Anbieterkonfiguration geprüft wurde. Die Zeile zum letzten Ereignis wird aktualisiert, wenn ein verarbeitetes, nicht doppeltes Anbieterereignis diese laufende App erreicht; sie wird beim Neustart zurückgesetzt.
5. Verwende Beispielmeldung ansehen um das Aussehen auf einer separaten Beispielseite zu prüfen. Dabei wird keine Zahlung gesendet, keine Summe aktualisiert, kein Event Flow ausgeführt und keine Webhook-Zustellung geprüft.

Diese drei bestehenden Endpunkte mit Sitzungs-URL setzen voraus, dass die URL geheim bleibt; SSNs aktuelle Einrichtung nimmt deren Signaturschlüssel nicht entgegen. Sie eignen sich für Stream-Meldungen, nicht als Zahlungsnachweis für die Bestellabwicklung. Veröffentliche die Webhook-Adresse nicht und verwende sie nicht als QR-Ziel für Zuschauer.

Fourthwall

1. Öffne in Fourthwall Settings → For Developers → Webhooks.
2. Erstelle einen Webhook und füge die aus SSN kopierte Fourthwall-URL ein.
3. Wähle die benötigten unterstützten Ereignisse aus: ORDER_PLACED, GIFT_PURCHASE, DONATION und SUBSCRIPTION_PURCHASED.
4. Speichere den Webhook und lass SSN laufen.

Bestellungen erscheinen als Käufe, Produktgeschenke als Geschenke und neue Abonnements als Mitgliedschaften. Aus Kompatibilitätsgründen enthalten normale Fourthwall-Bestellungen weiterhin ihren bisherigen Spendenwert. Bestellungen mit eingelösten Geschenkkarten addieren den vorausbezahlten Wert nicht erneut. Markierte Testereignisse werden übersprungen.

Fourthwall-Webhook-Dokumentation · Beispielkauf ansehen

Ko-fi

1. Öffnen Ko-fi-Webhooks.
2. Füge die aus SSN kopierte Ko-fi-URL in Webhook-URL, und speichere/aktualisiere ihn.
3. Lass SSN laufen. Öffentliche Trinkgelder, Mitgliedschaftszahlungen, Shop-Bestellungen und Auftragsarbeiten verwenden dieselbe Verbindung.

Private Zahlungen sind ausgeschlossen. Mitgliedschaftszahlungen erscheinen als Mitgliedschaftsaktivität; Shop-Bestellungen und Auftragsarbeiten erscheinen als Käufe, ohne Spendensummen zu erhöhen. Ko-fi liefert über diesen Webhook keine Benachrichtigungen über gekündigte Mitgliedschaften.

Testen: verwende zuerst SSNs isolierte Beispielvorschau. Ko-fi-Beispielzahlungen können echten Zahlungen ähneln und Meldungen, Summen und Aktionen auslösen, wenn sie an den aktiven Empfänger gesendet werden. Verwende den Anbietertest nicht in einer Sitzung mit aktivierten bezahlten Belohnungen.

Ko-fi-Webhook-Dokumentation · Beispielunterstützung ansehen

Buy Me a Coffee

1. Öffnen Integrationen im Creator-Dashboard und wähle Neuer Webhook.
2. Gib ihm einen Namen und füge die SSN-URL für Buy Me a Coffee als Endpunkt ein.
3. Auswählen donation.created, extra_purchase.created, commission_order.created, wishlist_payment.created und membership.started nach Bedarf.
4. Speichere und lass die Zustellung aktiviert. Verwende den Ereignis-Zustellverlauf des Anbieters zur Fehlersuche.

Shop-Bestellungen und Auftragsarbeiten sind Käufe. Wunschlistenzahlungen sind Geschenkbeiträge. Der Beginn einer Mitgliedschaft ist eine Mitgliedschaftsankündigung, keine separat bestätigte Abbuchung. Verborgene Notizen bleiben verborgen und anonyme Unterstützer anonym. Dashboard-Tests mit der Kennzeichnung live_mode: false werden ohne bezahlte Meldungen übersprungen. Erstattungen und Statusaktualisierungen erzeugen keine Zahlungen und machen bestehende Summen nicht rückgängig.

Buy-Me-a-Coffee-Webhook-Dokumentation · Beispielbeitrag ansehen

Ein Fourthwall-Produkt importieren

1. In Fourthwalls Settings → For Developers, erstelle einen Storefront-Token. Verwende das Storefront-Token für den öffentlichen Katalogzugriff, keinen administrativen API-Schlüssel.
2. Öffne in SSN Produkte & Unterstützungslinks → Produkte und Links einrichten → Ein Fourthwall-Produkt importieren.
3. Füge die öffentliche Produkt-URL und das Token ein und klicke dann auf Produktdetails laden.
4. Prüfe geladenen Namen, Bild, Preis und öffentliche URL. Stelle sicher, dass die URL zum selben Shop gehört wie das Token, einschließlich einer eventuellen eigenen Domain. Das Token bestimmt, welcher Shop-Katalog abgefragt wird.
5. Wähle Shop, Gift, Support oder Join, um zu beschreiben, was Zuschauer tun werden. Klicke auf Produkt oder Link hinzufügen, aktiviere „Products & support links“, dann Einrichtung speichern.

Damit wird jeweils ein verfügbares öffentliches Produkt über Fourthwalls Storefront API importiert. Das Token wird für diese Anfrage verwendet, danach gelöscht und weder gespeichert noch an Overlays gesendet. Unterschiedliche Varianten- und Paketpreise bleiben leer, damit kein fester Endpreis suggeriert wird. Der Import ist eine Momentaufnahme: Preise, Bestand und Bilder aktualisieren sich nicht automatisch. Importiere erneut oder bearbeite sie bei Änderungen. Der Katalog fasst bis zu 20 Einträge; erneutes Hinzufügen erzeugt einen weiteren Eintrag.

Ein Storefront-Token erstellen · Fourthwall-Produktfelder

Produkte, öffentliche Links und QR-Codes anzeigen

Du kannst auch einen öffentlichen Produkt- oder Unterstützungslink von beliebigen Websites manuell eingeben, einschließlich Shopify, Tiltify oder Patreon. Füge eine Bild-URL und optional einen Preis hinzu, wähle den Zweck, aktiviere den Katalog und speichere. Das Hinzufügen eines Links verbindet keinen Zahlungsfeed.

1. Wähle Produkte & Unterstützungslinks unter Overlay-Link für.
2. Öffnen Overlay-Link-Optionen. Wähle Produktpräsentation, Unterstützungskarte, Aktivitätsmeldungen oder die kombinierte Ansicht.
3. Klicke auf OBS-Link kopieren und füge ihn in eine OBS-Browserquelle ein. Beginne mit 800 × 600. Erstelle für getrennte Werbe- und Aktivitätsebenen je eine Quelle pro Ansicht.
4. Verwende die Anzeigeoptionen, um das erste Produkt fest anzuzeigen oder Einträge rotieren zu lassen. Aktiviere QR-Codes, damit Zuschauer das öffentliche Ziel scannen können. Verwende Öffentlichen Link kopieren neben einem Eintrag, um seine anklickbare Adresse selbst im Chat zu teilen.

Die Produktpräsentation enthält das Produktbild, wenn vorhanden; die kleinere Unterstützungskarte blendet es aus. Aktivitätsmeldungen funktionieren unabhängig und hängen keinen QR-Code eines gerade rotierenden, unzugehörigen Produkts an. Halte den öffentlichen Link lesbar und teste den QR-Code mit einem Handy in deinem endgültigen OBS-Layout. Eine geänderte Skalierung des OBS-Links oder zu enger Zuschnitt kann das Scannen erschweren.

Verwende für multi-alerts oder den Aktivitätsfeed deren vorhandene Overlay-Links mit derselben SSN-Sitzung. Für diese bestehenden Aktivitäts-Overlays muss der Produktkatalog nicht aktiviert sein. Die allgemeine Monetarisierungs-Aktivitätsansicht benötigt einen aktivierten Katalog. In Event Flow bleibt Donation der Auslöser für Zeilen mit hasDonation; verwende Event Type für Käufe oder abgeschlossene Geschenke. Siehe die Ereigniszuordnung.

Wenn nichts erscheint

• Empfänger aus: aktiviere die Fernsteuerung der Erweiterung über API. Andere API-Schalter dienen anderen Zwecken.
• Getrennt: lass SSN eingeschaltet und prüfe den Netzwerkzugriff. Dieser Status zeigt die gemeinsame Empfängerverbindung, nicht den Zustellstatus im Anbieter-Dashboard.
• Kein Ereignis empfangen: prüfe den ausgewählten Anbieter, die private URL und die Zustellungseinstellungen des Anbieters. Eine erfolgreiche lokale Vorschau prüft nur das Aussehen.
• Ereignis übersprungen: markierte Tests, private Zahlungen, nicht unterstützte Ereignistypen oder ungültige Beträge sind ausgeschlossen. Der Status zeigt keine Käuferdaten.
• Ereignis empfangen, aber kein Overlay: prüfe Sitzung/Passwort, Quellfilter, Ereigniskategorien, SSN-Regeln und die Sichtbarkeit in OBS. Käufe sind keine Abonnements; die meisten Käufe sind keine Spenden.
• Doppelte Einträge: vermeide, dieselbe Zahlung sowohl über den direkten Anbieter als auch über einen Aggregator einzuspeisen. Die Duplikaterkennung bei Wiederholungen verwendet Zustellungs-IDs des Anbieters.
• Import fehlgeschlagen: prüfe den Produkt-Slug, das Storefront-Token und ob das Produkt öffentlich und verfügbar ist. Die manuelle Eingabe bleibt möglich.

Dies zeigt Livestream-Aktivität und ist kein Bestellbuch. Nutze das Anbieter-Dashboard für Zahlungsbestätigung, Erstattungen und Bestellabwicklung. Shopify hat jetzt eine eigene Einrichtung für Produktimport und signierte Ereignisse zu bezahlten Bestellungen. Tiltify-Kampagnenaktivität und bezahlte Patreon-Mitgliedschaften bleiben zukünftigen Integrationen vorbehalten.