Prodotti in diretta e link per il pubblico

1. Aggiungi un prodotto o un link di supporto

Apri Monetizzazione > Prodotti e link di supporto > Configura prodotti e link. Incolla un link HTTPS pubblico e scegli Carica dettagli dal link. L'importazione rapida supporta pagine pubbliche Gumroad, itch.io, Ko-fi, Buy Me a Coffee e Fourthwall. Domini personalizzati, reindirizzamenti, pagine private e pagine senza metadati pubblici possono richiedere l'inserimento manuale. Le opzioni esistenti di importazione API Shopify e Fourthwall restano disponibili.

Controlla titolo, immagine, prezzo, valuta e finalità. L'importazione rapida lascia intenzionalmente vuoto il prezzo. Scegli Aggiungi prodotto o link, attiva Products & support links, poi Salva configurazione. Per le schede manuali non serve un account commerciante.

Negozio, Regalo, Supporto e Iscriviti descrivono la finalità del link. Non cambiano la classificazione dei successivi eventi di pagamento. Le schede sono istantanee salvate; il checkout è la fonte autorevole per scorte e prezzi.

2. Controlla cosa compare

Aggiungi l'URL overlay esistente Prodotti e link di supporto a OBS. Usa Vetrina o Scheda supporto per le promozioni, oppure Entrambi per includere gli avvisi di attività.

• Mostra ora su una riga salvata fissa quel prodotto e sostituisce la programmazione periodica delle schede.
• Prossimo prodotto fissa il prossimo prodotto salvato.
• Nascondi prodotti nasconde le schede promozionali. Gli avvisi di acquisto e regalo continuano.
• Riprendi programmazione ripristina le impostazioni salvate del primo prodotto o della rotazione.

Imposta i secondi di Mostra/nascondi prima di usare un controllo. Zero dura fino a una modifica; 1-3600 ripristina la programmazione salvata dopo quel numero di secondi. Le sostituzioni dal vivo si azzerano al riavvio di SSN. Le righe non salvate sono contrassegnate e i loro pulsanti Mostra ora restano disabilitati fino a Salva configurazione. Lo stato indica il prodotto selezionato e i secondi rimanenti; non afferma che OBS sia in diretta o che la sorgente sia visibile. I controlli identificano un prodotto tramite il suo URL salvato esatto, quindi spostarlo nell'elenco non interrompe un'automazione.

3. Pubblica un link per il pubblico

Apri Opzioni di visualizzazione > Pagina pubblica per gli spettatori e scegli Pubblica link salvati. Pubblica esplicitamente ogni link salvato a prodotti/supporto, inclusi titoli, immagini, prezzi e finalità. Condividi Copia link per il pubblico con gli spettatori. I codici QR dei prodotti ora usano questa pagina stabile, così uno spettatore può trovare un prodotto anche dopo che l'overlay è passato al successivo.

Le modifiche salvate e i controlli dal vivo aggiornano lo stesso URL. La pagina per il pubblico controlla gli aggiornamenti ogni 15 secondi e contrassegna il prodotto in evidenza. Mantiene accessibili gli altri link quando le schede promozionali sono nascoste. L'ultimo catalogo pubblicato resta accessibile mentre SSN è offline; viene mostrata la data di salvataggio, e “in evidenza” indica l'ultima selezione o rotazione salvata, non dimostra che il creator sia in diretta.

Rimuovi pubblicazione rimuove la pagina; i codici QR dei prodotti tornano ai singoli link prodotto. Le pagine del pubblico aperte si svuotano al successivo controllo riuscito. Gli URL condivisi in precedenza smettono di caricarsi finché non pubblichi di nuovo. Ripubblicare dallo stesso dispositivo ripristina lo stesso URL. Conserva il profilo del dispositivo SSN: la sua chiave privata di pubblicazione serve per aggiornare o rimuovere la pagina.

Se l'API non è disponibile, i controlli locali funzionano comunque. Gli aggiornamenti falliti lasciano visibile l'ultima pagina pubblicata e vengono ritentati mentre SSN è aperto. Il popup segnala l'errore. La pubblicazione richiede che il servizio facoltativo del negozio pubblico sia distribuito; non coinvolge account di negozi o pagamenti.

Event Flow e controlli remoti

In Event Flow, aggiungi l'azione Prodotti e supporto dal gruppo di azioni overlay. Seleziona Mostra, Avanti, Nascondi o Riprendi; se vuoi imposta l'URL salvato esatto del prodotto e i secondi. Usa un trigger esistente appropriato, come un tuo comando da moderatore, invece di consentire a ogni messaggio chat di cambiare i prodotti.

Nel plugin Stream Deck, aggiungi tasti Preset Command da Prodotti e supporto: Mostra prodotto, Prossimo prodotto, Nascondi prodotti e Riprendi prodotti. Mostra include un selettore dei prodotti salvati; scegli Aggiorna prodotti e stato per caricare l'elenco. Una selezione salvata non disponibile resta visibile invece di cambiare silenziosamente. Puoi comunque incollare l'URL pubblico del prodotto oppure lasciarlo vuoto per il prodotto corrente/primo. Avanti e Nascondi accettano secondi facoltativi. I tasti attendono che SSN confermi la modifica locale, indipendentemente dagli aggiornamenti della pagina pubblica. Aggiungi il tasto facoltativo Stato prodotti per un riscontro di selezione/visibilità/programmazione, aggiornato ogni cinque secondi mentre il tasto è visibile. L'inspector e SSN mostrano il nome completo del prodotto; il piccolo tasto di stato tronca i nomi lunghi. Usa la connessione P2P o WebSocket esistente.

L'API remota autenticata della sessione esistente accetta lo stesso controllo:

{"action":"commerceControl","command":"show","url":"https://example.com/product","seconds":30}

I comandi sono show, next, hide e resume. Ometti l'URL per mostrare il prodotto corrente/primo. I controlli dell'host devono essere abilitati. Non condividere mai un URL privato di sessione/controllo con gli spettatori; usa il link pubblico per il pubblico.

Queste azioni trasmettono solo l'esistente monetization_update stato di visualizzazione. Non creano donazioni, acquisti, messaggi chat o trigger di pagamento Event Flow. L'esistente hasDonation comportamento resta invariato.

Sapere quando un controllo è terminato

L'azione Prodotti e supporto attende la risposta di SSN prima di proseguire il flusso. Nei normali payload evento, meta.commerceControlResult contiene success e il risultante commerce stato di controllo oppure un error. Un errore interrompe le azioni successive della catena; l'acquisto o la mancia originale resta disponibile agli altri flussi e overlay. Lo stato conferma la selezione, la visibilità o la programmazione in SSN; la visibilità in OBS resta separata.

Se non arriva una risposta entro otto secondi, l'azione segnala un timeout. Il controllo potrebbe essere stato applicato comunque: controlla lo stato nel popup o nel dock prima di riprovare Avanti. I client remoti esterni devono usare il protocollo esistente di richiesta/risposta e controllare il risultato restituito, invece di considerare riuscito un comando solo perché inviato.

Gli altri effetti hanno un proprio riscontro. Stampa etichetta termica segnala meta.thermalPrintResult; l'invio riuscito di un lavoro non conferma l'uscita su carta. Un'azione Webhook sincrona può restituire lo stato HTTP e la risposta, e può bloccare in caso di errore. Sono risultati delle azioni, non nuovi eventi di pagamento. Vedi il riferimento degli eventi per il contratto del risultato dei controlli.