Collega il tuo negozio. Mostra i tuoi prodotti.

Prodotti e avvisi sono separati

Usa Monetizzazione in SSN per promuovere prodotti e pagine di supporto pubblici, ricevere attività o fare entrambe le cose. Questa guida riguarda Fourthwall, Ko-fi e Buy Me a Coffee. Per NinjaBacker, Throne, Amazon ed eBay, consulta la guida alla monetizzazione.

Collega gli avvisi · Fourthwall · Ko-fi · Buy Me a Coffee · Importa un prodotto · OBS e codici QR · Risoluzione dei problemi

Collega gli avvisi di attività

1. Apri Monetizzazione → Avvisi Fourthwall, Ko-fi e Buy Me a Coffee e scegli il provider.
2. Fai clic su Impostazione del ricevitore. Attiva l'impostazione esistente controllo API remoto dell'estensione , poi lascia SSN attivo.
3. Torna a Monetization e fai clic su Copia URL webhook. Incolla questo indirizzo privato nelle impostazioni webhook del provider indicate sotto.
4. Controlla lo stato del ricevitore. Ricevitore connesso significa che SSN è in ascolto, non che la configurazione del provider sia stata verificata. La riga dell'ultimo evento si aggiorna quando un evento del provider valido e non duplicato raggiunge l'app in esecuzione; si azzera al riavvio.
5. Usa Anteprima avviso di esempio per controllare l'aspetto in una pagina di esempio separata. Non invia pagamenti, non aggiorna totali, non esegue Event Flow e non verifica la consegna del webhook.

Questi tre endpoint esistenti basati sull'URL di sessione si affidano alla riservatezza dell'URL; la configurazione attuale di SSN non accetta i loro segreti di firma. Sono adatti agli avvisi in diretta, non come prova di pagamento per evadere ordini. Non pubblicare l'indirizzo webhook e non usarlo come destinazione QR per gli spettatori.

Fourthwall

1. In Fourthwall, apri Impostazioni → Per sviluppatori → Webhook (Settings → For Developers → Webhooks).
2. Crea un webhook e incolla l'URL Fourthwall copiato da SSN.
3. Seleziona gli eventi supportati di cui hai bisogno: ORDER_PLACED, GIFT_PURCHASE, DONATION e SUBSCRIPTION_PURCHASED.
4. Salva il webhook e lascia SSN in esecuzione.

Gli ordini appaiono come acquisti, i prodotti regalati come regali e i nuovi abbonamenti come adesioni. Per compatibilità, gli ordini Fourthwall ordinari conservano il loro valore di donazione esistente. Gli ordini con riscatto di buoni regalo non aggiungono di nuovo il valore prepagato. Gli eventi contrassegnati come prove vengono ignorati.

Documentazione webhook di Fourthwall · Anteprima di un acquisto di esempio

Ko-fi

1. Apri Webhook Ko-fi.
2. Incolla l'URL Ko-fi copiato da SSN in URL webhook, poi salvalo o aggiornalo.
3. Lascia SSN in esecuzione. Mance pubbliche, pagamenti degli abbonamenti, ordini del negozio e commissioni usano la stessa connessione.

I pagamenti privati sono esclusi. I pagamenti degli abbonamenti appaiono come attività di adesione; gli ordini del negozio e le commissioni appaiono come acquisti senza aumentare i totali delle donazioni. Ko-fi non fornisce notifiche di annullamento degli abbonamenti tramite questo webhook.

Prove: usa prima l'anteprima di esempio isolata di SSN. I pagamenti di prova di Ko-fi possono sembrare pagamenti reali e attivare avvisi, totali e azioni se inviati al ricevitore attivo. Non usare la prova del provider in una sessione con ricompense a pagamento attivate.

Documentazione webhook di Ko-fi · Anteprima supporto di esempio

Buy Me a Coffee

1. Apri Integrazioni nella dashboard del creator e scegli Nuovo webhook.
2. Assegna un nome e incolla l'URL SSN per Buy Me a Coffee come endpoint.
3. Seleziona donation.created, extra_purchase.created, commission_order.created, wishlist_payment.created e membership.started secondo necessità.
4. Salva e lascia attiva la consegna degli eventi. Usa la cronologia delle consegne del provider per indagare sugli errori.

Gli ordini del negozio e le commissioni sono acquisti. I pagamenti delle liste dei desideri sono contributi regalo. L'inizio di un abbonamento è un annuncio di adesione, non un addebito confermato separato. Le note nascoste restano nascoste e i sostenitori anonimi restano anonimi. Le prove della dashboard contrassegnate live_mode: false vengono ignorate senza avvisi di pagamento. Rimborsi e aggiornamenti del ciclo di vita non creano pagamenti e non annullano i totali esistenti.

Documentazione webhook di Buy Me a Coffee · Anteprima di un contributo di esempio

Importa un prodotto Fourthwall

1. Nella sezione di Fourthwall Impostazioni → Per sviluppatori (Settings → For Developers), crea un Token Storefront. Usa il token Storefront per accedere al catalogo pubblico, non una chiave API amministrativa.
2. In SSN, apri Products & support links → Set up products and links → Import a Fourthwall product.
3. Incolla l'URL pubblico del prodotto e il token, poi fai clic su Carica dettagli prodotto.
4. Controlla nome, immagine, prezzo e URL pubblico caricati. Verifica che l'URL appartenga allo stesso negozio del token, compreso l'eventuale dominio personalizzato. Il token determina quale catalogo del negozio viene interrogato.
5. Scegli Shop, Gift, Support o Join per descrivere l'azione degli spettatori. Fai clic su Aggiungi prodotto o link, attiva Products & support links, poi Salva configurazione.

Importa un prodotto pubblico e disponibile alla volta tramite la Storefront API di Fourthwall. Il token viene usato per quella richiesta, poi cancellato; non viene salvato né inviato agli overlay. Prezzi diversi tra varianti e prezzi dei pacchetti vengono lasciati vuoti per non suggerire un totale fisso al checkout. L'importazione è un'istantanea: prezzi, disponibilità e immagini non si aggiornano automaticamente. Reimporta o modifica i dati quando cambiano. Il catalogo contiene fino a 20 voci; aggiungere di nuovo crea un'altra voce.

Crea un token Storefront · Campi prodotto Fourthwall

Mostra prodotti, link pubblici e codici QR

Puoi anche inserire manualmente un link pubblico a un prodotto o al supporto da qualsiasi sito, inclusi Shopify, Tiltify o Patreon. Aggiungi un URL immagine e un prezzo facoltativo, scegli lo scopo, attiva il catalogo e salva. Aggiungere un link non collega un flusso di pagamenti.

1. Scegli Prodotti e link di supporto (Products & support links) sotto Link overlay per.
2. Apri Opzioni del link overlay. Scegli Product showcase, Support card, Activity alerts oppure la vista combinata.
3. Fai clic su Copia link OBS e incollalo in una sorgente browser di OBS. Inizia con 800 × 600. Per livelli separati di promozione e attività, crea una sorgente per ciascuna vista.
4. Usa Display options per fissare il primo prodotto o ruotare le voci. Attiva i codici QR per consentire agli spettatori di raggiungere la destinazione pubblica. Usa Copia link pubblico accanto a una voce per condividere tu stesso il suo indirizzo cliccabile nella chat.

La vetrina include l'immagine del prodotto, se fornita; la scheda di supporto più piccola la nasconde. Gli avvisi di attività funzionano indipendentemente e non aggiungono il codice QR di un prodotto non correlato in rotazione. Mantieni leggibile il link pubblico e prova il QR da un telefono osservando la disposizione finale in OBS. Modificare la scala del link OBS o ritagliare troppo può rendere difficile la scansione.

Per multi-alerts o il feed delle attività, usa i rispettivi link di overlay esistenti con la stessa sessione SSN. Questi overlay delle attività non richiedono che il catalogo prodotti sia attivo. La vista generica delle attività Monetization, invece, lo richiede. In Event Flow, Donation resta il trigger per le righe con hasDonation; usa Event Type per gli acquisti o il completamento dei regali. Consulta la mappatura degli eventi.

Se non compare nulla

• Ricevitore disattivato: attiva il controllo API remoto dell'estensione. Gli altri interruttori API servono ad altri scopi.
• Disconnesso: lascia SSN attivo e controlla l'accesso alla rete. Questo stato riguarda la connessione del ricevitore condiviso, non lo stato di consegna nella dashboard del provider.
• Nessun evento ricevuto: controlla provider selezionato, URL privato e impostazioni di consegna del provider. Il successo dell'anteprima locale verifica solo l'aspetto.
• Evento ignorato: prove contrassegnate, pagamenti privati, tipi di evento non supportati o importi non validi sono esclusi. Lo stato non mostra dati degli acquirenti.
• Evento ricevuto, ma nessun overlay: controlla sessione/password, filtri delle sorgenti, categorie di eventi, regole SSN e visibilità in OBS. Gli acquisti non sono abbonamenti; la maggior parte degli acquisti non sono donazioni.
• Duplicati: evita di inviare lo stesso pagamento sia tramite il provider diretto sia tramite un aggregatore. La deduplicazione dei tentativi usa gli ID di consegna del provider.
• Importazione non riuscita: controlla lo slug del prodotto e il token Storefront, e verifica che il prodotto sia pubblico e disponibile. Resta possibile inserirlo manualmente.

Si tratta dell'attività della diretta, non di un registro degli ordini. Usa la dashboard del provider per confermare pagamenti, gestire rimborsi ed evadere ordini. Shopify ora dispone di una propria configurazione per l'importazione dei prodotti e gli ordini pagati con firma. L'attività delle campagne Tiltify e gli abbonamenti a pagamento Patreon restano integrazioni future.