Giveaway, biglietti e premi in punti

Organizza un sorteggio gratuito in 5 passaggi

Nel popup, apri Opzioni giveaway. Lascia l'ID come default e la parola chiave su !enter. Mantieni il prezzo del biglietto e il premio in punti a 0.
Scegli Scheda vincitore, Rullo dei nomi, oppure Ruota della community. Visualizza l'anteprima, poi copia il link in OBS come Sorgente browser.
Fai clic su Apri partecipazioni. Gli spettatori scrivono la parola chiave in chat per partecipare.
Fai clic su Chiudi partecipazioni, poi Estrai vincitore. (L'estrazione chiude le iscrizioni se te ne dimentichi.)
Fai clic su Nuovo turno per un'altra estrazione. I vincitori precedenti restano nella cronologia.

Lascia Social Stream Ninja in esecuzione. Esegue l'estrazione. Non devi mai fare clic dentro la sorgente OBS.

La vecchia ruota della community autonoma funziona ancora se escludi &managed dal link. Punti e controlli remoti richiedono il link gestito.

Vendi biglietti in cambio di punti SSN

Attiva Sistema di punti fedeltà nel pannello. (Sono punti SSN, non punti canale Twitch.)
In Opzioni sorteggio, apri Biglietti e premi in punti. Imposta Punti per biglietto e Numero massimo di biglietti per spettatore.
Fai clic su Apri partecipazioni. Per un sorteggio chiamato friday, uno spettatore acquista 5 biglietti con !ticket friday 5.
Vedi chi si è iscritto in Gestisci giveaway e cronologia.

Quando succede questo…	I punti…
Uno spettatore acquista biglietti	Vengono riservati. Non possono essere spesi altrove.
Lo spettatore non ha abbastanza punti	Non vengono addebitati. Nessun biglietto.
Estrai un vincitore	Vengono spesi.
Fai clic su Annulla e rimborsa	Vengono restituiti a tutti.
Rimuovi uno spettatore prima dell'estrazione	Vengono restituiti a quello spettatore.

Le regole si bloccano dopo la prima iscrizione. Per modificarle, annulla e rimborsa, poi avvia un nuovo turno. Nuovo turno non elimina un turno a pagamento. Chiudere e riaprire lo mette solo in pausa.

Regala punti

Prima di aprire le iscrizioni, imposta Premio in punti per vincitore e Numero di premi.
Apri le iscrizioni come al solito.
Estrai un vincitore alla volta. Il premio viene aggiunto ai punti di ogni vincitore.

I punti premio sono nuovi punti, non provengono dalla vendita dei biglietti. Il massimo distribuibile è premio × numero di premi.

Un'estrazione completata non può essere annullata. Per correggere un errore, modifica manualmente i punti di quello spettatore. Ricollegare la visualizzazione non paga mai due volte.

Giochi con ricompense in punti

Number Hunt

Imposta il tipo su Number Hunt (controllato dall'host), Punti per biglietto 0, e Numero di premi 1. Aggiungi un premio in punti se vuoi.
Social Stream sceglie un numero segreto da 1 a 100.
I giocatori provano a indovinare con !guess friday 50 (usa l'ID del tuo sorteggio).

I tentativi errati restringono l'intervallo per tutti. Vince la prima risposta corretta. Un tentativo per spettatore ogni 5 secondi.

Mostralo con la visualizzazione del sorteggio o games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. I giochi normali non assegnano punti SSN.

Montepremi testa o croce

Imposta il tipo su Montepremi testa o croce, Punti per biglietto 1, Numero di premi 1, e Premio in punti per vincitore 0.
Gli spettatori scommettono con !ticket friday 3 heads oppure !ticket friday 3 tails.
Chiudi le iscrizioni ed estrai. È un lancio con probabilità 50/50, indipendentemente dalle puntate.

I vincitori ricevono la propria puntata più una quota delle puntate perdenti, proporzionale alla puntata. Nessuna commissione e nessun punto nuovo. Esempio: i vincitori puntano 2 e 1, i perdenti 5; il piatto di 8 punti paga 5 e 3.

Serve un giocatore su entrambi i lati, altrimenti l'estrazione viene rifiutata. Annulla prima dell'estrazione per rimborsare tutti.

Come vengono divisi i punti rimanenti

I punti rimanenti vanno prima alle quote frazionarie maggiori. In caso di parità, a chi si è iscritto per primo.

Organizza più sorteggi contemporaneamente

Assegna a ciascuno un identificativo breve in ID giveaway (lettere, numeri, -, _) e aggiungi &giveaway=ID al suo link OBS.
I comandi per biglietti e tentativi indicano il nome del sorteggio, come !ticket friday 5.
Assegna a ogni sorteggio gratuito una parola chiave diversa. Una parola condivisa non iscrive a entrambi.
Tutti i biglietti vengono pagati dallo stesso saldo punti dello spettatore.

Il pannello configura i nuovi turni. Per vedere le regole effettive di un turno in corso, consulta il gestore. Modificare un link OBS cambia solo l'aspetto.

La visualizzazione OBS

Usa 1280 × 720 come sorgente browser. Lo sfondo è trasparente, a meno che tu scelga Pannello a tema.
La ruota mostra fino a 120 nomi, ma il vincitore viene scelto tra tutti i biglietti.
Dopo una riconnessione, mostra il risultato salvato. Le impostazioni di movimento ridotto saltano l'animazione.
Social Stream non può sapere se la scena OBS è in diretta.

Mantieni privati questi dati: link di controllo, ID di sessione e file di backup.

Event Flow

Aggiungi il trigger Giveaway / Biglietti come azione (sotto le azioni dei punti).
Scegli l'azione: Partecipa al sorteggio gratuito, Acquista biglietti, Assegna biglietti gratuiti, Chiudi iscrizioni, Estrai vincitore, Annulla e rimborsa oppure Consulta stato.
Scegli l'ID del sorteggio e il numero di biglietti. Per un piatto, scegli testa o croce.

Acquista biglietti spende già i punti. Non inserire un'azione Spendi punti prima.

Agisce per lo spettatore che ha inviato il messaggio. Inserisci un trigger o un filtro affidabile prima delle assegnazioni e dei controlli dell'host.

Altri dettagli su Event Flow

Se fallisce, le azioni dipendenti si fermano. Il messaggio della chat rimane visibile.
Il risultato è in meta.giveawayControlResult.
Il pannello di test esegue solo una simulazione. Per test reali, usa un host o un profilo separato.
Il saldo viene verificato all'esecuzione, quindi il messaggio di iscrizione non può guadagnare l'ultimo punto mancante.
La protezione dalle ripetizioni è più efficace sulle sorgenti con ID propri dei messaggi.
Gli eventi programmati senza uno spettatore non possono acquistare biglietti.

Stream Deck e API

Il plugin Stream Deck include: Apri sorteggio, Chiudi sorteggio, Esegui estrazione, Annulla e rimborsa, Nuovo turno del sorteggio, e Stato del sorteggio.

Usano il sorteggio default . Per un altro, inserisci {"giveawayId":"friday"} nel campo del valore. Apri sorteggio accetta anche un oggetto config oggetto.
Un tasto conferma che Social Stream ha risposto, non che OBS mostri il risultato. Se scade il tempo, controlla lo stato prima di estrarre di nuovo.

Acquistare biglietti tramite API

{"protocol":2,"action":"buygiveawaytickets","get":"callback-1","value":{"giveawayId":"friday","roundId":"ROUND_ID","operationId":"purchase-123","count":5,"actor":{"chatname":"Avery","type":"youtube","userid":"SOURCE_USER_ID"}}}

operationId identifica l'acquisto; get identifica la risposta.
Mantieni lo stesso ID operazione quando riprovi. Usane uno nuovo per un nuovo acquisto.

L'accesso all'API dell'host può spendere i punti di qualsiasi spettatore. Non esporlo mai tramite un modulo pubblico.

Cronologia e backup

Gestisci giveaway e cronologia mostra turni, iscrizioni e vincitori. Puoi usare Esporta cronologia vincitori (JSON) oppure salvare un backup completo di punti e sorteggi. Non viene caricato nulla online.

Dopo un riavvio, i turni aperti tornano chiusi, con i biglietti ancora riservati. Riapri, estrai oppure annulla e rimborsa.

Ripristina un backup

Funziona solo su un nuovo host senza punti né sorteggi.

Mantieni spento il vecchio host. Apri SSN in un nuovo profilo del browser e apri il gestore dei sorteggi.
Sotto Recupera su un nuovo host, scegli il backup completo. Attendi il messaggio e annota l'ID di sessione indicato.
Nel campo del popup Opzioni sessione, inserisci quell'ID di sessione.
Torna nel gestore, scegli l'ID del sorteggio e fai clic su Aggiorna. Controlla regole, iscrizioni e vincitori. I turni vengono ripristinati chiusi.
Riapri, estrai oppure usa Annulla e rimborsa. Poi salva un nuovo backup.

Non eseguire mai contemporaneamente il vecchio host e quello ripristinato. Un backup non contiene ciò che è accaduto dopo il salvataggio né le impostazioni del pannello.

Altre informazioni su dove risiedono i dati

I punti risiedono in questo profilo del browser o dell'app e non si sincronizzano altrove. I turni vengono conservati per sessione.
Cancellare i dati del browser può eliminarli, quindi conserva i backup fuori da quel profilo.
Le importazioni dei soli saldi non ripristinano i biglietti riservati. La reimpostazione dei punti è bloccata finché ci sono biglietti riservati e non cancella la cronologia dei sorteggi.
Gli acquisti di adesivi non confermati vengono sbloccati allo scadere del tempo.
Non ci sono backup nel cloud né conversione in denaro. Il backup sul server potrebbe arrivare in futuro.

Risolvere i problemi

Problema	Prova così
Uno spettatore non riesce a partecipare	Controlla l'ID, la parola chiave, l'opzione solo membri, l'apertura delle iscrizioni e che la piattaforma venga acquisita. I messaggi dei bot, privati, vecchi, riprodotti e di test non contano mai.
L'account di uno spettatore sembra errato	Un cambio di nome può confondere i saldi. Controlla sull'host. Le piattaforme non vengono mai unite.
I pulsanti non rispondono	Verifica che l'host SSN corretto sia in esecuzione con i controlli host attivi. Aggiorna prima di riprovare.
Impossibile reimpostare o importare punti	Prima completa o annulla gli acquisti di biglietti riservati. Per un backup con biglietti riservati, usa il ripristino completo.
`!spend` segnala una ricompensa sconosciuta	Serve una ricompensa configurata con un prezzo.