# Statistiche (/it/docs/analytics)
Ogni community ha una dashboard, senza configurazione e senza nulla da collegare.
## Sezioni della dashboard [#dashboard-sections]
| Sezione | A cosa risponde |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Crescita dei membri | Quanti fan hai, a che velocità cambia quel numero e quale quota è attiva |
| Coinvolgimento | Le missioni completate e gli oggetti distribuiti nel periodo |
| Andamento dell'attività | Quando la tua community è davvero nell'app, per ora e per giorno |
| Medie per fan | Le missioni completate e gli oggetti posseduti per fan, più la fidelizzazione e la quota di attivi |
| Rendimento delle funzionalità | Quali missioni convertono e quali modelli i fan portano a termine, così puoi creare più di ciò che funziona |
Il **selettore del periodo** si applica a tutta la dashboard. Confronta lo stesso intervallo settimana su settimana invece di leggere un numero isolato, perché un singolo giorno riflette una sola partita.
Controlla quali modelli i tuoi fan portano davvero a termine prima di pianificare le prossime venti missioni.
## Esportazioni e Data API [#exports-and-the-data-api]
| Esigenza | Cosa usare |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| I completamenti di una missione e i fan che li hanno fatti | L'esportazione per missione in [Gestire le missioni](/docs/quests/managing#per-quest-analytics) |
| Un'istantanea di ogni fan e dei suoi totali | L'[esportazione dei membri](/docs/members#exporting-the-member-list) |
| Gli stessi dati a intervalli regolari, nei tuoi sistemi | La [Data API](/docs/integrations/data-api) |
## Statistiche web [#web-analytics]
Google Analytics e Google Tag Manager possono essere aggiunti alla tua app. Vedi [Integrazioni di statistiche](/docs/analytics).
# Battlepass (/it/docs/battlepass)
Una scala di ricompense che si sblocca man mano che un fan guadagna XP, con un lato gratuito che tutti risalgono e un lato a pagamento che solo gli abbonati possono riscattare.
Le missioni pagano per ogni azione. Il battlepass paga per il totale, quindi la trentesima missione vale la pena anche quando la sua ricompensa è piccola.
## Stagioni [#seasons]
Una stagione è un oggetto vero e proprio nel pannello di amministrazione. Ne crei una, la riempi di gradi e la avvii.
| Azione | Cosa fa |
| ---------- | --------------------------------------------------------------------------------------------------------- |
| Bozza | Costruire una stagione senza che i fan la vedano |
| Duplicare | Copiare la struttura della stagione scorsa e cambiare le ricompense, invece di ricostruire quaranta gradi |
| Modificare | Cambiare una stagione, anche una già online |
| Chiudere | Terminare una stagione e archiviarla |
Le date sono facoltative. Una stagione senza date dura finché non la chiudi, ed è la scelta adatta a una scala di progressione permanente. Una stagione con un inizio e una fine dura due settimane attorno a un torneo, mostra ai fan un conto alla rovescia e si chiude da sola.
I fan passano da una stagione all'altra nell'app, quindi una stagione chiusa resta visibile invece di essere eliminata.
Migrare un battlepass costruito alla vecchia maniera, cioè come un insieme di missioni di verifica del livello create a mano, significa eliminarlo e ricostruirlo come stagione. Non esiste un aggiornamento sul posto. Fallo tra una stagione e l'altra, mai a metà, perché ricostruire a stagione in corso toglie progressi e riscatti ai fan che erano già a metà della scala. I battlepass costruiti alla vecchia maniera continuano a essere visualizzati esattamente come prima, quindi non c'è alcuna scadenza e nessuna fretta di migrare prima di una pausa naturale.
Se la tua community ha ancora un battlepass costruito alla vecchia maniera, la sezione Battlepass mostra una scheda **Legacy** (formato precedente) accanto alle tue stagioni. Le sue ricompense sono elencate lì e si possono ancora modificare. La scheda sparisce da sola quando non contiene più nulla, e una community partita con le stagioni non la vede mai.
## Gradi [#tiers]
Un grado è un singolo gradino: un livello e la ricompensa che aspetta lì.
I gradi si sbloccano con gli XP, usando lo stesso totale che determina i [livelli](/docs/levels) e la [classifica](/docs/leaderboards). Non c'è una seconda valuta da seguire né un punteggio separato del battlepass da spiegare. Un fan che raggiunge il livello 12 ha sbloccato tutti i gradi fino al 12.
Questo significa anche che le soglie dei livelli e il battlepass sono lo stesso problema di progettazione. Livelli troppo distanti tra loro danno a un fan un grado al mese.
Qualsiasi ricompensa può stare su un grado, compresi premi e loot box. Vedi [Ricompense](/docs/rewards).
## Il percorso gratuito e il percorso Premium [#the-free-track-and-the-premium-track]
Due percorsi, affiancati, a ogni livello.
Il percorso gratuito può essere riscattato da tutti. Il percorso Premium ha come requisito di accesso il piano di abbonamento: un fan vede esattamente cosa lo aspetta e quale piano gli serve per riscattarlo, e le ricompense si accumulano invece di scadere. Un fan che passa al piano superiore al livello 20 ottiene tutto ciò che ha superato durante la salita.
Nascondi le ricompense Premium e nessuno compra l'abbonamento. Rendi inutile il percorso gratuito e nessuno sale abbastanza da interessarsi a quello Premium.
## Abbonamento Premium [#premium-membership]
Un piano a pagamento che i fan acquistano dentro la tua app. È ciò che dà accesso al percorso Premium del battlepass, e funziona da solo, che tu abbia un battlepass oppure no.
| Impostazione | Come funziona |
| ------------------------ | ---------------------------------------------- |
| Pagamenti | Stripe, collegato al tuo account |
| Modello | Un abbonamento ricorrente o un pagamento unico |
| Prezzo e valuta | Li decidi tu |
| Ricavi | Restano a te. Non passano da noi |
| Vantaggi | Li definisci tu |
| Dove i fan lo gestiscono | Nell'app, in Impostazioni |
I vantaggi sono tutto ciò che decidi di riservare al piano. Quelli che i partner usano:
* Missioni esclusive, visibili solo agli abbonati
* Ricompense migliori nelle missioni che tutti possono vedere
* Il percorso Premium del battlepass
* Post con requisiti di accesso nel [feed di notizie](/docs/newsfeed)
* Articoli del negozio che gli abbonati possono acquistare e gli altri no
* Un badge personalizzato sulla loro riga in classifica e sul loro profilo
Il badge è l'unico vantaggio che gli altri fan possono vedere, ed essere visibilmente abbonati davanti alla community è gran parte di ciò che le persone comprano.
Stabilisci il prezzo in base a quanto un fan spende già con te, non in base alle altre app. E scrivi l'elenco dei vantaggi prima di fissare il prezzo, perché un piano che consiste in un percorso del battlepass e nient'altro è difficile da vendere al secondo mese. Cosa cambia nel tuo accordo commerciale con noi è spiegato in [Quanto costa](/docs/getting-started/pricing).
# Registro delle modifiche (/it/docs/changelog)
Le correzioni e le piccole rifiniture sono omesse, a meno che non cambino il modo in cui useresti qualcosa.
**L'SDK ha raggiunto la piattaforma.** Pronostici, eventi, battlepass, feed di notizie, negozio, classifiche e avatar ora si possono integrare tutti nel tuo sito. La pagina Stato delle funzionalità di FanBase SDK riporta l'elenco.
**I blocchi FanBase per i temi Shopify sono in sviluppo.** Le missioni, il profilo e l'avatar di un fan e un indicatore dell'account per la tua intestazione, aggiunti dall'editor del tema di Shopify senza codice. Il rilascio parte dai negozi pilota. [Shopify](/docs/integrations/shopify#on-your-storefront)
**Ora i punti diventano ordini veri.** Disponibile dal 7 ottobre. Un fan acquista un articolo del negozio con i punti e nel tuo Shopify compare un ordine pagato, associato alla sua scheda cliente, con l'indirizzo di consegna che ha inserito. [Shopify](/docs/integrations/shopify#spending-points-back-into-shopify)
* Attiva **Fulfil via Shopify** (evasione tramite Shopify) su un articolo del negozio, poi scegli il prodotto e la variante che rappresenta
* L'articolo chiede al fan un'email e un indirizzo di consegna al momento dell'acquisto, con un nome per il pacco
* Ogni acquisto mostra il suo ordine Shopify e lo stato nel pannello di amministrazione, con la possibilità di riprovare se uno non va a buon fine
* Questi ordini hanno il tag `fanbase-redemption` e non attivano mai una regola di ricompensa
* Il tuo negozio Shopify va autorizzato ancora una volta per gli ordini. Il pannello di amministrazione mostra un avviso quando serve.
**Limiti di acquisto per fan.** Disponibile dal 7 ottobre. Ogni articolo del negozio può limitare quanti ne acquista un singolo fan, con un numero separato per i fan del piano gratuito e i fan Premium. I fan vedono il limite sull'articolo e ciò che ottiene l'altro piano. [Negozio](/docs/store#purchase-limits)
* Usali per un drop equo, in cui un limite di uno mette cinquanta articoli in cinquanta mani
* Oppure come motivo per passare a Premium, dando ai fan Premium un limite più alto rispetto a quelli del piano gratuito
**Una scheda Legacy per i battlepass meno recenti.** Disponibile dal 27 ottobre. Le community con un battlepass costruito prima delle stagioni possono ancora vederne e modificarne le ricompense. [Battlepass](/docs/battlepass#seasons)
**Il battlepass ora è una funzionalità a sé.** Prima era un insieme di missioni di verifica del livello create a mano. Ora è una vera sezione del pannello di amministrazione, con stagioni che puoi preparare in bozza, duplicare, modificare e chiudere. Una stagione ha un percorso gratuito e un percorso Premium, e date facoltative, quindi può durare per sempre o due settimane.
* I battlepass esistenti continuano a funzionare e a essere visualizzati come prima
* Migrarne uno significa ricostruirlo come stagione, quindi pianificalo tra una stagione e l'altra e non a stagione in corso
**Gli articoli del negozio possono essere oggetti di personalizzazione**, quindi immagini del profilo e cornici si possono comprare e non solo vincere.
**La creazione di ordini Shopify** è entrata in fase di test. Un fan spende punti nel negozio dell'app e nel tuo Shopify compare un ordine vero, con un indirizzo di spedizione e un limite di acquisto per fan.
**L'SDK.** Due pacchetti che portano missioni, ricompense e account dei fan dentro il tuo sito, con il tuo design e senza iframe. Missioni, ricompense e accesso sono disponibili nei pacchetti. [Il tuo front end](/docs/getting-started/integration-paths#your-own-front-end).
**Commenti in stile Reddit nel feed di notizie.** Le risposte si annidano, le discussioni si comprimono, i fan possono modificare ed eliminare i propri commenti e ogni commento ha un link permanente.
**Altre due regole di ricompensa Shopify.** Premia ogni acquisto a prescindere da cosa è stato comprato, e premia per ogni unità di valuta spesa. Entrambe si aggiungono alla regola originale basata sui tag.
**La riduzione progressiva delle risorse** ha ora un conto alla rovescia e una visualizzazione più chiara prima del riscatto, così un fan vede cosa perde aspettando.
**Missioni a più passaggi.** Una sequenza che prima richiedeva diverse missioni concatenate e con requisiti di accesso ora sta in un'unica card con una sola ricompensa. Ogni passaggio è visibile fin dall'inizio. I fan abbandonavano dopo la quarta missione di una catena di cui non vedevano la fine.
**Immagini del profilo, cornici e sfondi personalizzati.** Carica i tuoi e distribuiscili tramite missioni, eventi, negozio e loot box. Vengono mostrati in classifica, nei profili, nei commenti e nella barra di navigazione.
**Riduzione progressiva delle risorse.** Una ricompensa che si riduce quanto più un fan aspetta a riscattarla. Imposta un valore iniziale, un tasso di riduzione e una soglia minima.
**Miglioramenti al negozio.** Un carosello in evidenza nella pagina principale del negozio, tag con filtri visibili ai fan, ordinamento personalizzato e filtro per disponibilità.
**Immagini sulle card delle missioni**, così ogni missione della bacheca ha la propria grafica.
**Accesso pubblico all'API.** Chiavi API per le organizzazioni che portano i dati della loro community nella propria infrastruttura. [Data API](/docs/integrations/data-api).
Endpoint in sola lettura con chiavi API per singola community, rilasciate su richiesta: membri, eliminazioni di membri, attività, saldi delle risorse, oggetti posseduti, aperture di loot box e statistiche principali. Documentati con Swagger, soggetti a limiti di frequenza e incrementali grazie a `updatedSince`, così puoi sincronizzare invece di riscaricare tutto.
**Un modello di missione per i pronostici.** Chiedi ai fan di pronosticare una partita, un cambio nella rosa o qualsiasi altra cosa abbia un esito. Le opzioni hanno le proprie immagini, le partecipazioni si bloccano all'ora che imposti e le ricompense vengono distribuite automaticamente alla risoluzione, con una notifica.
Partecipazione gratuita. Niente puntate e niente scommesse, quindi un fan non può perdere nulla.
**L'emissione e la distruzione on-chain degli oggetti da collezione sono state ritirate** quando il fornitore che le gestiva ha chiuso. Gli oggetti da collezione esistono ancora, si guadagnano ancora e vengono ancora mostrati. L'accesso con wallet e le missioni on-chain non sono interessati.
**I nomi utente ora funzionano come su Discord.** Un nome visualizzato più un suffisso nascosto di quattro cifre, così due fan possono chiamarsi entrambi `sniper` e nessuno dei due deve essere `sniper_2847`.
**Download in blocco degli invii delle missioni.** Tutti gli invii di immagini e testi di una missione in un file zip, più un CSV con chi ha inviato cosa.
**Assegnazioni di risorse in blocco** tramite caricamento di un CSV, e creazione in autonomia di una seconda valuta spendibile. Prima per entrambe serviva una richiesta a un ingegnere.
**Modalità chiara.** Impostata per community: scura, chiara o entrambe con un selettore per i fan. La modalità scura resta quella predefinita. Chiedici un parere prima di scegliere entrambe, perché con due temi c'è il doppio di tutto da controllare.
**Navigazione personalizzata.** Rinomina e riordina le sezioni, nascondi quelle che non usi e aggiungi i tuoi link verso il tuo sito web o il tuo negozio online.
**Un flusso di revisione più chiaro.** Le missioni in attesa di revisione manuale sono indicate come in attesa nella bacheca delle missioni, e le missioni con ricompense non riscattate sono più facili da trovare.
**Articoli del negozio con requisito di livello o di piano di abbonamento**, visibili ma bloccati, così la progressione ha qualcosa verso cui tendere.
**Spotify.** Collegamento dell'account più tre modelli di missione: seguire un artista, seguire una playlist e verificare gli artisti più ascoltati di un fan.
**Rinomina le funzionalità.** Le missioni possono diventare sfide, gli eventi possono diventare tornei, e il nuovo nome vale ovunque nell'app.
**Google Analytics e Tag Manager** sulla tua app.
**Immagini di sfondo per pagina** per la bacheca delle missioni, il negozio, la classifica, il profilo e le altre pagine, più font personalizzati.
**Accesso unico con Shopify.** I fan accedono con l'account che hanno già nel tuo negozio. Nessuna seconda registrazione, e i loro acquisti e i loro punti stanno sotto un'unica identità. [Shopify](/docs/integrations/shopify).
**Livelli e piani** con nomi e icone personalizzati, mostrati in classifica e nei profili, con un badge personalizzato per ogni piano di abbonamento.
**Due ricompense su una sola missione**, assegnate insieme.
**Una nuova animazione di apertura delle loot box** in missioni, eventi e battlepass.
**Collegamento del wallet Solana** con Phantom, Solflare e Backpack, più un modello di missione sul possesso di NFT.
**Annunci del bot Discord.** Pubblica in un canale quando una missione va online, un evento inizia o un evento finisce.
**Badge Premium** mostrati in classifica e nei profili, configurabili per piano.
**Un intervento importante sulla versione mobile** di feed di notizie, negozio e navigazione.
# Eventi (/it/docs/events)
Un evento è una bacheca delle missioni con intorno un cronometro e una classifica. I fan si iscrivono, competono per un periodo fisso e vengono premiati in base a dove arrivano.
## Configurare l'evento [#setting-it-up]
| Campo | Cosa fa |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| Titolo | Il nome sulla card dell'evento e in cima alla pagina dell'evento. |
| Descrizione | In cosa competono i fan e come si vince. |
| Banner | L'immagine sulla card dell'evento. |
| Periodo dell'evento | Quando l'evento inizia e finisce. |
| Periodo di iscrizione | Quando i fan possono iscriversi. |
| Requisiti | Chi può entrare: un livello, un ruolo Discord, un oggetto da collezione, un'altra missione o un piano di abbonamento. |
| Numero massimo di partecipanti | Un tetto al numero di fan che possono iscriversi. Lascialo vuoto per non avere limiti. |
L'iscrizione ha un periodo separato da quello dell'evento. Se l'iscrizione si chiude nel momento in cui l'evento si apre, ogni fan che sente parlare dell'evento il secondo giorno resta fuori. A meno che tu non stia organizzando un torneo con tabellone fisso, chiudi l'iscrizione quando si chiude l'evento.
## Scegliere il tipo [#choosing-the-type]
Il tipo decide come i fan fanno punti, e non può essere cambiato in seguito.
| Tipo | Come funziona | Quando usarlo |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Base | Scegli le missioni dalla libreria dei modelli. I fan le completano, ogni completamento vale punti e la classifica ordina per totale. | Tutto ciò che non è legato a un gioco: una settimana di lancio, un'attivazione di uno sponsor, un drop di merchandising. Funziona per ogni community. |
| A punteggio | Solo per i videogiochi. Il punteggio è dinamico e segue il gioco reale, quindi ogni uccisione o ogni vittoria vale punti, invece di un singolo completamento. | Un torneo, una sessione di gioco in parallelo a una partita, tutto ciò in cui vuoi che conti la prestazione più della partecipazione. |
| Collaborativo | Un obiettivo condiviso per tutta la community. Chiunque abbia partecipato viene ricompensato quando lo si raggiunge. | Raggiungere un numero insieme: invii raccolti, partite vinte da tutta la community, un traguardo che vuoi raggiungere come gruppo. |
Negli eventi a punteggio ogni partecipante deve aver collegato l'account di gioco pertinente prima di poter fare punti. Dillo nella descrizione, e metti in conto che il passaggio di collegamento ti costi dei partecipanti se l'evento è breve. Vedi [accesso e collegamento degli account](/docs/settings/sign-in).
Gli eventi collaborativi sono quelli da scegliere quando la tua community è abbastanza piccola da rendere scoraggiante una classifica.
## Ricompense per posizione [#rewards-by-position]
Le ricompense sono legate alle posizioni finali, e una posizione può essere un intervallo. Il primo posto riceve una cosa, dal secondo al quinto un'altra, dal sesto al cinquantesimo un'altra ancora.
Premia anche oltre il podio. Un evento in cui vengono premiati solo tre fan è un evento che il novanta per cento della tua community smette di seguire il secondo giorno. Una piccola ricompensa fino al cinquantesimo posto tiene in gara la parte centrale della classifica.
Gli eventi collaborativi danno la stessa cosa a tutti quelli che hanno partecipato, quindi c'è una sola ricompensa invece di una scala.
Le ricompense provengono dallo stesso insieme delle missioni: XP, valuta spendibile, premi, oggetti da collezione e loot box. Vedi [Creare una missione](/docs/quests/creating) per sapere cos'è ciascuna.
## Dopo la pubblicazione [#after-publishing]
Una volta pubblicato un evento si possono modificare solo il **titolo** e la **descrizione**. Il periodo, il tipo, i requisiti e le ricompense sono fissi.
Se uno di questi è sbagliato, duplica l'evento, correggi la copia e annulla la pubblicazione dell'originale prima che i fan ne vedano due. Fallo presto: un evento con partecipanti già iscritti non si può sostituire senza che qualcuno se ne accorga.
## Esportare i partecipanti [#exporting-participants]
Esporta l'elenco dei partecipanti in CSV, durante l'evento o dopo, anche da un evento archiviato.
È ciò che mandi a uno sponsor, ed è ciò che usi per consegnare i premi che richiedono l'intervento di una persona. Le ricompense personalizzate che richiedono un indirizzo di spedizione o un'email sono seguite a parte in [Ricompense personalizzate](/docs/rewards/custom-rewards).
A cosa servono gli eventi, e i tre tipi dal punto di vista di un fan, è spiegato in [Eventi](/docs/events).
# Introduzione (/it/docs)
FanBase dà alla tua community un posto in cui l'attenzione viene ripagata. I fan accedono, completano missioni, scalano una classifica, spendono ciò che guadagnano e collezionano oggetti che vale la pena tenere.
Per integrarlo nel tuo sito con il codice c'è FanBase SDK, documentato su un sito separato.
## Tre modi per gestirlo [#three-ways-to-run-it]
La piattaforma sotto è la stessa. Cambia chi possiede il front end.
La ospitiamo noi sul tuo dominio. I tuoi colori, il tuo logo e il tuo layout. Online in pochi giorni.
L'SDK dentro il tuo sito. Ogni pixel e ogni URL sono tuoi.
La progettiamo e la sviluppiamo insieme a te. Per le organizzazioni con esigenze proprie.
La maggior parte dei partner parte con l'app ospitata e passa in seguito a un front end proprio. Il pannello di amministrazione, i fan e i loro progressi restano, perché è cambiato solo il front end.
## Meccaniche gestite dal tuo team [#mechanics-your-team-runs]
Tutto ciò che un fan vede si configura nel pannello di amministrazione. Una missione è online nel momento in cui qualcuno la pubblica, senza bisogno di alcun rilascio tecnico.
Seguire, giocare, pronosticare, rispondere, inviare, acquistare. Più di 150 modelli.
Punti, premi, loot box, oggetti da collezione, ruoli Discord.
Stagioni con un percorso gratuito e un percorso Premium.
I fan spendono ciò che guadagnano. Si collega al tuo Shopify.
# Classifiche (/it/docs/leaderboards)
Una sola classifica, di sempre, con dentro tutta la community. Configurarla non ti costa nulla, e i fan la aprono senza che nessuno glielo chieda.
## Il criterio della classifica [#the-ranking-basis]
Due criteri, e ne scegli uno per community. Viene impostato quando creiamo la tua community, quindi dicci quale vuoi durante l'[onboarding](/docs/getting-started/onboarding).
| Criterio | Ordina per | Cosa premia |
| ------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| XP | Il totale degli XP guadagnati, lo stesso numero che determina i livelli | L'impegno, pesato in base al valore che hai dato a ogni missione |
| Missioni completate | Il numero di missioni portate a termine, a prescindere da quanto pagavano | L'ampiezza. Fare tutto, invece di fare le cose che valgono |
Scegli gli XP, a meno che tu non abbia un motivo per non farlo. Con la classifica per missioni completate, un fan che ha spuntato trenta missioni da un minuto batte un fan che ne ha sudate tre difficili, e i valori delle tue ricompense non segnalano più nulla. È la scelta giusta quando la tua bacheca è volutamente piatta e cerchi la partecipazione più che l'intensità.
Non c'è modo di usarli entrambi insieme, e cambiare criterio in seguito riordina la classifica sotto i piedi dei fan che si erano guadagnati il loro posto.
## Le classifiche degli eventi sono separate [#event-leaderboards-are-separate]
Ogni evento ha la propria classifica, limitata a quell'evento, che si trova nella pagina dell'evento e non qui. Ordina solo i partecipanti, conta solo ciò che conta l'evento e finisce quando finisce l'evento.
Un fan arrivato la settimana scorsa può vincere un evento senza dover prima superare un anno di XP accumulati. Vedi [Eventi](/docs/events).
## Serie [#streaks]
Le serie appartengono alle missioni, non alla classifica. Imposta una missione perché si rinnovi ogni giorno o ogni settimana, e un fan che la completa a ogni rinnovo consecutivo guadagna una ricompensa crescente fino al tetto che hai fissato. Se ne salta uno, la serie riparte da zero.
Il comportamento completo, compreso il tetto della ricompensa e cosa succede quando un fan salta un giorno, è descritto in [Creare una missione](/docs/quests/creating#set-the-advanced-properties).
Per una competizione breve e a sé stante che anche i fan più recenti possano vincere, crea un [evento](/docs/events): ti permette di definire chi compete e cosa conta, su una classifica che ha una fine.
## Azzerare i saldi [#resetting-balances]
Un azzeramento porta a zero il saldo e il livello di ogni fan, così la classifica parte vuota e i colleghi che hanno testato le tue missioni non occupano più la vetta il primo giorno.
L'azzeramento dei saldi non si può annullare, quindi fallo una volta sola, dopo i test e prima di invitare chiunque. Cosa cancella e cosa conserva è spiegato in [Azzerare i saldi](/docs/rewards/resources#reset-balance).
## Storico delle stagioni [#seasonal-history]
In valutazione
Oggi un azzeramento cancella la classifica e non resta traccia di chi era dove. Conservare le stagioni passate, così che un fan possa dimostrare di aver chiuso tra i primi dieci in una stagione ormai cancellata, è in lista. Chiedi al tuo referente FanBase a che punto è prima di pianificare una stagione su questa base, e vedi [Stato delle funzionalità](/docs/status).
# Livelli (/it/docs/levels)
I livelli sono l'unica impostazione di cui i fan notano le modifiche. Imposta bene la scala prima del lancio e non dovrai più toccarla.
## Creare un livello [#creating-a-level]
**Create level**, poi quattro campi. Tre sono obbligatori e l'icona è facoltativa.
| Campo | Cosa fa |
| ------ | ------------------------------------------------------------------------------------------------------------------ |
| Ordine | La posizione nella scala: 1, 2, 3. Decide cosa viene dopo cosa. |
| Nome | Come lo chiamano i fan. I numeri vanno bene. Vanno bene anche i nomi da Rookie a Legend, oppure nomi scelti da te. |
| XP | Il totale di XP che serve a un fan per raggiungerlo. Cumulativo, non la distanza dal livello precedente. |
| Icona | Facoltativa. Il badge mostrato accanto al nome di un fan in classifica, nei commenti e sul suo profilo. |
## Gestire la scala [#managing-the-ladder]
* **Reorder** sposta un livello più in alto o più in basso nella scala.
* **Rename** rinomina un livello. I fan vedono subito il nuovo nome.
* **Adjust XP** modifica qualsiasi soglia. I fan vengono rivalutati in base ai nuovi numeri, quindi abbassare una soglia promuove delle persone e alzarla le retrocede.
* **Reset** reimposta l'intera scala, con i nostri livelli e le nostre soglie predefiniti oppure con una scala personalizzata che costruisci da zero.
## Buone pratiche [#best-practice]
### Definisci tutto prima del lancio [#finalise-before-launch]
I fan prendono la scala come riferimento dal giorno in cui la vedono. Chi è rimasto per una settimana a trecento XP da Contender e scopre che ora Contender costa il doppio lo vive come un cambio delle regole a partita in corso.
### Allinea gli XP per missione alle tue soglie [#align-xp-per-quest-with-your-thresholds]
Decidi quanto devono durare i primi livelli, poi conta le missioni nella tua bacheca e gli XP che pagano.
Una distribuzione che funziona con la scala predefinita:
| Difficoltà della missione | XP | Esempi |
| ------------------------- | --- | ------------------------------------------------------------------------------------------------------------ |
| Semplice | 10 | Visitare un link, seguire un account, entrare nel Discord |
| Media | 25 | Guardare una diretta per un'ora, rispondere a un quiz, completare una missione giornaliera per una settimana |
| Difficile | 50 | Raggiungere un rango, giocare un certo numero di ore, inviare un lavoro vero |
| Speciale | 100 | Il finale di una campagna, la vittoria di un evento, qualcosa che succede una volta sola |
Può andare storto in due modi. Con troppi XP per missione i fan raggiungono il livello più alto in una settimana, la classifica smette di muoversi perché tutti sono al massimo e non ti resta nulla da dare a chi ci tiene di più. È l'errore più comune, e quello che non puoi correggere senza un [azzeramento dei saldi](/docs/rewards/resources#reset-balance). Con troppo pochi XP per missione la barra di avanzamento non si muove mai in modo visibile: i fan completano quattro missioni, non vedono succedere nulla e smettono.
Una verifica rapida prima del lancio: prendi le missioni che un fan motivato potrebbe completare nella sua prima sessione, somma gli XP e guarda a quale livello si arriva. Se è il più alto, le tue ricompense sono troppo grandi. Se non è il secondo, sono troppo piccole.
Vanno contate anche le missioni ricorrenti, perché una missione giornaliera da 10 XP vale da sola 3.650 XP all'anno. Sono i [tetti alle ricompense delle serie](/docs/quests/creating#set-the-advanced-properties) a tenere la cosa sotto controllo.
# Membri (/it/docs/members)
Una riga per fan, e la riga è l'intera scheda: come ha effettuato l'accesso, cosa ha collegato, cosa ha guadagnato, cosa possiede.
## Trovare un fan [#finding-a-fan]
Cerca in base al suo nome utente nell'app. I nomi utente sono in stile Discord, un nome visualizzato più un suffisso di quattro cifre, quindi più fan possono condividere lo stesso nome senza ambiguità nel pannello.
Quando hai soltanto un nome utente social, per esempio quello su X della persona che si lamenta, cerca con quello. La ricerca confronta gli account collegati e restituisce il fan che c'è dietro.
## Leggere una scheda [#reading-a-record]
Seleziona un fan, poi **Edit**.
| Sezione | Cosa mostra |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Account collegati | Tutti gli account social, di gioco e wallet che ha collegato, e quello con cui si è registrato |
| Statistiche | Il suo livello, i saldi, le missioni completate, gli oggetti posseduti, gli eventi a cui ha partecipato e gli inviti andati a buon fine |
| Zona pericolosa | Eliminare o bannare |
Eliminare o bannare un fan è definitivo e non si può annullare. L'eliminazione rimuove l'account e i suoi progressi. Fai confermare a una seconda persona prima di usare l'una o l'altra azione, e annota il motivo fuori dal pannello.
Modificare una scheda serve per le correzioni, non per il lavoro di routine. Ritoccare a mano il saldo di un fan va bene; per ritoccarne cinquanta c'è il caricamento in blocco descritto più sotto.
## Esportare l'elenco dei membri [#exporting-the-member-list]
**Export** genera un CSV con tutti i fan della community.
| Colonna | Cosa contiene |
| ------------ | ---------------------------------------------------------------------------------------------------------- |
| User ID | L'identificativo univoco del fan. È la colonna da usare come chiave se incroci questo file con i tuoi dati |
| Handle | Il suo nome utente nell'app |
| Email | Il suo indirizzo email, se ne ha fornito uno |
| Discord | Il suo nome utente Discord, se collegato |
| X | Il suo nome utente X, se collegato |
| XP | Il totale degli XP accumulati |
| Level | Il suo livello attuale |
| Total quests | Le missioni completate |
| Total items | Gli oggetti posseduti |
| Referred | Quanti fan ha invitato con successo |
| Joined at | Quando si è iscritto |
| Left at | Quando ha eliminato il suo account, se lo ha fatto |
L'esportazione è un'istantanea. È lo strumento giusto per un'esigenza occasionale: estrarre un vincitore o preparare un resoconto per uno sponsor.
Questo file contiene dati personali. Trattalo come tratti il tuo elenco clienti: conservalo nei sistemi coperti dalla tua informativa sulla privacy ed elimina la copia nella cartella dei download quando hai finito.
## Assegnazioni e addebiti in blocco [#bulk-grants-and-debits]
Una valuta può essere assegnata o addebitata a molti fan in una volta sola a partire da un CSV. Carica il file e il pannello lo esegue.
Usalo per un risarcimento dopo un disservizio, per migrare i saldi da un sistema che usavi prima, o per l'elenco dei premi di una competizione giudicata fuori dall'app.
Chiedi prima una prova in sandbox con cinque righe, perché un addebito in blocco è veloce quanto un'assegnazione in blocco. E annota cosa hai inviato e perché, dato che i saldi cambiano senza alcuna spiegazione per i fan che li ricevono.
# Feed di notizie (/it/docs/newsfeed)
Ogni post esce a nome di un autore, quindi crea i tuoi autori prima di scrivere il primo post.
## Prima gli autori [#publishers-first]
Un autore è chi firma un post, e ogni post ne ha uno.
Per crearne uno servono un nome e un'immagine del profilo.
La maggior parte dei team ne vuole più di uno. Un'organizzazione esport pubblica gli annunci a proprio nome e i contenuti di ogni giocatore professionista a nome suo, e i fan filtrano il feed per autore per seguire il giocatore che interessa loro.
Creali tutti all'inizio. Aggiungere un autore in seguito non riassegna i post già pubblicati con un altro nome.
## Creare un post [#creating-a-post]
| Elemento | Cosa fa |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Immagini | Una o più per post. |
| Video | Caricato e riprodotto nel feed. |
| Testo formattato | Titoli, grassetto, elenchi e link nel corpo del testo. |
| Link | Un link a X, YouTube o Twitch viene mostrato come contenuto incorporato e non come semplice URL, quindi il post mostra il video o il tweet direttamente. |
Il contenuto incorporato è il motivo per pubblicare qui e non solo sui social: il fan guarda la clip senza uscire dall'app, e tutto il resto della pagina è una missione.
## Limitare l'accesso a un post [#gating-a-post]
Riserva un post ai fan che si sono guadagnati il diritto di vederlo.
| Requisito | Chi entra |
| --------------------- | --------------------------------------------------------------------------------------------------------- |
| Livello | I fan che hanno raggiunto o superato un livello scelto da te |
| Ruolo Discord | I fan che hanno un ruolo nel tuo server. Richiede che [Discord](/docs/integrations/discord) sia collegato |
| Oggetto da collezione | I fan che possiedono un oggetto specifico |
| Abbonamento Premium | I fan con un piano a pagamento. Vedi [Abbonamento Premium](/docs/battlepass#premium-membership) |
I contenuti con requisiti di accesso sono una delle poche ricompense che non ti costa nulla produrre una seconda volta. Riprese dietro le quinte o un annuncio della squadra in anteprima: pubblicali con requisiti di accesso e rendono più della stessa clip pubblicata per tutti.
Non mettere requisiti di accesso su tutto. Un feed che un nuovo fan non può leggere non gli dà alcun motivo per tornare e guadagnarsi l'ingresso.
## Fissare in alto e mettere in evidenza [#pinning-and-featuring]
Fissare in alto tiene un post in cima al feed. Mettere in evidenza toglie un post dal feed per presentarlo a parte. La messa in evidenza è pensata per i post sempre validi, quelli che varrà la pena leggere anche tra tre mesi: come funziona la community, cosa sono le stagioni, da dove cominciare.
Entrambe le funzioni valgono per un post alla volta. Un feed con quattro post fissati in alto non ha più una cima.
Togli il post dalla cima quando il momento è passato. Un'anteprima fissata in alto per una partita finita la settimana scorsa dice ai fan che il feed non viene tenuto aggiornato.
## Commenti [#comments]
I fan rispondono ai post e le risposte si organizzano in discussioni, così una conversazione resta leggibile invece di diventare un elenco piatto. I fan possono modificare ed eliminare i propri commenti, e le discussioni lunghe si comprimono. Un commento modificato è segnalato come modificato. Uno eliminato lascia intatte le risposte sottostanti.
Ogni commento ha un link permanente, quindi puoi rimandare direttamente a un commento invece di descrivere fin dove scorrere.
Moderi dal pannello: rimuovi un commento che viola le tue regole, e occupati del fan in [Membri](/docs/members) se è un comportamento ricorrente e non un caso isolato.
Decidi chi modera prima del lancio, e decidilo pensando alla giornata peggiore, non a una giornata media. Le sere di partita e le novità sulla rosa generano commenti più in fretta di qualsiasi altra cosa nell'app, e un feed in cui la risposta più rumorosa è rimasta lì per tre giorni dà il tono al mese successivo.
Il voto sui commenti, positivo o negativo con ordinamento per punteggio, è già sviluppato ma disattivato per impostazione predefinita. Chiedici di attivarlo se lo vuoi. È adatto a una community grande in cui le risposte migliori devono emergere. In una community più piccola, lascialo disattivato.
# Pronostici (/it/docs/predictions)
Un pronostico chiede ai fan di scegliere un esito prima che sia noto. Il risultato di una partita, un cambio nella rosa, un punteggio, il lancio della monetina a un evento dal vivo. Le partecipazioni si chiudono all'ora che imposti, e quando la cosa accade indichi la risposta giusta e la piattaforma premia tutti quelli che l'avevano scelta.
Partecipare è gratuito. Non si punta nulla, non si scommette nulla, e un fan non può in alcun modo ritrovarsi peggio di prima di aver risposto.
## Cosa compili [#what-you-fill-in]
| Campo | Obbligatorio | Cosa fa |
| ------------- | ------------ | ----------------------------------------------- |
| Opzioni | Sì | Ciò che un fan può scegliere |
| Ora di blocco | Sì | Il momento in cui le partecipazioni si chiudono |
Ogni opzione ha tre elementi, e due puoi usarli o ignorarli a tua scelta.
| Per opzione | Obbligatorio | A cosa serve |
| ----------- | ------------ | ----------------------------------------------------------- |
| Etichetta | Sì | La risposta semplice. È su questa che risolvi il pronostico |
| Immagine | No | Mostrata a 40 px accanto all'etichetta |
| Descrizione | No | Una riga sotto l'etichetta |
**Tieni l'etichetta semplice e metti la parte interessante nella descrizione.** L'etichetta è ciò che più avanti indicherai come corretto, quindi deve restare chiara quando la rileggi settimane dopo averla scritta. «Prima maglia bianca» si può risolvere. «Quella che vogliono tutti» no. La riga sotto è il posto per «imbattuti con questa da marzo», ed è quella riga a far scegliere a un fan un'opzione invece dell'altra.
**Le immagini servono quando le opzioni sono cose che si riconoscono più in fretta di quanto si leggano.** Una colorazione, una copertina, una città. A 40 px c'è spazio per una forma e due o tre colori, quindi la foto di una folla diventa una macchia mentre il render di un prodotto resta leggibile. Sono sprecate su un punteggio, dove l'etichetta dice già tutto.
## Chi può partecipare [#who-can-enter]
Un pronostico è una missione, quindi segue le stesse regole sul pubblico di tutte le altre
missioni. Aggiungi un requisito di accesso e la card compare comunque, ma non si apre per chi
non lo soddisfa, e al fan viene spiegato perché invece di lasciarlo premere su una card che non risponde.
Un pronostico accetta tutte le condizioni descritte in [Requisiti di accesso](/docs/settings/gating), e il
requisito copre l'intera card e non solo l'invio: un fan che sceglie un esito
e solo dopo scopre di non essere mai stato idoneo ha fatto il lavoro due volte.
Due meritano una menzione a parte. **Activated users** (utenti attivati), perché partecipare è gratuito
e qualcosa che vale la pena vincere è proprio ciò che attira un account usa e getta.
**Membership** (abbonamento), perché cambia il significato del conteggio: un pronostico riservato agli
abbonati ti dice cosa pensano i tuoi fan paganti, che è una domanda diversa
da cosa pensano tutti, e di solito la più utile.
## Il blocco [#the-lock]
Le partecipazioni si chiudono all'ora di blocco e le opzioni smettono di rispondere. Prima, la card dice quando si blocca. Dopo, dice che le partecipazioni sono chiuse e indica l'ora.
**Imposta il blocco prima che l'esito possa essere noto.** È l'unica cosa che va storta. Un fan che guarda la partita può rispondere con il risultato davanti agli occhi, quindi un blocco fissato al fischio finale non è un pronostico, è una ricompensa gratuita. Il calcio d'inizio di solito è il momento giusto, e prima è più sicuro che dopo.
La piattaforma applica questa regola in base all'orologio, non alla tua risoluzione. Passato il blocco nessun altro può partecipare, che tu abbia indicato una risposta oppure no.
## Cosa vede un fan [#what-a-fan-sees]
Una sola scelta. È definitiva nel momento dell'invio, e la card lo dice invece di lasciar riprovare. Un fan che ha già risposto vede cosa ha scelto.
**La ripartizione è visibile prima di partecipare**, ed è l'unico punto in cui un pronostico si comporta diversamente da un [sondaggio](/docs/quests/templates/submission#poll). Un sondaggio nasconde il risultato finché non hai votato, così l'opinione degli altri non può influenzare la tua risposta. Un pronostico lo mostra dall'inizio, perché stare con la maggioranza o andarle contro è gran parte del motivo per partecipare.
Il numero totale di partecipazioni sta sopra le opzioni, e quella del fan si aggiunge. In un pronostico con qualche migliaio di persone, una partecipazione in più sposta quel totale e non le percentuali, ed è la cosa onesta che la card deve mostrare.
## Risolvere il pronostico [#resolving-it]
Indichi l'opzione che si è rivelata corretta. L'azione è tutta qui.
Tutti quelli che l'avevano scelta ricevono automaticamente la ricompensa e una notifica che dice che avevano ragione. Tutti quelli che avevano scelto altro ricevono una notifica che dice che non l'avevano. Nessuno perde nulla di ciò che aveva.
Finché non lo risolvi, la missione resta lì, bloccata e non pagata. Non esiste una risoluzione automatica, perché la piattaforma non ha modo di sapere cosa è successo al tuo evento.
## Quando usarne uno [#when-to-use-one]
I pronostici danno il meglio attorno a una partita in calendario, perché danno al fan un motivo per essere nell'app prima che cominci e un motivo per tornare dopo che è finita. Uno prima del calcio d'inizio e poi il risultato pubblicato nel [feed di notizie](/docs/newsfeed): è lo schema che funziona.
Funzionano poco come contenuto sempre valido. Un pronostico senza un evento alle spalle non ha una scadenza che interessi a qualcuno né un risultato su cui risolverlo.
## Cosa non è [#what-it-is-not]
Non è una scommessa. Non c'è posta in gioco, non ci sono quote e non c'è una vincita che cresce con il numero di persone che hanno sbagliato. Tutti quelli che indovinano ricevono la stessa ricompensa, ed è quella che hai impostato sulla missione, come per qualsiasi altra.
Non è un sondaggio. Metti le stesse opzioni in entrambi e cambia solo la domanda: un sondaggio chiede quale colorazione vuoi e premia tutti quelli che rispondono, un pronostico chiede quale esce venerdì e premia i fan che hanno indovinato. Il primo è una ricerca. Il secondo ha una risposta giusta che conosci già.
# Stato delle funzionalità (/it/docs/status)
Tutto ciò che non compare in questa pagina è disponibile. L'SDK riceve le funzionalità dopo l'app ospitata, perché una funzionalità deve esistere prima di poter essere inclusa in un pacchetto, e la pagina Stato delle funzionalità di FanBase SDK ne tiene traccia a parte.
## Disponibile [#live]
Tutto ciò che è in questa tabella è in produzione sull'app ospitata. La seconda colonna risponde a un'altra domanda: se la stessa funzionalità è già inclusa nell'SDK, cosa che viene seguita nella pagina Stato delle funzionalità di FanBase SDK. Volutamente non riprende le quattro etichette di stato qui sopra, perché una riga con scritto «Pianificato» in una tabella intitolata Disponibile viene letta come non sviluppata.
| Funzionalità | Nell'SDK | Note |
| -------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Account dei fan e accesso | Sì | Google, Discord, X, Twitch e Shopify. [Accesso](/docs/settings/sign-in) |
| Missioni | Sì | Più di 150 modelli tra app, social, gaming e on-chain. [Modelli di missione](/docs/quests/templates) |
| Missioni a più passaggi | Sì | Più passaggi in un'unica card, una sola ricompensa. [Missioni a più passaggi](/docs/quests/creating#multi-step-quests) |
| Pronostici | Sì | Partecipazione gratuita, con un'ora di blocco. Indichi l'esito e la ricompensa viene pagata. [Pronostici](/docs/predictions) |
| Ricompense e loot box | Sì | Punti, premi, oggetti da collezione, loot box, ruoli Discord. [Ricompense](/docs/rewards) |
| Riduzione progressiva delle risorse | Sì | Ricompense che si riducono man mano che i fan le riscattano. [Ricompense](/docs/rewards#decaying-rewards) |
| Eventi | Sì | Base, a punteggio e collaborativi. [Eventi](/docs/events) |
| Classifiche | Sì | Di sempre, per punti o per missioni completate. [Classifiche](/docs/leaderboards) |
| Battlepass con stagioni | Sì | Percorsi gratuito e Premium, stagioni che puoi duplicare. [Battlepass](/docs/battlepass) |
| Negozio | Sì | Spendere la valuta guadagnata, con requisiti di accesso per livello o abbonamento. [Negozio](/docs/store) |
| Limiti di acquisto nel negozio | Non ancora | Quanti esemplari di un articolo può acquistare un singolo fan, con un valore separato per i fan del piano gratuito e i fan Premium. [Negozio](/docs/store#purchase-limits) |
| Feed di notizie | Sì | Post, reazioni, commenti organizzati in discussioni. [Feed di notizie](/docs/newsfeed) |
| Abbonamento Premium | No | Abbonamenti Stripe o pagamento unico, al prezzo che decidi tu. [Battlepass](/docs/battlepass#premium-membership) |
| Personalizzazione del profilo | Sì | Immagini del profilo, cornici e sfondi come ricompense. [Oggetti da collezione e personalizzazione](/docs/rewards/collectibles) |
| Avatar 3D e oggetti indossabili | Sì | Un componente aggiuntivo, non attivo su tutte le app. [Avatar 3D](/docs/rewards/avatars-3d) |
| Accesso con Shopify | Non applicabile | I fan usano il loro account del negozio. [Shopify](/docs/integrations/shopify) |
| Regole di ricompensa Shopify | Non applicabile | Premia qualsiasi acquisto, gli acquisti con tag o ogni unità spesa. [Shopify](/docs/integrations/shopify#reward-rules) |
| Ordini Shopify dagli acquisti nell'app | Sì | Un articolo del negozio acquistato con i punti diventa un ordine pagato nel tuo Shopify, con l'indirizzo di consegna del fan. [Shopify](/docs/integrations/shopify#spending-points-back-into-shopify) |
| Annunci Discord | Non applicabile | Missioni ed eventi annunciati sul tuo server. [Discord](/docs/integrations/discord) |
| Data API | Non applicabile | Leggi i dati della tua community con una chiave API. [Data API](/docs/integrations/data-api) |
| Statistiche | Non applicabile | Membri, coinvolgimento e rendimento delle missioni. [Statistiche](/docs/analytics) |
| Tema e navigazione | Non applicabile | Colori, font, sfondi, modalità chiara e scura, ordine ed etichette della navigazione. [Generale](/docs/settings/general) |
| Lingue | Sì | Cinque lingue. Vedi [Lingue](/docs/settings/general#languages). |
## In sviluppo [#in-build]
| Funzionalità | Note |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Livelli di stagione | Un secondo insieme di livelli che si azzera a ogni stagione del battlepass, accanto a quelli permanenti. Una nuova stagione farà ripartire tutti alla pari, senza cancellare il livello che un fan di lunga data si è guadagnato. |
| Un motivo per ogni assegnazione manuale | Assegnare o addebitare valuta a mano richiederà un motivo e terrà una cronologia di chi ha fatto cosa e perché. [Membri](/docs/members#bulk-grants-and-debits) |
| Distribuzione di codici | Carica un lotto di codici sconto o codici regalo e distribuiscili come ricompense, con consegna via email. |
| Varianti e SKU nel negozio | Taglie e colori sugli articoli del negozio, associati alle varianti Shopify. |
| Rinnovo del pannello di amministrazione | Una revisione grafica del pannello di amministrazione. Nessun cambiamento nel funzionamento. |
| Blocchi per la vetrina Shopify | Le missioni, il profilo di un fan, il suo avatar e un indicatore dell'account come blocchi da aggiungere al tuo tema Shopify, senza codice. Il rilascio parte dai negozi pilota. [Shopify](/docs/integrations/shopify#on-your-storefront) |
| Altri annunci Discord | Post del feed di notizie, modifiche al negozio e vincitori degli eventi, in aggiunta agli annunci di missioni ed eventi che esistono già. [Discord](/docs/integrations/discord) |
## Pianificato [#planned]
Più o meno in ordine di priorità. Le date non sono confermate finché qualcosa non passa a In sviluppo.
| Funzionalità | Note |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Badge dei traguardi | Traguardi che un fan ottiene e fissa sul suo profilo, separati dai livelli. |
| Bonus di punti e XP | Moltiplicatori a tempo limitato, venduti nel negozio o distribuiti tramite le missioni. |
| Ricompense scaricabili | Sfondi e pacchetti di contenuti consegnati al riscatto, senza l'intervento di una persona. |
| Riduzione progressiva nel tempo | Ricompense che si riducono con il passare del tempo e mostrano un conto alla rovescia, accanto alla riduzione per riscatto già disponibile oggi. [Ricompense](/docs/rewards#decaying-rewards) |
| Calendario | Il calendario delle tue partite e dei tuoi eventi dentro l'app. |
| Gestione ordinaria del negozio | Archiviazione degli articoli, scorrimento infinito, acquisto in blocco. |
| Creazione della community in autonomia | Registrati, configura e ottieni le tue chiavi senza il nostro intervento. |
| Altri modelli di missione | Prima la verifica dei mi piace e dei follow su Instagram, poi altri modelli per Discord e per Twitch. [Modelli di missione](/docs/quests/templates#asking-for-a-template-or-a-game) |
## In valutazione [#exploring]
| Voce | Note |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Presenza sullo Shopify App Store | Installare FanBase direttamente da Shopify. Oggi gestiamo un'app Shopify personalizzata per ogni negozio, cosa che funziona bene con i numeri attuali. |
| Un assistente nel pannello di amministrazione | Chiedere una missione o un report in linguaggio naturale invece di compilare un modulo. |
| Webhook | Inviare gli eventi ai tuoi sistemi nel momento in cui accadono, invece di farti interrogare periodicamente la Data API. |
| Storico delle classifiche per stagione | Conservare le stagioni passate dopo un azzeramento dei saldi, invece della sola classifica attuale. |
## Ritirato [#retired]
Non fanno più parte del prodotto.
| Funzionalità | Cosa è successo |
| ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Widget incorporabili e iframe | Sostituiti dall'SDK, che fa lo stesso lavoro senza un aspetto fisso e senza iframe. Vedi [Scegliere un'integrazione](/docs/getting-started/integration-paths#widgets). |
| Emissione e distruzione on-chain degli oggetti da collezione | Ritirate a metà 2026, quando il fornitore sottostante ha chiuso. Nulla di ciò che un fan possedeva è andato perso: gli oggetti da collezione si guadagnano, si possiedono, si mostrano e si usano ancora come requisiti delle missioni, conservati nella tua community e non su una blockchain. Nessuna impostazione li riporta su una blockchain, e non esiste un marketplace fuori dall'app. Il collegamento del wallet, l'accesso con wallet e le missioni on-chain non sono interessati. Vedi i modelli [On-chain](/docs/quests/templates/on-chain). |
| Pagine link in bio per creator | Provate, poi ritirate. |
| Verifica di iscrizioni e mi piace su YouTube | Ritirata perché verificarli richiede un accesso all'account di un fan molto più ampio di quanto siamo disposti a chiedere. I modelli di visita e di visione restano. Vedi [YouTube](/docs/quests/templates/social/youtube). |
## Chiedere una funzionalità [#asking-for-something]
Di' al tuo referente FanBase quali funzionalità contano per te. Teniamo un elenco interno di priorità e sono le esigenze dei partner a dargli forma, quindi dirci cosa stai aspettando è ciò che fa salire una voce in elenco.
Vale anche per tutto ciò che non compare in questa pagina. Se hai un'idea, condividila. Di solito la questione non è se una cosa si può sviluppare, ma quando potrebbe realisticamente essere disponibile, e sapere che la vuoi è ciò che le fa avere una data.
# Negozio (/it/docs/store)
Se gestisci una valuta spendibile, dai ai fan un posto dove spenderla. I fan si accorgono nel giro di una settimana circa se il loro saldo permette di comprare qualcosa. Tutto ciò che c'è in questa pagina si configura nel pannello di amministrazione.
## Articoli che puoi mettere in vendita [#items-you-can-list]
| Articolo | Cosa ottiene il fan |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Premi e ricompense personalizzate | Qualcosa fuori dall'app: una carta regalo, un codice, merchandising, un biglietto. Si riscatta come il premio di una missione |
| Oggetti da collezione | Un oggetto di sua proprietà |
| Oggetti di personalizzazione | Un'immagine del profilo, una cornice o uno sfondo che può applicare al profilo |
| Loot box | Una possibilità di ottenere ciò che c'è dentro |
Ogni tipo è descritto in [Ricompense](/docs/rewards). Il negozio aggiunge una seconda strada verso gli stessi articoli: guadagnarli oppure comprarli.
## Prezzi [#pricing]
Gli articoli hanno un prezzo nella tua valuta spendibile, non in denaro. Imposti tu il numero per ogni articolo.
Fissa i prezzi in base a ciò che un fan guadagna, non in base a quanto l'articolo costa a te. Calcola più o meno quanto guadagna in una settimana un fan attivo, poi decidi quante settimane deve richiedere l'articolo più economico. Se tutto ciò che c'è sullo scaffale è lontano un mese, i fan smettono di aprire il negozio. Se tutto è alla portata il secondo giorno, lo scaffale è vuoto il terzo e hai insegnato ai fan che i punti non valgono nulla.
Lascia margine in alto. Un articolo che quasi nessuno può permettersi dà ai fan in cima alla tua classifica qualcosa per cui risparmiare.
## Requisiti di accesso [#gating]
Due requisiti, e si sommano.
| Requisito | È soddisfatto quando il fan |
| -------------------- | ---------------------------------------------------------------------------------------- |
| Livello | Ha raggiunto un livello scelto da te |
| Piano di abbonamento | Ha un piano a pagamento. Vedi [Abbonamento Premium](/docs/battlepass#premium-membership) |
Un articolo bloccato resta visibile, con il motivo per cui è bloccato.
## Scorte e disponibilità limitata [#stock-and-limited-supply]
Imposta una quantità e l'articolo va esaurito. I fan possono filtrare lo scaffale per vedere solo ciò che è ancora disponibile.
Due cose da pianificare prima di mettere in vendita qualcosa di raro. Decidi se preferisci che vada al fan più veloce o a quello più coinvolto, perché scorte illimitate con un requisito di livello danno un risultato diverso da scorte limitate senza requisiti. E verifica la tua logistica: cinquanta articoli fisici venduti in una mattina sono cinquanta indirizzi che qualcuno del tuo team deve gestire.
## Limiti di acquisto [#purchase-limits]
Le scorte limitano quanti esemplari di un articolo esistono. Un limite di acquisto limita quanti ne può comprare un singolo fan.
Su ogni articolo del negozio, **Purchase limit per cohort** (limite di acquisto per gruppo) accetta un numero per ogni piano di abbonamento: uno per i fan del piano gratuito, uno per i fan Premium.
| Inserisci | Cosa succede |
| --------- | ----------------------------------------------------------------------------- |
| Un numero | Un fan di quel piano può acquistare l'articolo quel numero di volte, in tutto |
| Niente | Nessun limite per quel piano |
Il limite vale per tutta la vita dell'account del fan. Non si azzera ogni mese né ogni stagione, quindi un limite di uno significa uno.
I fan lo vedono sull'articolo: «Limite: 2 per utente», accanto a ciò che ottiene l'altro piano. Quando un fan ha esaurito il suo, l'articolo mostra «Limite di acquisto raggiunto» e non può più essere acquistato.
Serve a tre cose:
* **Un drop equo.** Cinquanta maglie autografate e un limite di uno significano che cinquanta fan ne ricevono una, mentre senza limite i primi tre fan le prendono tutte
* **Un motivo per passare a Premium.** I fan del piano gratuito possono acquistarne uno, i fan Premium tre. L'articolo mostra entrambi i numeri, quindi un fan del piano gratuito vede cosa ottiene con il passaggio.
* **Proteggere qualcosa di costoso.** Un limite su un articolo di grande valore impedisce a un fan con un saldo elevato di fare piazza pulita
Impostalo prima che l'articolo vada online. Abbassare un limite in seguito non toglie nulla a un fan che ne ha già acquistati di più.
## Tag e filtri [#tags-and-filters]
Assegna dei tag agli articoli e i fan avranno dei filtri nel negozio. Abbigliamento, Digitale, Sponsor, Giorno di partita. I fan possono anche ordinare e filtrare per prezzo e per disponibilità.
Assegna i tag in base alla natura dell'articolo e non all'argomento, come fai con le [missioni](/docs/quests/tags). Sei tag che un fan capisce valgono più di venti che descrivono le tue categorie interne.
## Ordinamento e carosello in evidenza [#sorting-and-the-featured-carousel]
I fan possono ordinare dal più economico, dal più costoso e dal più recente. L'ordine predefinito è il tuo: disponi lo scaffale nel pannello di amministrazione ed è quello che un fan vede per primo.
Usalo. L'ordine predefinito è la posizione più preziosa che hai, e se non lo tocchi mette in cima ciò che ti è capitato di creare per primo.
Sopra lo scaffale c'è un **carosello in evidenza**. Ogni slide ha un'immagine di sfondo, un titolo, una breve descrizione e un invito all'azione, e il carosello scorre da solo. È il posto giusto per un drop, un'attivazione di uno sponsor o l'unico articolo che vuoi davvero far comprare ai fan questa settimana.
## Cronologia degli acquisti [#purchase-history]
Ogni acquisto viene registrato, e i fan possono vedere i propri in Impostazioni. Il tuo lato si trova nel pannello di amministrazione, accanto ai riscatti da missioni ed eventi, così un unico elenco ti dice cosa evadere, che il fan lo abbia guadagnato o comprato. Vedi [Ricompense personalizzate](/docs/rewards/custom-rewards).
## Varianti e SKU [#variants-and-skus]
In sviluppo
Taglie e colori staranno su un unico articolo del negozio, associati alle varianti corrispondenti nel tuo catalogo Shopify. Oggi una M e una L sono due articoli distinti, ciascuno con le proprie scorte.
## Collegare il tuo negozio [#connecting-your-store]
Il negozio descritto sopra funziona interamente sulla piattaforma. Collegare Shopify lo unisce al negozio online che hai già, in due direzioni indipendenti l'una dall'altra.
**Gli acquisti nel tuo Shopify vengono premiati nell'app.** È già disponibile. Un fan compra qualcosa nel tuo negozio Shopify e le regole di ricompensa gli assegnano XP, valuta o un oggetto da collezione senza l'intervento di nessuno. Scegli tu se questo scatta sui prodotti con tag, su qualsiasi acquisto o in proporzione a quanto ha speso.
**Spendere punti nell'app crea un vero ordine Shopify.** Anche questo è già disponibile. Attiva **Fulfil via Shopify** (evasione tramite Shopify) su un articolo del negozio e scegli il prodotto e la variante che rappresenta. Quando un fan lo acquista con i punti, nel tuo Shopify compare un ordine associato alla sua scheda cliente, già pagato, con l'indirizzo di consegna che ha inserito. Il tuo negozio Shopify va autorizzato ancora una volta per gli ordini prima del primo.
Entrambe le direzioni sono spiegate campo per campo in [Shopify](/docs/integrations/shopify).
# Scegliere un'integrazione (/it/docs/getting-started/integration-paths)
La piattaforma è la stessa in tutti e tre i casi. I fan, le missioni, la verifica, le ricompense e il pannello di amministrazione non cambiano. Cambia chi possiede il front end, ed è questo a decidere quanto in fretta lanci e fin dove puoi spingere il design.
## App ospitata [#hosted-app]
Gestiamo noi l'applicazione e la serviamo sul tuo dominio, e tu la configuri nel pannello di amministrazione perché ti assomigli: logo, immagine di copertina e immagini di sfondo per pagina, un colore d'accento che ritorna in tutta l'interfaccia, font, raggio degli angoli e spaziature, quali funzionalità compaiono nella navigazione e in che ordine, come si chiama ogni funzionalità (le missioni possono diventare «sfide»), tema chiaro o scuro, e quali lingue vengono offerte. Il layout di una pagina e la forma dei componenti che contiene restano i nostri, e un design system da rispettare alla lettera è ciò che porta un partner alla modalità successiva. La configurazione in sé richiede giorni, da due a quattro settimane contando contenuti, grafiche e un piano di lancio, e da due a tre mesi nelle organizzazioni più grandi, con revisione legale e schermate di onboarding personalizzate. Questa modalità è adatta a un hub per i fan che è una destinazione a sé, gestito da un team community che non ha tempo di sviluppo a disposizione.
## Il tuo front end [#your-own-front-end]
Costruisci l'interfaccia nel tuo codice con FanBase SDK e la ospiti tu. Due pacchetti npm ti danno il client API, la macchina a stati delle missioni, i testi di interfaccia e componenti React senza stile, quindi tutto ciò che un fan vede vive nelle tue route e nei tuoi componenti, renderizzato dal tuo design system, senza fogli di stile FanBase e senza iframe. La verifica, l'assegnazione delle ricompense e le regole che stabiliscono quando una missione può essere inviata restano sulla piattaforma, quindi non devi reimplementare il controllo che accerta se qualcuno ha davvero seguito l'account. Una prima versione con accesso, elenco delle missioni, vista di dettaglio e riscatto richiede circa un giorno di lavoro di uno sviluppatore, o più o meno un'ora se affidi i prompt forniti con l'SDK a un agente di programmazione e rivedi il diff. Questa modalità è adatta al coinvolgimento dentro un sito che hai già, a una campagna che deve stare in una sola pagina, o a qualsiasi team il cui design system non è negoziabile.
Tutta la parte tecnica è su FanBase SDK. [Integrala nel tuo sito](/docs/getting-started/integration-paths) spiega quando passare e cosa si conserva.
## Sviluppo su misura [#bespoke-build]
Progettiamo e costruiamo l'esperienza insieme a te, sulla stessa piattaforma, con un team assegnato al tuo account. Questa modalità è adatta alle organizzazioni che hanno linee guida di brand proprie, un ufficio acquisti, requisiti di accessibilità e una roadmap su cui vogliono avere voce. Parlane con il tuo referente FanBase prima di dare per scontato che sia la strada giusta, perché le due modalità precedenti coprono la maggior parte dei casi con una frazione dello sforzo.
## Confronto [#comparing-them]
| Cosa cambia | App ospitata | Il tuo front end | Sviluppo su misura |
| --------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------- | ------------------- |
| Chi scrive il front end | Noi | Tu | Noi, con te |
| Sviluppo richiesto da parte tua | Nessuno | Uno sviluppatore, per poco tempo | Nessuno |
| Controllo sul design | Personalizzabile con un tema | Totale | Totale |
| Tempo per il primo lancio | Da giorni a settimane, mesi con revisione legale | Da ore a giorni | Da settimane a mesi |
| Vive nel tuo sito esistente | No | Sì | A scelta |
| Pannello di amministrazione | Sì | Sì | Sì |
| Tutte le funzionalità disponibili | Sì | Quelle presenti nei pacchetti, vedi lo [stato delle funzionalità](/docs/status) | Sì |
## Usarne più di una [#running-more-than-one]
È supportato, ed è sempre più spesso la risposta normale. Tieni l'app ospitata come hub per i fan e usa l'SDK per mettere tre missioni su una pagina di lancio di un prodotto o in un match center.
Stessa community, stessi fan, un solo registro dei progressi. Un fan che accede dall'una o dall'altra superficie è lo stesso fan, con gli stessi punti.
## Widget [#widgets]
I widget non fanno parte del prodotto. L'SDK fa lo stesso lavoro senza un aspetto fisso, e senza mettere un iframe tra te e i tuoi fan.
Se hai un contratto precedente che cita i widget, parla con il tuo referente FanBase del passaggio all'SDK.
# Strategia di lancio (/it/docs/getting-started/launch-strategy)
Il modo in cui lanci conta più della data di lancio. I quattro approcci qui sotto si combinano bene, e il tuo referente FanBase può pianificare il calendario dei contenuti attorno a quelli che scegli.
## Crea prima una lista d'attesa [#build-a-waitlist-first]
Una landing page con un modulo di iscrizione, da due a quattro settimane prima. Ti dice quanto è grande il pubblico prima che tu ti impegni su una data di lancio, e ti lascia una lista di indirizzi email. L'attesa stessa fa sembrare l'app qualcosa per cui vale la pena presentarsi.
Metti online la pagina presto e promuovila ovunque sei già presente: social, newsletter, dirette, sito web. Offri a chi entra nella lista d'attesa qualcosa di concreto per essersi iscritto in anticipo, e tienilo aggiornato durante l'attesa perché la lista non si raffreddi.
Team BDS ha raccolto oltre cinquemila iscrizioni alla lista d'attesa promuovendo la sua app durante le dirette delle partite e sui social.
## Accesso anticipato riservato [#gated-early-access]
Apri prima a un gruppo ristretto, su una pagina di iscrizione protetta da link monouso. Ricevi feedback mentre il pubblico è indulgente, e i tuoi fan più fedeli hanno la sensazione di essere arrivati per primi.
La maggior parte dei team esport e delle community gaming che abbiamo lanciato ha scelto questa strada. È l'opzione più sicura: scopri quali missioni hanno bisogno di un testo più chiaro e quali ricompense i fan vogliono davvero mentre a guardare sono cinquanta persone, e non cinquantamila.
I fan dell'accesso anticipato non sono un campione rappresentativo. Sono i tuoi fan più coinvolti e finiranno in un giorno tutto quello che pubblichi. Tieni pronta una seconda ondata di contenuti.
## Lancia in un momento che conta [#launch-on-a-moment]
Lega il lancio a qualcosa che sta già attirando l'attenzione. Un torneo, l'apertura della stagione, la presentazione della rosa, un anniversario, una grande partita.
Team Liquid ha lanciato durante la Race to World First e ha attirato migliaia di fan in pochi giorni rimandando all'app durante le sue dirette. Ha funzionato perché qualcuno con un pubblico ha detto ai fan di andarci, più volte, mentre stavano già guardando.
Un momento così ti dà un picco. Tieni attive missioni giornaliere e settimanali, così chi arriva ha un motivo per tornare il martedì.
## Coinvolgi partner e sponsor [#bring-partners-and-sponsors]
La tua app è uno spazio che puoi vendere. Gli sponsor possono finanziare le ricompense, i brand possono fornire i premi, ed entrambi estendono la tua portata oltre il pubblico che hai già.
| Canale | Cosa porta |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Attivazioni degli sponsor | Missioni in co-branding, prodotti dello sponsor come ricompense, codici sconto per il suo negozio. |
| I tuoi giocatori e creator | Un giocatore professionista che rimanda all'app durante una diretta converte meglio di qualsiasi post che scriverai. Dai loro un motivo: una missione che li riguarda, una ricompensa scelta da loro, una classifica a cui tengono. |
| Altre community | Promozione incrociata con team, tornei e piattaforme del tuo ecosistema. |
Ninjas in Pyjamas ha realizzato una partnership con Fila che regalava oggetti da collezione esclusivi a marchio Fila ai primi tremila fan dell'accesso anticipato. Le iscrizioni sono aumentate durante il periodo promozionale, e la partnership ha aperto la strada ad altre campagne.
## Qualunque cosa tu scelga [#whichever-you-pick]
* Prepara abbastanza contenuti perché un fan non riesca a finirli il primo giorno, cioè [da venti a trenta missioni](/docs/quests/designing-a-board#publish-twenty-to-thirty-at-launch)
* Prevedi una missione giornaliera, così c'è un motivo per tornare
* Decidi chi revisiona gli invii di immagini e testi, e in quanto tempo
* Prova su un telefono, perché la maggior parte dei tuoi fan ne usa uno
* [Azzera i saldi](/docs/rewards/resources#reset-balance) dopo i test interni e prima che arrivino i fan
* Prepara la seconda ondata di contenuti prima che esca la prima
# Onboarding (/it/docs/getting-started/onboarding)
Un lancio richiede da pochi giorni a qualche mese. Il lavoro sulla piattaforma è questione di giorni. Tutto il resto è contenuti, grafiche, revisione legale e decidere cosa vuoi davvero che facciano i fan.
Un referente FanBase dedicato segue con te la sequenza qui sotto. Ogni passaggio indica quale parte ne è responsabile.
## Cosa ci serve da te [#what-we-need-from-you]
Raccogli questi elementi presto. Ognuno, prima o poi, ha bloccato un lancio.
| Cosa ci serve | Dettaglio |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Dominio | L'indirizzo su cui vive l'app, per esempio `hub.yourclub.com`. Aggiungi un record DNS che ti indichiamo noi. |
| Materiali del brand | Logo, immagine di copertina, grafiche di sfondo, colore d'accento. Le dimensioni sono nelle impostazioni, alla pagina [Generale](/docs/settings/general). |
| Metodi di accesso | Quali tra Google, Discord, X, Twitch e Shopify usano i fan per entrare. |
| Dominio del negozio Shopify | Se colleghi un negozio, l'indirizzo originale `.myshopify.com`, non quello personalizzato. |
| Lingue | Quali delle lingue supportate vuoi offrire. |
| Criterio della classifica | XP o missioni completate. Viene definita quando creiamo la tua community, e cambiarla in seguito sposta fan che si sono guadagnati la loro posizione. Vedi [Classifiche](/docs/leaderboards). |
| Team di amministrazione | Nomi e indirizzi email di tutte le persone che devono avere accesso, e il ruolo che serve a ciascuna. |
| Pagine legali | La tua informativa sulla privacy e i tuoi termini, oppure la decisione di usare i nostri. |
| Elenco di fan esistente | Se stai migrando delle persone, un CSV. Chiedici il formato prima di esportare. |
## Cosa ti inviamo [#what-we-send-you]
| Cosa ricevi | Dettaglio |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Accesso al pannello di amministrazione | Prima su una sandbox, poi in produzione. |
| Gli identificativi della tua community | Tenant (l'ID della tua organizzazione sulla piattaforma), slug della community e ID dell'app. Servono al tuo sviluppatore per l'SDK. |
| Un ambiente sandbox | Una copia completa della tua app, da rompere senza rischi. |
| Link di installazione Shopify | Se colleghi un negozio. Scade dopo circa una settimana, quindi usalo appena arriva. |
| Chiave della Data API | Su richiesta, per portare i dati della tua community nei tuoi sistemi. Vedi [Data API](/docs/integrations/data-api). |
## I passaggi [#the-steps]
### Riunione di avvio e demo del pannello [#kickoff-and-a-panel-demo]
Una demo della piattaforma, poi il pannello di amministrazione aperto davanti al tuo team. Porta le persone che lo gestiranno ogni giorno, non solo chi ha firmato. I team che lanciano bene sono quelli il cui community manager ha già creato dieci missioni prima del giorno del lancio.
Qui concordiamo le tappe e una data di lancio obiettivo.
### Creiamo la tua community [#we-build-your-community]
Creiamo la tua community e la sua configurazione. Colleghiamo i tuoi provider di accesso. Ti consegniamo una sandbox.
Oggi è una configurazione manuale da parte nostra, quindi metti in conto un paio di giorni e avvisaci presto se il dominio è insolito. La creazione in autonomia è pianificata. Vedi lo [stato delle funzionalità](/docs/status).
### La configuri e la riempi [#you-configure-and-fill-it]
La parte che richiede davvero tempo, e la parte che puoi fare solo tu.
Imposta il tuo branding e la navigazione. Decidi la tua economia: come si chiamano gli XP, se usi una valuta spendibile e cosa significa un livello. Crea le tue prime missioni. Assegna loro i tag. Configura le ricompense. Rifornisci il negozio. Scrivi i testi che leggono i fan.
Punta ad avere [da venti a trenta missioni al lancio](/docs/quests/designing-a-board#publish-twenty-to-thirty-at-launch), di difficoltà diverse.
### Collega ciò che usi già [#connect-what-you-already-run]
[Shopify](/docs/integrations/shopify), così gli acquisti fanno guadagnare punti e i punti valgono qualcosa. [Discord](/docs/integrations/discord), così missioni ed eventi si annunciano da soli. [Google Analytics o Tag Manager](/docs/analytics#web-analytics), così le iscrizioni possono essere attribuite alla campagna che le ha pagate.
### Prova, poi azzera [#test-then-reset]
Noi testiamo in produzione prima che venga invitato qualcuno. Dovresti farlo anche tu, con il tuo team, su un telefono e su un portatile, sia in tema chiaro sia in tema scuro se li offri entrambi.
Poi cancella i saldi creati dai tuoi test, prima che arrivino i fan e non dopo. Vedi [Azzerare i saldi](/docs/rewards/resources#reset-balance).
### Lancio [#launch]
Accesso anticipato riservato oppure lancio pubblico. [Strategia di lancio](/docs/getting-started/launch-strategy) descrive le opzioni e quali hanno funzionato.
Monitoriamo la piattaforma per tutto il giorno del lancio e possiamo promuoverlo insieme a te.
### Dopo il lancio [#after-launch]
Il tuo referente FanBase resta sul tuo account. La maggior parte dei partner mantiene una chiamata periodica per idee di contenuto e pianificazione delle campagne, perché è un flusso costante di nuove missioni e nuovi post a far tornare i fan.
## Tempi [#timelines]
Numeri onesti, presi da lanci reali e non dal caso migliore.
| Fase | Durata |
| --------------------------------------------------------------------------------------------- | ---------------------- |
| Configurazione della piattaforma da parte nostra | Da uno a tre giorni |
| Configurazione e contenuti da parte tua | Da una a tre settimane |
| Un club con schermate di onboarding personalizzate, revisione legale e migrazione del negozio | Da due a tre mesi |
| Una community senza lavoro su misura, che riusa una configurazione esistente | Meno di un giorno |
La variabile non è quasi mai il software. Sono le grafiche, le approvazioni e decidere cosa deve premiare una missione.
## Se costruisci il tuo front end [#if-you-are-building-your-own-front-end]
I passaggi uno, due, quattro e sette sono gli stessi. Salti la configurazione dell'app, e il tuo sviluppatore subentra dopo il passaggio due con gli identificativi che inviamo.
Indirizzalo alla guida rapida di FanBase SDK. Le missioni si creano comunque nel pannello di amministrazione, quindi al tuo team community serve comunque il passaggio tre.
# Quanto costa (/it/docs/getting-started/pricing)
Il prezzo viene definito con un preventivo per ogni collaborazione, perché le tre modalità di integrazione comportano quantità di lavoro molto diverse da parte nostra. La base e i componenti aggiuntivi sono elencati qui sotto, così un preventivo arriva senza sorprese.
Per avere una cifra, [prenota una chiamata](https://calendly.com/gauthier-/meet). Di solito un'app ospitata standard si può quotare già in quella prima chiamata.
## Incluso in ogni piano [#included-in-every-plan]
| Incluso | Cosa copre |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La piattaforma | Tutte le funzionalità di coinvolgimento descritte in questa documentazione. Missioni, eventi, classifiche, ricompense, loot box, battlepass, negozio, feed di notizie e l'intera libreria di modelli. Le funzionalità arrivano a tutti appena escono, senza costi aggiuntivi. |
| Il pannello di amministrazione | Missioni ed eventi illimitati, tutto il tuo team come amministratori, accesso basato sui ruoli, statistiche ed esportazione dei dati. |
| Hosting e gestione operativa | Infrastruttura, dominio personalizzato, certificati, monitoraggio e aggiornamenti. Niente da distribuire e niente da correggere. |
| Assistenza | Un referente dedicato, monitoraggio con correzioni in ordine di gravità, e un canale Discord o Slack in cui è presente il nostro team. |
| La partnership | Supporto per onboarding e lancio, strategia dei contenuti, idee per le missioni e pianificazione delle campagne. I partner che la sfruttano ottengono numeri migliori di quelli che non lo fanno. |
## Le variabili di un preventivo [#the-variables-in-a-quote]
| Variabile | Come incide sul prezzo |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Modalità di integrazione | L'app ospitata è la base. Con il tuo front end lo sforzo passa a te e il prezzo ne tiene conto. Lo sviluppo su misura è un progetto a sé. |
| Dimensione della community | Il prezzo si basa sui fan attivi, non sui follower o sulle iscrizioni. |
| Durata dell'impegno | Le durate più lunghe ottengono un prezzo migliore. Sono disponibili collaborazioni brevi, per una sola campagna, che non richiedono un contratto pluriennale. |
| Componenti aggiuntivi | L'elenco qui sotto. |
Vale la pena chiedere delle collaborazioni brevi. Un singolo torneo, il lancio di un prodotto o una campagna estiva non hanno bisogno di un contratto annuale, e l'SDK ha abbassato i costi abbastanza da permetterci di offrirle.
## Componenti aggiuntivi [#add-ons]
Hanno un prezzo a parte perché non tutti li vogliono.
| Componente aggiuntivo | Cosa copre |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Avatar 3D e oggetti indossabili | Un avatar del fan che colleziona oggetti con il tuo marchio, sbloccati tramite missioni, eventi e loot box. C'è un avatar standard e la possibilità di un personaggio personalizzato creato per te. Gli oggetti indossabili sono prodotti dal nostro team 3D con cadenza mensile. Le condizioni sulla proprietà intellettuale cambiano tra l'avatar standard e uno personalizzato, quindi fattele mettere per iscritto. |
| Design e creatività | Flussi di onboarding personalizzati, schermate su misura e grafiche con il tuo marchio oltre la configurazione standard. |
| Gestione della community | Pianificazione del calendario dei contenuti, ideazione delle campagne e reportistica, svolte insieme al tuo team. |
| Migrazione | Importazione di una base di fan esistente con i relativi saldi. |
Avatar e oggetti indossabili sono un componente aggiuntivo e non sono attivi su tutte le app. Prima di costruirci attorno una stagione, verifica con il tuo referente FanBase che siano compatibili con il tuo piano e con i tuoi tempi.
## Ricavi dai fan [#fan-facing-revenue]
Separati da ciò che paghi a noi, e restano a te.
Puoi vendere un abbonamento Premium dentro la tua app tramite Stripe, come abbonamento ricorrente o come pagamento unico, nella tua valuta e con i tuoi tempi. I fan Premium possono avere missioni esclusive, ricompense migliori, post con requisiti di accesso e un badge. Il prezzo e i vantaggi li decidi tu. Vedi [Abbonamento Premium](/docs/battlepass#premium-membership).
Collegare il tuo negozio Shopify è l'altra metà. I fan guadagnano punti comprando e spendono punti in cose che vale la pena avere, e questo ciclo si ripaga da solo. Vedi [Shopify](/docs/integrations/shopify).
{/* Nascosto, in attesa di una decisione sul mantenimento di questa sezione.
## Domande frequenti [#common-questions]
Per un'app ospitata standard, no. Gli sviluppi su misura e le migrazioni vengono quotati come progetti.
La dimensione della community è un fattore del preventivo, non un contatore che ti riserva sorprese. Chiedi al tuo referente FanBase dove si collocano le fasce per il tuo piano.
Passi al tuo front end con l'SDK. La community, i fan, i loro progressi e il pannello di amministrazione restano tutti. Cambia solo il front end, quindi è un progetto e non una migrazione.
Sì. Esporta i tuoi membri e la loro attività dal pannello di amministrazione in qualsiasi momento, oppure scaricali in modo continuo con la [Data API](/docs/integrations/data-api).
Le durate variano. I contratti pluriennali non sono obbligatori, ed esistono collaborazioni della durata di una campagna. Chiedi la durata più breve adatta a ciò che vuoi davvero dimostrare.
*/}
# Agenti e strumenti di IA (/it/docs/integrations/agents)
Ogni pagina di questo sito ha un gemello in Markdown, perché una buona parte del traffico qui non è umana.
## Questa documentazione, letta da una macchina [#these-docs-read-by-a-machine]
Quattro vie d'accesso, tutte generate in fase di build, nessuna delle quali è un prodotto a parte.
[/llms.txt](/llms.txt) è un indice di tutte le pagine con la relativa descrizione, abbastanza piccolo da incollare in un prompt. [/llms-full.txt](/llms-full.txt) è l'intero sito in un unico file Markdown, ed è quello da dare a un agente.
Le altre due servono a raggiungere una singola pagina. Il sorgente di ogni pagina si trova in `/llms.mdx/docs//content.md`, e in cima a ogni pagina c'è un pulsante **Copy Markdown** che lo recupera. Richiedi qualsiasi URL della documentazione con un header `Accept: text/markdown` e ricevi il Markdown invece di una pagina HTML da analizzare.
La vecchia documentazione serviva il Markdown per ogni pagina e gli agenti dei partner hanno finito per dipenderne. Per questo qui funziona ancora.
## Usi attuali [#uses-today]
Le domande di configurazione trovano risposta senza che nessuno legga il sito. Indirizza Claude, Cursor o Codex a `/llms-full.txt` e fai la domanda che altrimenti faresti a noi. Come si configura una missione giornaliera con un tetto alla serie, cosa fa davvero «nascosta se bloccata», quali modelli richiedono prima un account collegato. Le risposte sono tutte lì.
I report arrivano senza che il tuo team li costruisca. Dai a un agente la documentazione di riferimento della [Data API](/docs/integrations/data-api) e una chiave, poi chiedi quello che vuoi davvero. I fan che hanno completato una missione il mese scorso ma da allora non hanno più aperto l'app, in CSV. Scrive le chiamate, scorre le pagine dei risultati e ti consegna il file. Da noi non gli serve niente.
In entrambi i casi è lavoro in sola lettura da parte tua, e nessuno dei due richiede che prima venga sviluppata una funzionalità.
## Costruire l'esperienza dei fan con un agente [#building-the-fan-experience-with-an-agent]
Se stai portando FanBase dentro il tuo prodotto invece di usare l'app ospitata, il percorso con un agente è il modo previsto per installare l'SDK. I pacchetti contengono i file che un agente legge, un prompt di avvio e una skill per agenti leggera, così il materiale di riferimento arriva nel repository insieme al codice.
Incolla due prompt, e l'ordine conta: prima l'accesso, poi le missioni. Unirli produce qualcosa che sembra finito e ha un accesso fittizio. Integrare con un agente contiene entrambi i prompt e l'elenco di ciò che vale la pena controllare a mano dopo.
## Un assistente nel pannello di amministrazione [#an-assistant-in-the-admin-panel]
In valutazione
L'idea è che tu chieda quello che ti serve invece di compilare il modulo. Crea una missione giornaliera da cinquanta XP con un tetto alla serie, e lui la preparerebbe in bozza per la tua approvazione. Mostrami le missioni completate per tag nell'ultimo mese, e lui tirerebbe fuori il report.
È in discussione, non in programma. Se può cambiare il modo di lavorare del tuo team, dillo al tuo referente FanBase: sapere che un partner lo vuole è ciò che gli fa avere una data.
## Gli agenti si collegano leggendo file, non tramite MCP [#agents-connect-by-reading-files-not-by-mcp]
Per questa piattaforma, oggi, non c'è MCP. Un agente che sostiene il contrario sta tirando a indovinare, e non c'è niente da installare o da collegare.
Lo schema supportato è dare all'agente dei file da leggere e una chiave API quando gli serve. Funziona con qualsiasi strumento in grado di leggere un file.
# Data API (/it/docs/integrations/data-api)
Accesso HTTP in sola lettura ai membri, all'attività, ai saldi e agli oggetti posseduti della tua community, autenticato con una chiave. Non tocca mai l'esperienza dei fan.
## Ambito e primi utilizzi [#scope-and-first-uses]
Le tre cose che i partner hanno costruito per prime con questa API:
* Un segmento nel CRM. I membri e i loro saldi uniti alla lista email, così una campagna può andare ai fan sopra il livello dieci invece che a tutti.
* Una tabella nel data warehouse. Un'estrazione notturna di membri e attività nello stesso posto in cui arrivano già i dati del negozio, così il coinvolgimento nell'app e i ricavi si possono guardare in un'unica query.
* Una dashboard che la tua dirigenza legge già. I totali principali nello strumento di BI che mostra tutti gli altri numeri, invece di un altro accesso a un altro pannello.
## Ottenere una chiave [#getting-a-key]
Chiedi una chiave al tuo referente FanBase.
Viene mostrata una sola volta, alla creazione, e mai più. Mettila subito in un gestore di password o nel tuo archivio di segreti. Se va persa, la soluzione è una nuova chiave.
Una chiave può avere una scadenza. Chiedila per tutto ciò che ha vita breve, come l'integrazione di un consulente esterno o una migrazione una tantum. Una chiave senza scadenza è una chiave che sopravvive alla persona che l'ha chiesta.
Dicci quando una chiave deve smettere di funzionare e la revochiamo.
Questa è un'API da server a server. La chiave non deve mai finire in un browser, in un'app mobile, in una build del front end o in qualsiasi altra cosa che un fan possa leggere. La chiave legge tutta la tua community, e un fan che la trova può leggerla anche lui. Mettila su un server, in un job pianificato o nel connettore del tuo data warehouse.
Se quello che stai costruendo è rivolto ai fan, usa invece l'SDK. Si autentica come il fan e restituisce solo i dati di quel fan. Vedi la documentazione di riferimento dell'API di FanBase SDK.
## Chiamarla [#calling-it]
Invia la chiave in un header `x-api-key`. L'URL di base è `https://api.gamerbase.gg`.
```bash
curl -H "x-api-key: $FANBASE_API_KEY" \
"https://api.gamerbase.gg/v1/data/members?limit=100&offset=0"
```
Niente flusso OAuth e niente rinnovo dei token.
## Risorse che puoi leggere [#resources-you-can-read]
| Risorsa | A cosa serve |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Membri | Una riga per ogni fan della tua community. La chiave di join per tutto il resto qui, e la tabella su cui il tuo CRM crea i segmenti. |
| Eliminazioni di membri | I fan che hanno eliminato il proprio account. L'unico modo per rispettare un'eliminazione anche nei tuoi sistemi, perché un fan eliminato smette di comparire tra i membri, e nell'esportazione dei membri, senza nulla che ne segnali l'assenza. |
| Attività | Cosa hanno fatto i fan e quando. Il registro eventi che sta sotto ogni numero della dashboard, e la fonte per le analisi di fidelizzazione e di coorte. |
| Saldi delle risorse | Un saldo per fan e per risorsa, quindi gli XP e ogni valuta spendibile creata dalla tua community. È il dato su cui segmenti quando vuoi i tuoi primi mille fan e non tutti. |
| Oggetti posseduti | Quali oggetti da collezione e oggetti dell'inventario possiede ogni fan. Utile per verificare chi possiede davvero l'oggetto attorno a cui è stata costruita una campagna. |
| Aperture di loot box | Ogni apertura e cosa ne è uscito. Per la riconciliazione, e per rispondere al fan che dice che le probabilità sono sbagliate. |
| Totali statistici | I conteggi principali di tutta la community, tra cui `totalMembers` e `totalQuestsCompleted`. L'elenco completo è nella [documentazione di riferimento](https://api.gamerbase.gg/api). La chiamata leggera per un tabellone di stato che non ha bisogno di righe per fan. |
| Catalogo delle missioni | Le tue missioni pubblicate. Pubblico, ed è l'unica parte che non richiede alcuna chiave. |
## Paginazione e sincronizzazione [#paging-and-syncing]
Ogni risposta a elenco ha la stessa forma: `data` contiene le righe, `total` indica quante righe corrispondono in totale, e `offset` dice dove inizia la pagina che hai in mano. Scorri le pagine con `limit` e `offset`. Il massimo attuale per `limit` è nella [documentazione di riferimento](https://api.gamerbase.gg/api), che è generata dall'API ed è il valore su cui basare il codice.
Usa `updatedSince`. Passa un timestamp e ricevi solo le righe modificate dopo quel momento. La prima esecuzione scarica tutta la community. Ogni esecuzione successiva scarica le poche righe che sono cambiate dall'ultima.
Due cose da fare bene quando costruisci questo ciclo.
Salva l'ora in cui è iniziata l'esecuzione. Le righe possono essere scritte mentre scorri le pagine, quindi un cursore impostato sull'ultima riga vista le salta. Ancorati all'inizio dell'esecuzione, sovrapponi l'esecuzione successiva di qualche minuto, e una riga scritta a metà sincronizzazione viene comunque raccolta. Scrivi le tue righe in modo che vedere la stessa due volte sia innocuo, e la sovrapposizione non ti costa nulla.
Leggi le eliminazioni di membri con la stessa frequenza dei membri. Un fan eliminato smette di comparire tra i membri, e una sincronizzazione incrementale basata solo su `updatedSince` non ha modo di accorgersi di un'assenza. Tiene la riga obsoleta nel tuo CRM per sempre, e continua a mandare email a qualcuno che ha chiesto di essere dimenticato. Le eliminazioni sono una risorsa separata proprio perché tu possa scaricarle e agire di conseguenza.
## Limiti di frequenza [#rate-limits]
Il limite è al minuto e per chiave, ed è abbastanza alto perché una sincronizzazione incrementale ben costruita non ci si avvicini mai. Ogni risposta contiene header `X-RateLimit-*` con i numeri in tempo reale, e sono quegli header a fare fede. Un client che li legge e rallenta quando il conteggio residuo si abbassa resta dentro il limite senza alcuna regolazione da parte tua.
Se raggiungi il limite, la causa è quasi sempre un nuovo download completo eseguito a intervalli pianificati.
## La documentazione di riferimento interattiva [#the-interactive-reference]
Ogni endpoint, ogni parametro e ogni forma di risposta si trova su [api.gamerbase.gg/api](https://api.gamerbase.gg/api), e puoi chiamarli dalla pagina con la tua chiave. È generata dall'API, quindi è la forma attuale e non una sua copia. Indirizza lì per prima cosa i tuoi sviluppatori e il tuo agente di programmazione.
## Webhook [#webhooks]
In valutazione
Oggi interroghi tu l'API a intervalli. I webhook invertirebbero il meccanismo: registreresti un URL e la piattaforma ti invierebbe una richiesta quando succede qualcosa, così il completamento di una missione potrebbe arrivare al tuo CRM in pochi secondi invece che alla sincronizzazione successiva.
È in discussione, non in programma. Se la tua campagna dipende da una reazione in tempo reale, dillo al tuo referente FanBase: sapere che un partner ne ha bisogno è ciò che gli fa avere una data.
# Discord (/it/docs/integrations/discord)
Cinque funzionalità distinte condividono il nome Discord, e attivarne una non attiva le altre.
| Cosa vuoi | Che cos'è in realtà | Dove si configura |
| ---------------------------------------------------------------------------- | ---------------------------- | ---------------------------------------------------------------------- |
| I fan accedono con il loro account Discord | Un provider di accesso | Per community, da parte nostra |
| I fan collegano Discord a un account che hanno già | Il collegamento dell'account | Per community, da parte nostra |
| Il tuo server riceve un messaggio quando pubblichi qualcosa | Il bot FanBase | **Settings**, poi **Automation** |
| Una missione che verifica che un fan sia entrato nel server o abbia un ruolo | Due modelli di missione | [Discord](/docs/quests/templates/social/discord), tra i modelli social |
| Un ruolo Discord assegnato per aver completato qualcosa | Un tipo di ricompensa | [Ricompense](/docs/rewards) |
## Accesso e collegamento dell'account [#sign-in-and-account-linking]
Sono due cose diverse e si configurano in modo indipendente.
**L'accesso** è Discord come porta d'ingresso della tua app. Un fan tocca **Continua con Discord** ed è dentro, senza una password separata. Sta accanto a Google, X, Twitch e Shopify, e scegli tu quali compaiono.
**Il collegamento dell'account** è un fan che ha già effettuato l'accesso e collega il suo account Discord in un secondo momento, dal profilo. È attivo per impostazione predefinita, perché un fan che ha effettuato l'accesso con Google ha comunque bisogno di un account Discord collegato prima che una missione Discord possa essere verificata.
È il collegamento quello che conta per le missioni. Un fan che ha effettuato l'accesso con Discord è collegato automaticamente, ma un fan che è entrato in un altro modo no, e le sue missioni Discord restano bloccate finché non collega l'account. La card della missione lo gestisce da sola. Vedi [Modelli che richiedono un account collegato](/docs/quests/templates#templates-that-need-a-linked-account).
Di' al tuo referente FanBase quali metodi di accesso vuoi e se il collegamento con Discord deve essere disponibile: è una modifica di configurazione, non uno sviluppo. [Accesso](/docs/settings/sign-in) contiene l'elenco completo.
I nomi utente nell'app hanno la forma `name#1234`. È un identificativo FanBase con un aspetto simile a quelli di Discord, e non ha alcun legame con l'account Discord del fan.
## Annunci nel tuo server [#announcements-in-your-server]
Il bot pubblica in un canale del tuo server quando succede qualcosa nell'app. L'annuncio parte, che qualcuno del tuo team si ricordi di scriverne uno oppure no.
| Trigger | Cosa vede il server |
| ----------------------------- | ------------------------------------------------------- |
| Viene pubblicata una missione | Un messaggio con la missione e un link per raggiungerla |
| Inizia un evento | Un messaggio all'apertura dell'evento |
| Termina un evento | Un messaggio alla chiusura |
Ogni tipo di notifica ha il suo interruttore, quindi puoi annunciare le missioni e tacere su tutto il resto. Stanno arrivando altri tipi: i post del feed di notizie, le modifiche al negozio e i vincitori degli eventi sono quelli a cui stiamo lavorando. In sviluppo
### Configurazione [#setting-it-up]
### Porta il bot nel tuo server [#get-the-bot-into-your-server]
Vai in **Settings**, poi **Automation**. Premi **Connect** nel riquadro Discord. Discord ti chiede di scegliere il server e di approvare il bot, poi ti riporta al pannello di amministrazione.
Chi fa clic deve avere il permesso **Manage Server** (Gestire il server) su quel server Discord, quindi assicurati che quella persona sia presente prima di iniziare. Se il riquadro offre già **Disconnect**, il bot è dentro e puoi saltare questo passaggio.
### Scegli il canale [#choose-the-channel]
Indica l'ID del canale in cui vuoi i messaggi. Vale la pena creare un canale dedicato: in una chat generale affollata gli annunci scorrono via in pochi minuti.
### Scegli un ruolo da menzionare, o nessuno [#choose-a-role-to-mention-or-none]
Facoltativo. Scegli un ruolo e ogni messaggio lo menziona. Lascia vuoto il campo e il messaggio non notifica nessuno.
Menzionare tutti a ogni missione è il modo in cui un server impara a silenziare il tuo canale degli annunci. Se vuoi una menzione, crea un ruolo a cui i fan aderiscono per scelta.
### Attiva le notifiche che vuoi [#turn-on-the-notifications-you-want]
Attivale una alla volta e lascia disattivate le altre. Puoi tornare ad aggiungerne altre quando sai com'è il volume.
### Pubblica qualcosa e guarda il canale [#publish-something-and-watch-the-channel]
L'unico vero test.
### Ottenere gli ID [#getting-the-ids]
Entrambi gli ID si trovano dietro la modalità sviluppatore di Discord, che [Trovare gli ID](/docs/quests/templates/social/discord#finding-the-ids) spiega come attivare.
| ID che ti serve | Come ottenerlo |
| --------------- | ---------------------------------------------------------------------------------------------------------------------- |
| ID del canale | Clic destro sul canale nell'elenco dei canali, poi **Copy Channel ID** (Copia ID canale) |
| ID del ruolo | Clic destro sul ruolo in **Server Settings** (Impostazioni server), poi **Roles**, e **Copy Role ID** (Copia ID ruolo) |
Controlla che il ruolo del bot possa vedere il canale e inviarvi messaggi. Un canale in cui il bot non può pubblicare ha esattamente lo stesso aspetto di un bot che non funziona, ed è la prima cosa da escludere.
## Discord come fonte di missioni [#discord-as-a-source-of-quests]
Due modelli leggono il tuo server invece di scriverci.
**Join the server** (entrare nel server) chiede a un fan di essere membro di un server che indichi tu, e lo verifica. **Hold a role** (avere un ruolo) chiede un ruolo specifico e verifica anche quello: è così che premi le persone che si sono già guadagnate qualcosa su Discord.
Entrambi richiedono che l'account Discord del fan sia collegato, ed entrambi richiedono l'ID del server. Tutti i campi sono nella pagina [Discord](/docs/quests/templates/social/discord) dei modelli di missione.
Un ruolo Discord può essere anche un requisito di accesso invece che una missione: puoi nascondere una missione, o bloccarla, finché un fan non ha un ruolo. È spiegato in [Imposta le proprietà avanzate](/docs/quests/creating#set-the-advanced-properties).
## Un ruolo Discord come ricompensa [#a-discord-role-as-a-reward]
La direzione opposta. Un fan completa una missione e il bot gli assegna un ruolo nel tuo server, senza che intervenga nessuno.
È ciò che rende possibile lo schema che vuole la maggior parte dei partner: il livello dieci nell'app ti fa avere un colore su Discord. Serve che il bot sia collegato, e il ruolo del bot deve trovarsi sopra il ruolo che assegna nell'elenco dei ruoli del tuo server. Discord non permette a un bot di concedere un ruolo più alto del proprio. Se un ruolo non viene assegnato, controlla per prima cosa quell'ordine.
I tipi di ricompensa che puoi associare a una missione sono in [Ricompense](/docs/rewards).
# Shopify (/it/docs/integrations/shopify)
Collegare Shopify fa tre cose indipendenti: i fan accedono con il loro account del negozio, gli acquisti nel tuo negozio fanno guadagnare XP, valuta o oggetti da collezione nell'app, e gli articoli comprati con i punti nell'app diventano ordini veri nel tuo negozio.
## Accesso [#sign-in]
Un fan tocca **Accedi con Shopify**. Viene portato al tuo negozio tramite un URL di app proxy, che ha questo aspetto: `https://yourstore.com/apps/proxy-redirect`. Si autentica con l'account che ha già, oppure ne crea uno, e torna indietro con l'accesso effettuato.
Funziona con gli account Shopify standard e con Shop, il sistema di accesso di Shopify. In entrambi i casi il fan arriva come un'unica identità: i suoi acquisti e i suoi punti appartengono alla stessa persona.
Una cosa da sapere prima di istruire il tuo team di assistenza. Quando un fan crea un account Shopify nuovo di zecca durante questo flusso, Shopify poi non lo riporta alla tua app. Si ritrova sul tuo negozio, accede un'altra volta, e da lì in poi tutto funziona. I fan che hanno già un account non lo vedono mai.
### Quale account riceve un cliente [#whose-account-a-customer-gets]
La prima volta che un cliente accede in questo modo, viene abbinato a un fan tramite l'email. Un cliente la cui email appartiene già a un fan riceve l'account di quel fan, con i suoi punti e la sua cronologia. Tutti gli altri ne ricevono uno nuovo, con quell'email.
Se Shopify compare accanto a Google, Discord, X e Twitch, oppure li sostituisce del tutto, è un'impostazione per community. Alcuni partner usano Shopify come unico modo per entrare, così un account fan e un account cliente sono la stessa cosa per costruzione.
## Installazione [#installing-it]
L'installazione è un'app Shopify personalizzata per il tuo negozio, quindi si risolve con pochi messaggi e non con un'app da cercare in un catalogo.
### Inviaci il tuo dominio `.myshopify.com` [#send-us-your-myshopifycom-domain]
Quello originale, che termina con `.myshopify.com`.
Lo trovi nel pannello di controllo Shopify sotto **Settings**, poi **Domains**. L'indirizzo `.myshopify.com` è elencato lì anche quando il tuo dominio principale è un dominio personalizzato.
Il tuo dominio personalizzato non funzionerà. L'installazione è legata al dominio Shopify originale, e sbagliare dominio costa una settimana invece di un pomeriggio.
### Lo aggiungiamo ai domini autorizzati e ti inviamo un link di installazione [#we-whitelist-it-and-send-you-an-install-link]
Il link è unico per il tuo negozio e scade dopo circa una settimana. Se scade, chiedine un altro.
### Accedi al pannello di amministrazione prima di fare clic [#log-in-to-the-admin-panel-before-you-click-it]
Apri [admin.gamerbase.gg/admin](https://admin.gamerbase.gg/admin) e accedi prima, nello stesso browser. L'installazione si conclude riportandoti al pannello di amministrazione, e non può farlo se lì non sei già autenticato.
### Approva i permessi in Shopify [#approve-the-permissions-in-shopify]
Il link ti porta alla schermata di autorizzazione di Shopify. Leggi cosa chiede l'app, poi installala.
### Torna nel pannello di amministrazione [#land-back-in-the-admin-panel]
Vieni reindirizzato e l'installazione si completa da sola. Non c'è altro da compilare.
### Verifica [#verify-it]
Nel pannello di amministrazione, vai in **Settings**, poi **Automations**. Shopify dovrebbe risultare collegato. Se non è così, l'installazione non è arrivata in fondo, e la causa abituale è il passaggio tre.
Sandbox e produzione sono app separate, e non si incrociano. Un'app sandbox si collega solo a un negozio di sviluppo Shopify, e l'app di produzione si collega solo al tuo negozio reale. Crea un negozio di sviluppo per i test invece di puntare la sandbox verso quello vero. È gratuito ed è già in modalità di prova.
## Regole di ricompensa [#reward-rules]
Una regola di ricompensa osserva il tuo negozio e assegna una ricompensa quando un ordine le corrisponde. Creale nella sezione Shopify del pannello di amministrazione. Ogni regola ha un nome, una descrizione e una ricorrenza.
| Campo | Cosa fa |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Nome | Come chiami la regola internamente. |
| Descrizione | A cosa serve la regola, per chi la erediterà. |
| Ricorrenza | **One time** (una volta) premia un dato fan una volta sola, per sempre. **Recurring** (ricorrente) premia ogni volta che un ordine corrisponde. |
| Ricompensa | Cosa riceve il fan. Vedi la nota sui tipi di ricompensa più sotto. |
Esistono tre tipi di regola.
### Acquisto con tag [#tagged-purchase]
Premia un ordine che contiene prodotti con un tag scelto da te. Scegli i tag, e scegli se un ordine deve contenerne almeno uno, con **any**, oppure tutti, con **all**.
È così che premi una categoria senza elencare i prodotti. Metti un tag alle maglie, scrivi una sola regola, e ogni maglia che aggiungi in seguito è coperta.
### Qualsiasi acquisto [#any-purchase]
Premia ogni ordine, a prescindere da cosa è stato comprato. La più semplice delle tre, e quella giusta per «comprare da noi fa sempre guadagnare punti».
### Importo speso [#amount-spent]
La ricompensa cresce con il totale dell'ordine. Imposti un tasso per unità della valuta del tuo negozio, e la ricompensa è il tasso moltiplicato per il totale dell'ordine, arrotondato per difetto. Oggi non c'è un tetto per singolo ordine, quindi scegli il tasso pensando a un ordine grande.
### Tipi di ricompensa [#reward-types]
XP, la tua valuta spendibile e oggetti da collezione. Un premio o una loot box per un acquisto restano per ora una ricompensa manuale. [Ricompense](/docs/rewards) spiega la differenza tra i tipi.
### Quando un acquisto non fa guadagnare nulla [#when-a-purchase-pays-nothing]
Un fan dice di aver comprato qualcosa e di non aver ricevuto niente. Per ogni ordine vengono controllate sette cose, in ordine, e la prima che fallisce è la risposta.
Due di queste spiegano quasi tutti i casi. La regola è stata creata dopo l'ordine, e gli ordini precedenti a una regola non vengono mai premiati. Oppure il fan ha completato l'acquisto con un'email diversa da quella del suo account fan, e l'email è l'unica cosa che collega i due.
Un rimborso o un ordine annullato non revocano la ricompensa.
Se il tuo sito è costruito con l'SDK, mostrare a un fan i punti che un acquisto gli ha fatto guadagnare è l'unico pezzo che scrivono i tuoi sviluppatori. Le ricompense per gli acquisti nella documentazione dell'SDK lo spiega, con gli stessi sette controlli visti dal loro lato.
### Due cose da mettere in conto [#two-things-to-plan-for]
Gli ordini creati dagli acquisti con i punti nell'app vengono saltati. Quando un fan compra un articolo del negozio dell'app con i punti e la piattaforma inserisce l'ordine nel tuo negozio Shopify, su quell'ordine non scatta nessuna regola. Altrimenti un fan potrebbe spendere punti per comprare qualcosa, guadagnare punti per l'acquisto e ripetere il giro all'infinito.
Non c'è alcuna notifica nell'app quando un acquisto fa guadagnare una ricompensa. Il saldo del fan sale e nell'app niente dice da dove arriva. I partner rimediano citando la ricompensa nell'email di conferma d'ordine di Shopify che inviano già. Una notifica nell'app è in lista.
## Sulla tua vetrina [#on-your-storefront]
In sviluppo
Le funzionalità di FanBase saranno disponibili come blocchi da aggiungere al tuo tema Shopify nell'editor del tema, senza codice: le missioni, il profilo e l'avatar di un fan, e un piccolo indicatore dell'account per la tua intestazione. Un cliente che ha effettuato l'accesso al tuo negozio entrerà automaticamente nella tua community, sulle tue pagine, senza un secondo accesso.
La prima versione comprende le missioni, il profilo, l'avatar e l'indicatore. Seguiranno i blocchi per la classifica, il negozio, il battlepass, gli eventi e il feed di notizie.
Insieme arriva una modifica all'accesso. L'abbinamento di un cliente a un fan esistente tramite email varrà solo nei negozi che usano i **new customer accounts** (nuovi account cliente) di Shopify, in cui un cliente dimostra il proprio indirizzo con un codice. Con i **classic customer accounts** (account cliente classici), in cui un cliente sceglie una password e niente dimostra l'indirizzo, ogni cliente riceverà un account fan tutto suo. Se usi gli account classici e vuoi che i clienti del negozio e i fan esistenti coincidano, conviene passare ai nuovi account cliente nelle impostazioni di Shopify, sotto **Settings** poi **Customer accounts**, prima che i blocchi arrivino nel tuo negozio.
Il rilascio avviene negozio per negozio, a partire dalle community pilota. Si installa da un link, come il collegamento descritto sopra, e non chiede alcun permesso sul tuo negozio. La configurazione, le impostazioni di ogni blocco e il modo di adattarli al tuo tema sono in Blocchi per la vetrina. Chiedi al tuo referente FanBase a che punto è il tuo negozio nel rilascio.
## Spendere i punti su Shopify [#spending-points-back-into-shopify]
Un fan compra un articolo del negozio con i punti dentro l'app, e nel tuo Shopify compare un ordine vero, associato alla sua scheda cliente, pronto per essere evaso come evadi qualsiasi altro ordine. Disponibile dal 7 ottobre 2026.
Al fan non viene mai addebitato denaro. L'ordine arriva in Shopify già contrassegnato come pagato, perché ha pagato in punti.
### Attivarlo per un articolo [#turning-it-on-for-an-item]
### Autorizza il tuo negozio Shopify per gli ordini [#authorise-your-store-for-orders]
Creare ordini richiede un permesso che l'installazione originale non chiedeva. Il pannello di amministrazione mostra un banner nella sezione Shopify quando il tuo negozio deve essere autorizzato di nuovo. È una sola approvazione in Shopify, da fare una volta.
### Attiva Fulfil via Shopify [#switch-on-fulfil-via-shopify]
Sull'articolo, attiva **Fulfil via Shopify** (evasione tramite Shopify). L'interruttore resta disattivato finché non è collegato un negozio Shopify, e lo indica.
### Scegli il prodotto e la variante [#pick-the-product-and-variant]
Scegli il prodotto dal tuo catalogo Shopify, poi la variante. Il pannello compila il titolo del prodotto e lo SKU, così puoi controllare di aver scelto quello giusto.
### Salva [#save]
Attivare l'evasione tramite Shopify aggiunge un'email e un indirizzo di spedizione a ciò che l'articolo chiede al fan al momento dell'acquisto. Non devi aggiungerli tu.
### Cosa fa il fan [#what-the-fan-does]
Compra l'articolo con i punti, come farebbe con qualsiasi altro. Prima che l'acquisto vada a buon fine gli vengono chiesti un'email e un indirizzo di consegna, con un nome per il pacco. Se li ha già forniti in passato, sono precompilati.
### Cosa arriva in Shopify [#what-lands-in-shopify]
| Nell'ordine | Valore |
| ----------------------- | --------------------------------------------------- |
| Cliente | Il fan, abbinato o creato a partire dalla sua email |
| Indirizzo di spedizione | L'indirizzo che ha inserito |
| Stato del pagamento | Pagato |
| Tag | `fanbase-redemption` |
Il tag è il modo in cui distingui questi ordini nel pannello di controllo Shopify, ed è il modo in cui FanBase sa di non applicare loro le regole di ricompensa.
### Seguire un ordine [#following-an-order]
Ogni acquisto nella scheda di distribuzione del negozio dell'app mostra il suo ordine Shopify e a che punto è. Se la creazione di un ordine fallisce, per esempio perché Shopify non era raggiungibile, FanBase riprova da solo, e tu puoi riprovare dalla stessa scheda. Un fan che ha pagato in punti non perde l'articolo per un tentativo fallito.
### Tre limiti da mettere in conto [#three-limits-to-plan-around]
* **Un articolo del negozio corrisponde a una sola variante.** Una taglia M e una taglia L sono due articoli, ognuno associato alla propria variante. Le [varianti su un singolo articolo](/docs/store#variants-and-skus) sono in sviluppo.
* **Solo acquisti nel negozio dell'app.** Un premio fisico vinto con una missione, un evento o una loot box non viene inviato a Shopify. Quelli li evadi a mano, come prima. Vedi [Ricompense personalizzate](/docs/rewards/custom-rewards).
* **L'articolo del negozio ha le sue scorte.** La quantità che imposti sull'articolo è ciò che limita le vendite nell'app. Impostala su quello che puoi davvero spedire.
Abbinalo a un [limite di acquisto](/docs/store#purchase-limits) su tutto ciò che è scarso, così un solo fan con un saldo alto non può prendersi tutto.
## Distribuzione di codici [#code-distribution]
In sviluppo
Codici sconto e codici regalo distribuiti come ricompensa. Vedi [Distribuzione di codici](/docs/rewards/custom-rewards#code-distribution).
# Creare una missione (/it/docs/quests/creating)
Creare una missione significa prendere sette decisioni. Due non si possono più modificare una volta salvata la missione.
## Il modulo, campo per campo [#the-form-field-by-field]
### Scegli un modello [#choose-a-template]
Il modello è la verifica. Decide cosa controlla la piattaforma prima di ricompensare un fan, ed è la prima cosa che il modulo richiede.
| Categoria | Cosa copre | Campi |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Azioni | Visitare un link, raggiungere un livello, avere un saldo, completare un'altra missione, invitare un amico, partecipare a un evento | [Azioni nell'app](/docs/quests/templates/action) |
| Risposte e invii | Caricare un'immagine, scrivere una risposta, rispondere a un quiz o a un sondaggio, pronosticare un esito, inviare un'email o un wallet | [Risposte e invii](/docs/quests/templates/submission) |
| Social | Seguire, mettere mi piace, ripubblicare, controllare una bio, entrare in un server, guardare una diretta, seguire un artista | [X](/docs/quests/templates/social/x), [Discord](/docs/quests/templates/social/discord), [YouTube](/docs/quests/templates/social/youtube), [Twitch](/docs/quests/templates/social/twitch), [Facebook, Instagram e TikTok](/docs/quests/templates/social/meta), [Spotify](/docs/quests/templates/social/spotify) |
| Gaming | Vincere partite, raggiungere un rango, giocare per un certo numero di ore, raggiungere una soglia statistica | [Steam](/docs/quests/templates/gaming/steam), [Counter-Strike 2](/docs/quests/templates/gaming/cs2), [Dota 2](/docs/quests/templates/gaming/dota-2), [FACEIT](/docs/quests/templates/gaming/faceit), [Riot Games](/docs/quests/templates/gaming/riot-games) |
| On-chain | Possedere un token o un NFT, oppure acquisirne uno | [On-chain](/docs/quests/templates/on-chain) |
Il modello non si può più modificare una volta salvata la missione. Vedi [Gestire le missioni](/docs/quests/managing#editable-and-locked-fields).
Ogni modello è descritto campo per campo in [Modelli di missione](/docs/quests/templates).
### Compila i campi propri del modello [#fill-the-templates-own-fields]
Ogni modello chiede ciò che gli serve per verificare. Una missione di visita a un link chiede l'URL. Un quiz chiede le opzioni e la risposta corretta. Una missione sul ruolo Discord chiede il ruolo. Una missione CS2 chiede il numero di uccisioni.
Il provider deve essere attivo per la tua community, altrimenti i fan possono aprire la missione senza riuscire mai a completarla. Vedi [accesso e collegamento degli account](/docs/settings/sign-in). E l'obiettivo deve esistere: un post che viene eliminato porta via con sé la sua missione.
### Imposta le proprietà [#set-the-properties]
| Campo | Cosa fa |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Featured (in evidenza) | Fissa la missione in cima alla bacheca. Usalo per la campagna in corso e togli dall'evidenza quella precedente. Cinque missioni in evidenza equivalgono a nessuna. |
| Tag | L'etichetta con cui i fan filtrano, e il tuo modo di raggruppare una campagna. Scegli un tag esistente o creane uno qui. Le missioni senza tag finiscono sotto **Other** (altro). Vedi [Tag](/docs/quests/tags). |
| Ordering (ordine) | La posizione della missione nella bacheca: **First** (per prima), **Last** (per ultima) o **Custom** (personalizzato), che ti permette di collocarla rispetto alle missioni che hai già. |
### Imposta le proprietà avanzate [#set-the-advanced-properties]
**End date.** La data di fine, cioè il momento in cui la missione si chiude. Lascia il campo vuoto per una missione permanente.
**Requirements.** I requisiti: ciò che un fan deve già avere per poter completare la missione.
| Requisito | Soddisfatto quando il fan |
| -------------------------------------- | -------------------------------------------------------------------------------------------- |
| Level (livello) | Ha raggiunto un livello a tua scelta |
| Discord role (ruolo Discord) | Ha un ruolo nel tuo server. Richiede che [Discord](/docs/integrations/discord) sia collegato |
| Collectible (oggetto da collezione) | Possiede un oggetto specifico |
| Another quest (un'altra missione) | Ha completato una missione che indichi tu |
| Membership tier (piano di abbonamento) | Ha un piano a pagamento. Vedi [Battlepass](/docs/battlepass#premium-membership) |
**Visibility.** La visibilità, distinta dai requisiti. Un requisito decide se un fan può completare la missione; la visibilità decide se può vederla.
| Visibilità | Cosa vede un fan |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Visible (visibile) | La missione, bloccata o no |
| Hidden (nascosta) | Niente. La missione esiste ed è raggiungibile con un link diretto: è così che funziona un codice QR a un evento dal vivo |
| Hidden if locked (nascosta se bloccata) | Niente finché non soddisfa il requisito, poi la missione compare |
**Recurrence.** La ricorrenza: una volta, ogni giorno o ogni settimana.
| Ricorrenza | Cosa succede |
| -------------------- | ---------------------------------------------------------------------------------------------------------- |
| Once (una volta) | Il valore predefinito. Un fan la completa una sola volta. |
| Daily (giornaliera) | Si rinnova ogni giorno. È il posto abituale per una ricompensa piccola, semplice e impossibile da mancare. |
| Weekly (settimanale) | Si rinnova ogni settimana. Adatta a tutto ciò che richiede un impegno vero, come le ore di gioco. |
Qualsiasi valore diverso da Once attiva le serie, e questo aggiunge altri due campi. Lo **streak boost** (bonus di serie) è la quantità di cui la ricompensa cresce a ogni completamento consecutivo, e il **reward cap** (tetto della ricompensa) è il limite a cui smette di crescere. Se il fan salta un rinnovo, la serie riparte dall'inizio.
Con un tetto troppo alto, un fan che non salta mai un giorno guadagna più da una sola missione giornaliera che da tutta la tua bacheca. Con un tetto troppo basso, il bonus è solo decorativo. Dove deve cadere il tetto rispetto alle tue soglie di XP è spiegato in [Livelli](/docs/levels).
**Expiry.** La scadenza, cioè il modo in cui la missione si chiude da sola: **none** (nessuna), per **date** (data) o per **participants** (partecipanti). La scadenza per partecipanti annulla la pubblicazione della missione quando un certo numero di fan l'ha completata: è così che gestisci una campagna riservata ai primi cinquanta senza tenere d'occhio il contatore.
Prima di pubblicare una bacheca piena di missioni impostate su Hidden if locked, conta cosa può vedere un fan appena arrivato. Questa impostazione fa aprire la bacheca man mano che i fan avanzano, e una bacheca composta soprattutto da queste missioni sembra vuota il primo giorno.
### Scrivi il contenuto [#write-the-content]
| Campo | Cosa fa |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Language (lingua) | La lingua in cui stai scrivendo questa versione. Aggiungi una versione per ogni lingua che offri, altrimenti i fan di quella lingua vedono la versione predefinita. |
| Title (titolo) | La riga sulla card. Indica l'azione: «Seguici su X», non «Missione social 4». |
| Description (descrizione) | Come completarla, nell'ordine in cui procede un fan. Quando questo campo è vago, è da qui che arrivano i ticket di assistenza. |
| Image (immagine) | La grafica della missione. Facoltativa, e utile per tutto ciò che è in evidenza o legato a una campagna. Una bacheca di trenta righe di testo è difficile da scorrere. |
### Scegli le ricompense [#choose-the-rewards]
| Ricompensa | Cosa ottiene il fan |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| XP | Progressi verso il livello successivo e un posto in classifica |
| Spendable currency (valuta spendibile) | Un saldo da spendere nel negozio |
| Prize (premio) | Una ricompensa personalizzata che esce dall'app: merchandising, una carta regalo, un'esperienza. Vedi [Ricompense personalizzate](/docs/rewards/custom-rewards) |
| Collectible (oggetto da collezione) | Un'immagine del profilo, una cornice, uno sfondo o un oggetto indossabile. Vedi [Oggetti da collezione e personalizzazione](/docs/rewards/collectibles) |
| Loot box | Una loot box che il fan apre per ottenere un oggetto casuale |
| Discord role (ruolo Discord) | Un ruolo assegnato automaticamente nel tuo server |
Puoi associare più ricompense a una sola missione: così il finale di una campagna può dare XP, valuta e un oggetto da collezione insieme.
**Decay** (riduzione progressiva) fa diminuire la ricompensa man mano che i fan la riscattano. Imposti l'importo iniziale, di quanto scende a ogni riscatto e una soglia minima sotto la quale non scende mai. Premia la velocità più che il volume. Usalo per un lancio o per un'iniziativa in un giorno di partita, non per una missione che dura tutta la stagione.
La ricompensa non si può più modificare una volta salvata la missione. Vedi [Gestire le missioni](/docs/quests/managing#editable-and-locked-fields).
### Pubblica, programma, salva come bozza o archivia [#publish-schedule-draft-or-archive]
| Azione | Cosa succede |
| -------------------------------- | ------------------------------------------- |
| Publish (pubblica) | La missione compare subito nella bacheca. |
| Schedule (programma) | Viene pubblicata nella data che scegli. |
| Save as draft (salva come bozza) | Resta nel pannello e nessun fan la vede. |
| Archive (archivia) | Chiude la missione e la toglie dall'elenco. |
**Fusi orari.** Il pannello legge l'orologio del tuo computer e salva tutto in UTC. Una missione programmata viene pubblicata all'inizio del giorno scelto nella tua ora locale, qualunque ora tu abbia inserito nel modulo. Se la tua community si trova in un altro fuso orario, programma in base al suo: una missione fissata per sabato in Europa arriva il venerdì sera nelle Americhe.
## Missioni a più passaggi [#multi-step-quests]
Più passaggi dentro un'unica card, con una sola ricompensa alla fine. Il fan vede tutti i passaggi fin dall'inizio e li completa in ordine.
Costruiscila come un'unica missione a passaggi, non come una catena di missioni nascoste una dietro l'altra. La catena funzionava, ma i fan la abbandonavano al quarto anello perché non vedevano quanto mancava.
Usala per tutto ciò che nella testa di un fan è un compito solo. Collegare gli account, poi seguire, poi entrare nel server. Guardare la partita, poi pronosticare la successiva, poi pubblicare un post.
# Progettare una bacheca delle missioni (/it/docs/quests/designing-a-board)
Ogni missione è fatta di tre decisioni: cosa chiedi, come la piattaforma dimostra che è successo e cosa ottiene il fan. La prima e la terza spettano a te. Questa pagina riguarda la bacheca che tutte insieme compongono.
## Dosa la difficoltà [#mix-the-difficulty]
Circa metà della bacheca dovrebbe potersi completare in meno di un minuto, un terzo dovrebbe richiedere un impegno vero e una manciata di missioni dovrebbe essere davvero difficile. Una bacheca fatta solo di missioni facili viene completata e abbandonata in un pomeriggio. Una fatta solo di missioni difficili sembra un compito per casa.
## Pubblica da venti a trenta missioni al lancio [#publish-twenty-to-thirty-at-launch]
Una bacheca di lancio con quattro missioni sembra vuota già il secondo giorno, e i fan che l'hanno vista così non li recuperi più.
Da venti a trenta è l'intervallo su cui si sono assestati i lanci dei partner: abbastanza perché un fan motivato non svuoti la bacheca in una sessione, abbastanza poche perché il tuo team riesca a scriverle tutte prima del giorno del lancio. Conta quello che un fan appena arrivato può vedere davvero, non il totale nel pannello.
## Tieni una sola missione giornaliera [#run-exactly-one-daily]
Una piccola azione che si rinnova ogni giorno è ciò che fa tornare i fan di martedì, e si configura in due minuti. Con più di una missione giornaliera l'abitudine diventa un peso.
## Rendi la ricompensa proporzionata all'impegno [#make-the-reward-worth-the-effort]
Un fan che dedica venti minuti a un invio per la stessa ricompensa di un clic su un link capisce quanto valgono le tue missioni. Dai all'impegno il giusto valore e usa le [ricompense decrescenti](/docs/rewards#decaying-rewards) quando cerchi la velocità più che il volume.
## Lascia spazio alla seconda ondata [#leave-room-for-the-second-wave]
Qualunque cosa pubblichi al lancio, i tuoi fan più attivi la finiranno in un giorno. Tieni pronto il gruppo successivo prima che il primo vada online.
## Dove trovare il resto [#where-the-rest-of-it-lives]
| Cosa cerchi | Pagina |
| ---------------------------------------------------------------- | ------------------------------------------------- |
| Tutti i campi del modulo della missione | [Creare una missione](/docs/quests/creating) |
| Cosa chiede ogni modello e quali richiedono un account collegato | [Modelli di missione](/docs/quests/templates) |
| Modificare, programmare e archiviare una missione pubblicata | [Gestire le missioni](/docs/quests/managing) |
| Raggruppare le missioni e dare ai fan un filtro | [Tag](/docs/quests/tags) |
| Approvare gli invii di immagini e di testo | [Revisione degli invii](/docs/quests/submissions) |
# Gestire le missioni (/it/docs/quests/managing)
Due campi vengono bloccati nel momento in cui una missione viene salvata.
## Campi modificabili e campi bloccati [#editable-and-locked-fields]
| Campo | Dopo il salvataggio della missione |
| --------------------------------------------------- | ---------------------------------- |
| Modello | Bloccato |
| Ricompensa | Bloccato |
| Titolo, descrizione e immagine | Modificabile |
| Tag e ordine nella bacheca | Modificabile |
| Data di fine e scadenza | Modificabile |
| Visibilità e requisiti | Modificabile |
| Ricorrenza, bonus di serie e tetto della ricompensa | Modificabile |
| In evidenza | Modificabile |
Due campi sono bloccati. Tutti gli altri campi del modulo restano modificabili, quindi una descrizione poco chiara si può correggere mentre i fan stanno svolgendo la missione.
Il motivo è l'equità. Alcuni fan hanno già completato la missione alle condizioni che hai pubblicato, e cambiare ciò che verifica o ciò che paga vorrebbe dire avere due fan che fanno un lavoro diverso per un compenso diverso sotto lo stesso titolo.
In fase di creazione, il modello e la ricompensa sono i due campi da controllare due volte. Tutto il resto si può sistemare dopo. Se ne sbagli uno, duplica la missione, correggi la copia e archivia l'originale. La cronologia dei completamenti resta con l'originale.
Una missione salvata come bozza ha già fissato il modello e la ricompensa.
## Annullare la pubblicazione [#unpublishing]
La missione sparisce dalla bacheca.
* I fan non possono più vederla né completarla.
* Un fan che era a metà missione la perde. Conta soprattutto per le missioni gaming, dove i progressi si accumulano in ore di gioco: la card sparisce e le ore non contano.
* I fan che l'hanno già completata la conservano nella cronologia delle missioni, con la ricompensa che hanno ricevuto.
Annulla la pubblicazione di una missione il cui obiettivo non funziona più, per esempio un post eliminato o un link morto. Per una missione che ha fatto il suo corso è meglio una data di fine, perché i fan la vedono chiudersi invece di sparire.
## Duplicare [#duplicating]
La duplicazione copia tutti i campi in una nuova bozza, compresi il modello e la ricompensa che altrimenti non potresti cambiare.
È il modo per correggere un errore, ed è il modo per riproporre la stessa missione il mese prossimo senza ricostruirla. Rinomina la copia prima di pubblicare. Due missioni con lo stesso titolo nella stessa bacheca sono un ticket di assistenza assicurato.
## Statistiche per missione [#per-quest-analytics]
Apri una missione per vedere come è andata.
| Misura | Cosa ti dice |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Completions (completamenti) | Quanti fan l'hanno completata |
| Attempts (tentativi) | Quanti ci hanno provato. Lo scarto tra tentativi e completamenti è la difficoltà reale della missione |
| Completion history (cronologia dei completamenti) | Un grafico nel tempo, che mostra se una missione attira ancora attenzione o se è stata completata nel primo pomeriggio |
| Fan detail (dettaglio per fan) | Chi l'ha completata, in quanti tentativi e quando |
| Timeframe (periodo) | Oggi, gli ultimi sette giorni o dall'inizio |
## La colonna Audience [#the-audience-column]
La bacheca delle missioni mostra una percentuale Audience. È la quota di tutta la tua community che ha completato la missione:
```
completions / total members x 100
```
Quindi una missione al 4% in una community di cinquantamila membri è stata completata da duemila fan. Valutala rispetto alla scheda in cui si trova e rispetto alle tue altre missioni, mai rispetto a 100. Una missione giornaliera e una missione che chiede una foto non daranno mai numeri confrontabili, e aspettarselo è il modo più rapido per ritirare qualcosa che funzionava.
Esporta il dettaglio per fan in CSV per tutto ciò che ti serve fuori dal pannello, come estrarre un vincitore o aggiornare uno sponsor.
Molti tentativi e pochi completamenti di solito significano che le istruzioni sono sbagliate, non che la missione è difficile. Rileggi la tua descrizione prima di cambiare la ricompensa.
Per i numeri di tutta la community invece che di una sola missione, vedi [Statistiche](/docs/analytics). Per portare questi dati nei tuoi sistemi in modo continuo, vedi [Data API](/docs/integrations/data-api).
# Revisione degli invii (/it/docs/quests/submissions)
Le missioni con immagini e testo non possono essere verificate da una macchina, quindi deve guardarle una persona.
## La coda [#the-queue]
Due schede. **Pending** (in attesa) contiene tutto ciò che aspetta una decisione, con il conteggio accanto al nome della scheda. **History** (cronologia) contiene tutte le decisioni già prese, così puoi controllare cosa è stato approvato e da chi.
Apri un invio per vedere l'immagine o il testo, il fan che l'ha mandato e la missione a cui appartiene.
L'approvazione è definitiva. La ricompensa viene pagata subito e non si può annullare. Leggi l'invio prima di premere, e fai attenzione alla tastiera quando stai smaltendo una coda lunga.
## Cosa vede il fan [#the-fans-view]
Finché un invio è in attesa, la card della missione mostra «In attesa di revisione». Il fan sa che è arrivato e che non è ancora stato pagato nulla.
Quando rifiuti puoi lasciare un commento, e il fan può inviare di nuovo. Usalo. «Rifiutato» da solo suona come un giudizio sul fan; «la foto deve mostrare tutta la maglia» suona come un'indicazione, e di solito l'invio torna corretto.
## Esportazione in blocco [#bulk-export]
Scarica in una volta tutti gli invii di una missione: uno zip con le immagini e i file di testo, più un CSV che elenca chi ha inviato cosa.
Il CSV contiene l'ID del fan, il suo nome utente e l'invio, e i file prendono il nome dalla missione e dal nome utente, quindi una cartella con duecento partecipazioni resta ordinabile.
È così che gestisci un concorso di design o una campagna fotografica senza aprire duecento card una alla volta. Esporta, valuta offline con le persone che devono giudicare, poi torna ad approvare.
## Ritmo [#cadence]
* Decidi chi revisiona e quando, prima di pubblicare la missione.
* Revisiona ogni giorno alla stessa ora. Basta una fascia oraria fissa, al mattino o a mezzogiorno. I fan imparano quando arrivano le decisioni e smettono di aggiornare la pagina.
* Assegna un secondo revisore per le campagne. Tutto ciò che hai promosso produrrà più invii in un giorno di quanti ne produca il resto della bacheca in un mese.
Una coda lenta è il modo più rapido per far smettere i fan di inviare. Un concorso di design con due settimane di attesa per le approvazioni sembra una missione rotta, e i fan che ti hanno dato un lavoro vero sono i primi ad accorgersene. Se non riesci a revisionare entro un giorno, non pubblicare ancora la missione.
I modelli di invio e i loro campi sono in [Risposte e invii](/docs/quests/templates/submission).
# Tag (/it/docs/quests/tags)
Un tag fa due cose insieme: è il filtro che i fan usano nella bacheca delle missioni, ed è il modo in cui raggruppi una campagna per poterla ritrovare.
## Creare un tag [#creating-a-tag]
**Create tag**, poi tre campi.
| Campo | Cosa fa |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Label (etichetta) | Ciò che i fan vedono nel filtro. |
| Slug | L'identificatore nell'URL quando un fan seleziona il tag. Per impostazione predefinita riprende l'etichetta, e **non si può più modificare in seguito**. |
| Order (ordine) | La posizione del tag nella riga dei filtri. I numeri più bassi vengono prima, e due tag con lo stesso numero sono ordinati dal più vecchio al più recente. |
Lo slug è l'unico campo qui che non puoi correggere. Scegli qualcosa di breve e stabile, e lascia fuori l'anno della campagna: `daily` resiste nel tempo, `daily-2026` no.
Puoi creare un tag anche mentre costruisci una missione, nel campo Tag. Finisce in questo elenco con le stesse tre proprietà.
## Gestire i tag [#managing-tags]
| Azione | Cosa succede |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Edit (modifica) | Cambia l'etichetta e l'ordine. Non lo slug. |
| Merge (unisci) | Sposta tutte le missioni di un tag in un altro e rimuove l'originale. Unendo Social a Community, tutte le missioni restano con il tag Community. |
| Delete (elimina) | Rimuove il tag in modo definitivo. Le sue missioni non vengono eliminate; finiscono sotto **Other** (altro). |
**Other** è la categoria di riserva per ogni missione senza tag, sia che non ne abbia mai avuto uno sia che il suo tag sia stato eliminato. Non è un tag che gestisci tu.
## Usarli bene [#using-them-well]
| Fai così | Perché |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Crea i tag per tipo di missione | Giornaliere, Social, Gaming, Sponsor. I fan filtrano per trovare qualcosa da fare subito. Un tag chiamato Semifinale di Champions League è una campagna, e per una campagna c'è l'opzione [in evidenza](/docs/quests/creating). |
| Tieni corta la riga | Sei tag stanno su un telefono. Dodici vanno a capo su una seconda riga e non sembrano più un filtro. |
| Scegli l'ordine con cura | Il primo tag è quello che la maggior parte dei fan preme. Metti per primo il tag con le tue missioni facili e ripetibili. |
| Unisci invece di eliminare | Eliminando, le missioni finiscono in Other, dove i fan non le troveranno. Unendo, restano dove un fan sta guardando. |
# Avatar 3D (/it/docs/rewards/avatars-3d)
Un personaggio che un fan possiede e veste con oggetti indossabili da collezione guadagnati nell'app.
L'avatar 3D è un componente aggiuntivo. Non è attivo in tutte le app e ha un prezzo separato. Verifica con il tuo referente FanBase che faccia parte della tua offerta prima di costruirci intorno una stagione, una campagna o un calendario di ricompense.
## Oggetti indossabili [#wearables]
Ognuno occupa uno slot sull'avatar e ha una fascia di rarità, quindi una giacca mitica è visibilmente più rara di una comune. Si guadagnano come gli oggetti di personalizzazione: missioni, eventi, negozio e loot box.
Tre slot, quindi tre cose che un fan può indossare contemporaneamente.
Il possesso può servire anche come requisito di accesso. Una missione, un evento o un post possono richiedere un oggetto indossabile specifico: è così che un oggetto leggendario guadagnato la scorsa stagione diventa la chiave per qualcosa in questa.
## Standard o personalizzato [#standard-or-custom]
L'avatar standard è un personaggio umano condiviso da tutte le community che usano il componente aggiuntivo, vestito con oggetti indossabili disegnati per il tuo brand. Un personaggio personalizzato è solo tuo: una mascotte, un corpo diverso, un linguaggio visivo diverso, con un set di oggetti creato apposta.
Entrambi sono prodotti dal nostro team 3D con una cadenza concordata con te. Un personaggio personalizzato è un progetto con tempi propri, e le condizioni sulla proprietà intellettuale sono diverse nei due casi, quindi fattele mettere per iscritto prima che inizino i lavori. Vedi [Quanto costa](/docs/getting-started/pricing).
# Oggetti da collezione e personalizzazione (/it/docs/rewards/collectibles)
Gli oggetti di personalizzazione e gli oggetti indossabili dell'avatar condividono questa schermata. I primi li carichi tu, i secondi li produce il nostro team 3D.
## Oggetti di personalizzazione [#personalisation-items]
Immagini del profilo, cornici e sfondi che un fan applica al suo profilo. Li carichi tu, e compaiono in tutta l'app: nella classifica, nei commenti, accanto al suo nome nella barra di navigazione.
| Oggetto | Dove compare |
| -------------------- | ---------------------------------------------------- |
| Immagine del profilo | Ovunque compaia l'avatar di un fan |
| Cornice | Sovrapposta all'immagine del profilo, lungo il bordo |
| Sfondo | Dietro il suo profilo |
Caricane quanti ne vuoi. I file animati funzionano.
Le cornici stanno sopra l'immagine e non dietro, quindi lascia trasparente il centro di una cornice e disegnala come un contorno. Una cornice che riempie il suo quadrato nasconde l'avatar che sta sotto.
## Oggetti indossabili dell'avatar [#avatar-wearables]
Oggetti indossati da un avatar 3D: abbigliamento, accessori, divise. Li produce il nostro team 3D secondo le linee guida del tuo brand e li pubblica nel tuo pannello, pronti da configurare.
Gli avatar sono un componente aggiuntivo. Se la tua community non li ha, questa sezione riguarda solo gli oggetti di personalizzazione. Vedi [Avatar 3D](/docs/rewards/avatars-3d).
## Rarità [#rarity]
Ogni oggetto ha una fascia di rarità. Cambia il modo in cui l'oggetto viene presentato nell'app, ed è la scorciatoia che i fan usano tra loro.
Decidi la scala prima di caricare il primo lotto, e mantieni davvero rara la parte più alta. La rarità è una promessa su quanti esemplari esistono. Un oggetto leggendario in una missione giornaliera insegna ai fan che quella parola non significa nulla, e non puoi tornare indietro.
## Come arrivano a un fan [#routes-to-a-fan]
| Canale | Dove si configura |
| -------------------------- | -------------------------------------------- |
| Ricompensa di una missione | [Creare una missione](/docs/quests/creating) |
| Premio di un evento | [Eventi](/docs/events) |
| Articolo del negozio | [Negozio](/docs/store) |
| Contenuto di una loot box | [Ricompense](/docs/rewards) |
Lo stesso oggetto può essere usato in tutti e quattro. Un oggetto da collezione che è sia un articolo del negozio sia un contenuto di una loot box va benissimo, e dà ai fan che hanno perso il drop un modo per averne uno.
Gli oggetti sono conservati nella tua community e non su una chain. Vedi [Stato delle funzionalità](/docs/status#retired).
# Ricompense personalizzate (/it/docs/rewards/custom-rewards)
Una ricompensa personalizzata è qualsiasi cosa consegni tu direttamente: una maglia da gara, una maglia autografata, una carta regalo, un biglietto, una chiamata con un giocatore. La piattaforma tiene traccia di chi l'ha vinta e raccoglie ciò che ti serve per consegnarla.
## Crearne una [#creating-one]
| Campo | Cosa fa |
| ----------- | ----------------------------------------------------------------------------------------------------------- |
| Titolo | Ciò che i fan vedono quando la vincono. Sii specifico: «Prima maglia 2026 autografata», non «Premio merch». |
| Descrizione | Che cos'è e cosa succede dopo. Indica i tempi di consegna, perché il fan non ha altro modo per saperlo. |
| Immagine | L'immagine sulla card della ricompensa. |
| Requisiti | Ciò che il fan deve fornirti prima che tu possa consegnarla. |
Ogni requisito aggiunge un modulo che il fan compila al momento del riscatto.
| Requisito | Chiedilo quando |
| ----------------- | ------------------------------------ |
| Indirizzo email | Invii un codice, un link o un invito |
| Indirizzo postale | Spedisci qualcosa di fisico |
| Indirizzo wallet | Invii qualcosa on-chain |
Chiedi il minimo indispensabile. Un fan a cui viene chiesto un indirizzo postale per ricevere un codice sconto pensa che qualcosa sia andato storto, e alcuni chiudono il modulo.
## Modificare ed eliminare [#editing-and-deleting]
Ogni dettaglio di una ricompensa che non è stata distribuita può essere modificato.
L'eliminazione è definitiva. Se una ricompensa è già stata distribuita, la sua registrazione resta nel pannello dopo l'eliminazione. Elenca tutti quelli che l'hanno guadagnata e cosa hanno inviato, così puoi ancora consegnare ciò che devi.
## Monitoraggio della distribuzione [#distribution-tracking]
Apri una ricompensa per vedere i destinatari.
| Elenco | Cosa ti dice |
| ------------ | ------------------------------------------------------------------------- |
| Guadagnate | Ogni fan che l'ha vinta, e in quale missione o evento |
| Riscattate | Chi di loro ha completato il modulo di riscatto, e chi è ancora in attesa |
| Dati inviati | Ciò che ogni fan ti ha fornito: indirizzo, email o wallet |
Lo scarto tra guadagnate e riscattate è l'elenco da sollecitare. I fan dimenticano di riscattare.
Gestisci i riscatti a lotti, con una cadenza che riesci a mantenere. I dati di riscatto hanno sempre la stessa struttura, quindi esportarli nello strumento che il tuo team di logistica usa già è meglio che copiare righe a mano.
## Distribuzione di codici [#code-distribution]
In sviluppo
Potrai caricare un lotto di codici sconto o codici regalo e distribuirli come ricompensa, recapitati al fan via email. Un codice per fan da una riserva che controlli tu, invece di un unico codice condiviso che finisce su un sito di offerte.
Fino ad allora, i codici sono una ricompensa personalizzata con un requisito email, inviata da te. Vedi [Stato delle funzionalità](/docs/status).
# Panoramica delle ricompense (/it/docs/rewards)
Ogni missione finisce con qualcosa che il fan riceve.
Sette tipi di ricompensa, e la maggior parte delle community ne usa tre. L'elenco qui sotto è ordinato in base al tempo che ciascuno ti richiede, a partire dal meno impegnativo.
| Ricompensa | Cosa ottiene il fan | Quanto ti costa |
| -------------------------------------------- | ------------------------------------------------------------------------------ | ---------------------------------- |
| XP | Progressi verso il livello successivo e un posto in classifica | Niente. È automatico |
| Valuta spendibile | Un saldo da spendere nel negozio e in loot box | Niente, finché non la spende |
| Oggetti da collezione e di personalizzazione | Un'immagine del profilo, una cornice, uno sfondo o un oggetto di sua proprietà | Un caricamento per ciascuno |
| Loot box | La possibilità di ottenere qualsiasi cosa contenga | Impostare le probabilità una volta |
| Ruoli Discord | Un ruolo nel tuo server, assegnato automaticamente | Collegare Discord una volta |
| Premi e ricompense personalizzate | Una carta regalo, un codice, merchandising, un biglietto, un'esperienza | Una persona che se ne occupa |
| Ricompense decrescenti | Una ricompensa in valuta che diminuisce man mano che altri fan la riscattano | Una decisione sulla soglia minima |
## Le due risorse [#the-two-resources]
**Gli XP** si possono solo guadagnare. Un fan li ottiene completando attività e non può mai spenderli, quindi misurano quanto ha fatto una persona. Determinano i livelli, la [classifica](/docs/leaderboards) principale e i gradi del [battlepass](/docs/battlepass). Non li associ a una missione a mano: vengono distribuiti automaticamente al completamento.
**La valuta spendibile** è la seconda risorsa, facoltativa. Per impostazione predefinita si chiama Punti o Crediti e puoi rinominarla come meglio si adatta alla tua community. I fan la guadagnano con missioni ed eventi e la spendono nel [negozio](/docs/store) e in loot box.
Usarle entrambe è la configurazione normale, ed esiste perché spendere non costi mai a un fan la sua posizione.
Come le soglie di XP diventano livelli è spiegato in [Livelli](/docs/levels). Come creare e rinominare una valuta è spiegato in [Risorse](/docs/rewards/resources).
## Premi e ricompense personalizzate [#prizes-and-custom-rewards]
Tutto ciò che esiste fuori dall'app. Carte regalo, codici sconto, merchandising autografato, biglietti per le partite, una chiamata con un giocatore.
Sono le ricompense di cui i fan parlano davvero, e le uniche che richiedono una persona. Creane una con un titolo, una descrizione e un'immagine, poi decidi cosa ti serve dal fan prima di poterla consegnare.
| Requisito | Raccoglilo quando |
| ----------------- | ----------------------------------------------------------- |
| Indirizzo email | Invii un codice o un buono |
| Indirizzo postale | Spedisci qualcosa |
| Indirizzo wallet | Invii qualcosa on-chain |
| Niente | La ricompensa è onorifica, o sai già come contattare il fan |
Il fan fornisce il dato nel momento in cui riscatta e non quando guadagna, quindi non conservi gli indirizzi di persone che non sono mai tornate. Tutto ciò che viene riscattato arriva nel pannello di amministrazione con il fan, la ricompensa e i dati forniti, e il tuo team lavora su quell'elenco. Vedi [Ricompense personalizzate](/docs/rewards/custom-rewards).
Dai all'impegno il giusto valore. Un fan che dedica venti minuti a un invio per cento XP capisce esattamente quanto valgono le tue missioni.
## Oggetti da collezione e di personalizzazione [#collectibles-and-personalisation-items]
Oggetti che un fan possiede e conserva.
**Gli oggetti di personalizzazione** sono quelli che ogni community può usare: immagini del profilo, cornici che si sovrappongono all'immagine, e sfondi. Li carichi, li distribuisci tramite missioni, eventi, negozio e loot box, e compaiono nella classifica, nei profili, nei commenti e nella barra di navigazione.
**Gli oggetti indossabili** si mettono sull'avatar 3D e fanno parte del componente aggiuntivo avatar, non della piattaforma di base. Entrambi sono descritti in [Oggetti da collezione e personalizzazione](/docs/rewards/collectibles) e [Avatar 3D](/docs/rewards/avatars-3d), e la configurazione è nella pagina sugli [oggetti da collezione](/docs/rewards/collectibles).
Gli oggetti sono conservati nella tua community e non su una chain. Vedi [Stato delle funzionalità](/docs/status#retired).
## Loot box [#loot-boxes]
Una scatola che contiene qualsiasi combinazione delle ricompense qui sopra, con probabilità che imposti per ogni oggetto, e che si apre con un'animazione.
Un fan ne compra una nel negozio con la valuta spendibile oppure ne riceve una come ricompensa. In entrambi i casi il contenuto viene deciso all'apertura, quindi la stessa loot box può contenere una somma di valuta comune e un premio raro.
Con le loot box metti in circolazione qualcosa di davvero raro senza decidere chi lo ottiene. Dieci maglie autografate come ricompensa di una missione significano scegliere dieci fan. Dieci maglie autografate in una loot box significano che ogni fan ha un motivo per aprirne una.
Due cose da calibrare bene. Probabilità troppo generose svuotano le tue scorte in un fine settimana. Probabilità troppo avare producono una loot box che i fan aprono due volte e poi mai più, perché ricevere cento unità di valuta cinque volte di fila insegna loro che non vale la pena aprirla. Pubblica le probabilità nella descrizione.
## Ruoli Discord [#discord-roles]
Una missione può assegnare un ruolo nel tuo server Discord al completamento. Richiede che [Discord](/docs/integrations/discord) sia collegato, e il ruolo deve già esistere nel tuo server.
Usalo per legare l'app al server che gestisci già: completare l'onboarding nell'app, ottenere il ruolo verificato su Discord, vedere i canali. Funziona anche come requisito di accesso nella direzione opposta, perché un ruolo Discord può essere un requisito di una missione.
## Ricompense decrescenti [#decaying-rewards]
Una ricompensa che vale di più per i fan che arrivano per primi. Imposti un valore iniziale, di quanto scende a ogni riscatto e una soglia minima sotto la quale non scende mai. Il fan vede quanto vale la ricompensa in quel momento.
Scende con i riscatti e non con il passare del tempo, quindi il valore dipende da quanti fan sono arrivati prima, non da quanto ha aspettato. In una missione poco frequentata la ricompensa resta vicina al valore iniziale per giorni.
| Campo | Cosa fa | Se sbagli |
| ------------------ | ------------------------------------------- | ----------------------------------------------------------------------------------------- |
| Valore iniziale | Ciò che ricevono i primi fan che riscattano | Troppo basso, e la riduzione non cambia il momento in cui un fan riscatta |
| Tasso di riduzione | Di quanto scende il valore a ogni riscatto | Troppo rapido, e tutti tranne i primissimi ricevono il valore minimo |
| Soglia minima | Il valore a cui si ferma | Una soglia minima pari a zero significa che un fan arrivato tardi fa il lavoro per niente |
È lo strumento per premiare chi arriva presto, non il volume. Usalo quando lo scopo è che i fan si presentino prima di tutti gli altri: un drop, una missione del giorno di partita, una reazione a una notizia che hai pubblicato un'ora fa. Non usarlo sulla tua missione giornaliera.
Imposta la soglia minima su un valore che saresti contento di pagare, e imposta il tasso in base al numero di fan che ti aspetti, non in base a una scadenza.
La riduzione progressiva legata al tempo trascorso, con un conto alla rovescia sulla card, ha lo stato Pianificato. Vedi [Stato delle funzionalità](/docs/status).
## Più ricompense in una sola missione [#several-rewards-on-one-quest]
Una missione può avere più di una ricompensa. XP più valuta più un oggetto da collezione è una combinazione normale, e il fan li riscatta insieme.
Abbina una piccola ricompensa automatica a una rara. Tutti ricevono la valuta, e l'oggetto da collezione è il motivo per impegnarsi. Ti permette anche di dividere una ricompensa tra più tipi, così una missione difficile può pagare insieme qualcosa da spendere e qualcosa da possedere.
## Assegnazione e riscatto [#allocation-and-claim]
Ogni ricompensa attraversa due passaggi, e un fan che chiede dove sia il suo premio di solito si è fermato tra l'uno e l'altro.
**L'assegnazione** avviene quando il fan guadagna la ricompensa. La piattaforma la riserva al suo account. Per un evento, è il momento in cui l'evento viene risolto e le posizioni sono definitive.
**Il riscatto** è l'azione del fan. Tocca il pulsante di riscatto, la ricompensa arriva e tutto ciò che hai chiesto viene raccolto in quel momento. Un premio che richiede un indirizzo postale lo chiede qui.
Le ricompense non si riscattano da sole. Un fan che ha guadagnato un premio e non ha più riaperto l'app ha un'assegnazione non riscattata, che resterà lì. Se stai conducendo una campagna con una scadenza, quel divario merita un annuncio. L'elenco dei riscatti nel pannello di amministrazione e l'elenco delle ricompense guadagnate sono due elenchi diversi.
# Risorse (/it/docs/rewards/resources)
Una risorsa è un numero che un fan accumula. Ne hai tre tipi, e si comportano in modo così diverso che confonderli rompe la tua economia.
## I tre tipi [#the-three-kinds]
| Proprietà | Primaria | Secondaria | Punteggio evento |
| ---------------------- | ------------------------------------ | ------------------------------------------------- | --------------------------------------------- |
| Nome predefinito | XP | Punti o Crediti | Punteggio evento |
| Come la ottiene un fan | Missioni, eventi, acquisti | Allo stesso modo | Completando missioni all'interno di un evento |
| Un fan può spenderla | No. Si può solo guadagnare. | Sì. È la valuta del negozio. | No |
| Cosa determina | I livelli e la classifica principale | Il saldo, e ciò che un fan può permettersi | La classifica di quell'evento, e nient'altro |
| Quante ne hai | Una | Quante ne crei, anche se conviene averne una sola | Uno per evento |
| Sopravvive all'evento | Sì | Sì | No. È limitato all'evento che l'ha prodotto |
Gli XP possono solo salire, ed è questo che dà senso a una classifica nell'arco di una stagione. La risorsa secondaria sale e scende, perché i fan la spendono nel [negozio](/docs/store). Il punteggio evento è separato da entrambe: ordina un solo [evento](/docs/events) e non sposta il livello di un fan né la sua posizione nella classifica principale.
## Rinominare e cambiare l'icona [#renaming-and-re-imaging]
Seleziona una risorsa, poi modificala. Puoi cambiarne il **nome** e l'**icona**.
Il nome è ciò che i fan vedono ovunque: card delle missioni, negozio, classifica, notifiche. I partner chiamano gli XP con nomi come Punti Fan o il nome del club più XP, e la valuta secondaria Crediti, Monete o il nome della valuta del club.
Scegli entrambi prima del lancio. Un fan che guadagna Crediti da un mese e apre l'app trovando Monete pensa che gli sia stato tolto qualcosa.
L'icona compare in piccolo accanto a ogni numero nell'app, quindi un logo dettagliato diventa una macchia. Usa una forma semplice di un solo colore.
## Creare una risorsa secondaria [#creating-a-secondary-resource]
Una risorsa secondaria richiede un nome e un'icona, e la crei tu.
## Buona pratica, due valute [#best-practice-two-currencies]
Usa gli XP più una sola valuta spendibile e fermati lì. È la configurazione attorno a cui è progettata ogni schermata dell'app.
Una terza valuta spendibile è un peso per l'assistenza. Raddoppia il numero di prezzi nel negozio e richiede regole proprie su come si guadagna. Se pensi di averne bisogno, descrivici prima la campagna, perché di solito un [tag](/docs/quests/tags) o un [requisito di livello](/docs/levels) fa lo stesso lavoro.
## Azzerare i saldi [#reset-balance]
Un solo pulsante. Azzera i saldi e i livelli di tutti i fan della community, e non si può annullare.
| Azzerato | Conservato |
| ------------------------------------------------------------ | ------------------------------------------------------- |
| I saldi delle risorse, primaria e secondarie | La cronologia delle missioni completate, invii compresi |
| I livelli, e la posizione di ogni fan in classifica | Gli account, gli account collegati e i profili |
| I progressi nel battlepass, che si sblocca con gli stessi XP | Gli oggetti da collezione e gli oggetti già posseduti |
È l'ultimo passo prima del lancio. Il tuo team ha testato l'app, e quei test hanno prodotto saldi veri su account veri, fermi in cima alla classifica il primo giorno sotto gli occhi di tutti. Azzera il giorno prima di invitare i fan.
Dopo il lancio, trattalo come un confine tra stagioni e non come un'operazione di manutenzione. Le classifiche passate non vengono archiviate quando azzeri, quindi tutto ciò che vuoi conservare va prima esportato: con l'[esportazione dei membri](/docs/members#exporting-the-member-list) o con la [Data API](/docs/integrations/data-api). Uno storico delle stagioni che sopravvive a un azzeramento è in lista. Vedi [Stato delle funzionalità](/docs/status).
# Automazioni (/it/docs/settings/automations)
Qui si trova Shopify, e anche il bot Discord.
## Shopify [#shopify]
È qui che un negozio collegato risulta collegato. Se hai eseguito l'installazione e Shopify non compare qui, l'installazione non è arrivata in fondo. La causa abituale è non aver effettuato l'accesso al pannello di amministrazione nello stesso browser quando hai fatto clic sul link di installazione.
Le regole di ricompensa si configurano nella sezione Shopify, non qui. Vedi [Shopify](/docs/integrations/shopify).
## Il bot Discord [#the-discord-bot]
Il nostro bot pubblica in un canale scelto da te quando succede qualcosa nell'app.
| Trigger | Cosa pubblica |
| ------------------------- | -------------------------------------------------------------------- |
| Nuova missione pubblicata | Il titolo della missione, la sua descrizione e un link alla tua app. |
| Nuovo evento pubblicato | Il titolo dell'evento, il suo periodo e un link. |
| Fine di un evento | Che l'evento è terminato, con un rimando ai risultati. |
Stanno arrivando altri trigger, tra cui i post del feed di notizie, le modifiche al negozio e i vincitori degli eventi. Vedi [Stato delle funzionalità](/docs/status).
### Configurazione [#setting-it-up]
Installiamo noi il bot nel tuo server e gli diamo il permesso di pubblicare. Dopo, ogni trigger richiede due decisioni nel pannello.
| Campo | Cosa fa | Cosa può andare storto |
| ------------------- | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Canale | Dove arriva il messaggio. | In un canale di annunci tranquillo il messaggio viene visto una volta. In un canale generale affollato viene sepolto in quattro minuti. |
| Ruolo da menzionare | Facoltativo. Il ruolo menzionato con il messaggio. | Menzionare `@everyone` per una missione giornaliera è il modo più rapido per far silenziare il tuo bot in tutto il server. Crea un ruolo a cui i fan aderiscono per scelta. |
Attiva i trigger uno alla volta e osserva il server per una settimana. Una community che pubblica venti missioni al lancio con il trigger di nuova missione attivo pubblica venti messaggi in un'ora, e il ventunesimo viene silenziato.
La configurazione completa, compresi i permessi di cui il bot ha bisogno e il funzionamento delle missioni sui ruoli Discord, è in [Discord](/docs/integrations/discord).
# Requisiti di accesso (/it/docs/settings/gating)
Quasi tutto ciò che pubblichi può stare dietro una condizione: le missioni, i pronostici, i passaggi di una missione a più passaggi, gli articoli del negozio. L'elemento compare comunque, ma non si apre per un fan che non soddisfa la condizione.
Le stesse condizioni ricompaiono ovunque ci siano requisiti di accesso, quindi impararle una volta basta per tutto. Il pannello di amministrazione propone quelle supportate dall'elemento che stai modificando. Si sommano: due condizioni sullo stesso elemento significano che devono essere vere entrambe.
## Le condizioni [#the-conditions]
| Condizione | Si apre per | Usala quando |
| ----------------------------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------- |
| **Activated users only** (solo utenti attivati) | I fan che hanno collegato degli account e completano missioni con regolarità | Qualsiasi cosa gratuita con un premio in palio |
| **Membership** (abbonamento) | I membri Premium, al piano che scegli | Lo scopo è far sì che valga la pena pagare l'abbonamento |
| **Level** (livello) | I fan che hanno raggiunto un livello impostato da te | Vuoi che sia guadagnato e non comprato |
| **Quest** (missione) | I fan che hanno completato una determinata missione | Una cosa deve succedere prima che la successiva abbia senso |
| **Wearable** (oggetto indossabile) | I fan che possiedono un determinato oggetto indossabile | Il pubblico esiste già ed è fatto di collezionisti |
| **Discord** | I fan che hanno un ruolo nel tuo server | Stai già assegnando quel ruolo a mano |
**Activated users è la condizione che quasi tutti usano troppo poco.** Non significa chiunque abbia un account. Significa un fan che ha collegato degli account e continua a completare missioni, quindi un account usa e getta creato per la ricompensa non la soddisfa, mentre un vero fan la soddisfa già. Una missione aperta con qualcosa che vale la pena vincere è esattamente ciò che attira quegli account usa e getta, e questo ne fa il filtro più economico che hai e l'unico che a un fan autentico non costa nulla.
## Cosa vede un fan [#what-a-fan-sees]
L'elemento resta visibile, perché un fan che non vede cosa si sta perdendo non ha motivo di cercare di ottenerlo.
Cambia ciò che l'elemento dice quando il fan prova ad aprirlo. Una condizione che il fan può ancora soddisfare spiega come farlo: un requisito di abbonamento propone il passaggio al piano superiore, un requisito di missione indica la missione da completare, un requisito di livello dà il livello da raggiungere. Una condizione su cui non può agire appare come bloccata, senza altre istruzioni.
# Generale (/it/docs/settings/general)
Quasi tutto ciò che un fan vede prima di fare qualsiasi cosa si trova in questa schermata. Gli account con cui un fan può accedere e che può collegare sono descritti in [Accesso](/docs/settings/sign-in).
## Informazioni di base [#basics]
| Campo | Cosa fa |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Nome | Il nome della community nell'intestazione, nella scheda del browser e nell'anteprima del link quando qualcuno condivide la tua app. |
| Descrizione | La riga sotto il nome, e il testo di quella stessa anteprima del link. Scrivila per qualcuno che non ha mai sentito parlare dell'app. |
## Link importanti [#important-links]
I link che i fan vedono nella tua app: **Website**, **X**, **Discord**, **YouTube**, **Twitch**, **Instagram** e **TikTok**. Compila quelli che gestisci davvero e lascia vuoti gli altri. Un campo vuoto nasconde l'icona invece di mostrarne una che non porta da nessuna parte.
Sono link di visualizzazione. Annunciare le missioni su Discord riguarda le [Automazioni](/docs/settings/automations), e la verifica di un ruolo Discord su una missione richiede [l'integrazione Discord](/docs/integrations/discord).
## Personalizzazione visiva [#visual-customisation]
| Impostazione | Cosa fa | Cosa può andare storto |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Colore d'accento | L'unico colore del brand che attraversa tutta l'app: pulsanti, barre di avanzamento, stati attivi, evidenziazioni. | Un accento pallido su sfondo scuro fa sembrare disattivati i pulsanti. Controlla su un pulsante, non su un campione di colore. |
| Logo | 240x240 consigliato, 5 MB max. Si trova nell'intestazione e nella schermata di accesso. | Qualsiasi logo con un margine incorporato sembra piccolo accanto alle altre app. Ritaglialo stretto. |
| Immagine di copertina | 1920x1080 consigliato, 5 MB max. Il banner in cima all'app. | I dettagli vicino al centro vengono tagliati su un telefono. Tieni volti e testo lontani dai bordi. |
| Sfondi delle pagine | Uno sfondo separato per ogni sezione: missioni, eventi, negozio, classifica, feed di notizie, battlepass, profilo, impostazioni. | Una grafica carica dietro una bacheca delle missioni rende illeggibile il testo delle card. Prova con la bacheca piena, non vuota. |
| Font | Un carattere principale e uno alternativo per i titoli. | Un font senza grassetto appiattisce tutti i titoli dell'app. |
| Raggio degli angoli | Base, grande, compatto o nessuno, applicato a ogni card e a ogni pulsante. | |
| Scala di spaziatura | Base, grande o compatta. Quella compatta fa stare più cose sullo schermo, quella grande si legge con più calma su un telefono. | |
Le modifiche vengono salvate subito e compaiono per i fan al successivo caricamento della pagina. Qui non c'è un passaggio di pubblicazione, quindi modifica il branding quando nessuno è nel mezzo di una missione.
## Tema [#theme]
| Opzione | Cosa ottengono i fan |
| --------------- | ---------------------------------------------------------------------- |
| Dark (scuro) | Quello predefinito, e quello che usa la maggior parte delle community. |
| Light (chiaro) | Solo chiaro. |
| Both (entrambi) | Un interruttore nell'app, ricordato per ogni fan. |
Scegline uno e resta lì, a meno che tu non abbia un motivo. **Both** raddoppia ciò che devi controllare. Ogni immagine di missione, ogni sfondo, ogni logo e ogni colore personalizzato deve funzionare su due fondi. Se il tuo brand è costruito su una palette scura, usa il tema scuro.
## Navigazione [#navigation]
L'ordine e le etichette delle sezioni nella tua barra di navigazione.
* **Riordina** le sezioni in modo che quella a cui tieni di più sia la prima. La maggior parte delle community parte dalle missioni.
* **Rinomina** una sezione, così il negozio può chiamarsi «Shop».
* **Nascondi** una sezione che non usi. Nasconderla la toglie dalla navigazione senza eliminare il contenuto che c'è dietro.
* **Aggiungi un link personalizzato** verso il tuo sito principale, la tua biglietteria o il tuo Discord. Si affianca alle sezioni integrate.
Una barra di navigazione con nove voci sembra un menu di impostazioni. Su un telefono sei bastano e avanzano.
## Etichette delle funzionalità [#feature-labels]
Rinomina un'intera funzionalità in tutta l'app, e non solo nella navigazione. Le missioni diventano Sfide, gli eventi diventano Tornei, il negozio diventa lo Shop.
Scegli tu il singolare e il plurale, e l'etichetta viene applicata ovunque compaia la parola: titoli di pagina, stati vuoti, pulsanti, notifiche. Comunica al tuo referente FanBase le parole che vuoi e le applichiamo noi.
Rinomina prima del lancio. Cambiare la parola dopo che i fan l'hanno imparata ti costa più di quanto ti faccia guadagnare la parola migliore.
## Lingue [#languages]
Inglese, francese, portoghese, italiano e indonesiano. Dicci quali vuoi e le attiviamo sulla tua community.
Attivare una lingua non traduce i tuoi contenuti. I titoli delle missioni, le descrizioni e i testi degli eventi si scrivono lingua per lingua nel pannello di amministrazione, e una missione senza traduzione viene mostrata nella tua lingua predefinita invece di sparire. Se offri il francese, metti in conto qualcuno che scriva ogni missione due volte.
# Ruoli e accessi (/it/docs/settings/roles)
Chiunque metta mano all'app ha bisogno di un accesso personale. Gli account condivisi rendono inutile il registro delle attività e ti costano un pomeriggio quando qualcuno se ne va.
## Invitare un amministratore [#inviting-an-admin]
**Invite admin**, poi l'indirizzo email. La persona riceve un invito e configura il proprio account.
Invita le persone che gestiranno la community ogni giorno.
## Ruoli [#roles]
| Ruolo | A cosa può arrivare |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Admin | Missioni, eventi, invii, membri, ricompense, il negozio e il feed di notizie. Il ruolo normale per un community manager. |
| Content Creator | Solo post e impostazioni. Pensato per un creator o un social media manager che pubblica nel feed di notizie e non deve poter modificare la tua economia. |
Assegna il ruolo Admin ad almeno due persone, così una vacanza non blocca un lancio.
I sottoruoli restringono ancora l'accesso quando vuoi un revisore che gestisce solo gli invii o una persona del marketing che tocca solo il feed di notizie. Chiedici la suddivisione che vuoi.
## Azioni che eseguiamo su richiesta [#actions-we-run-on-request]
Alcune modifiche restano fuori da questi ruoli e le facciamo noi sulla tua community quando lo chiedi. Di' al tuo referente FanBase cosa ti serve e ce ne occupiamo noi. Chiedi i tempi insieme alla modifica, perché cambiano a seconda dell'azione.
| Azione | Dove si applica |
| ----------------------------------------- | ------------------------------------------------- |
| Rinominare le funzionalità in tutta l'app | [Generale](/docs/settings/general#feature-labels) |
| Emettere e revocare chiavi API | [Data API](/docs/integrations/data-api) |
Se un pulsante che ti aspettavi non c'è, questa tabella è il primo posto in cui guardare.
## Trovare le persone [#finding-people]
L'elenco degli amministratori riporta per ogni persona il nome utente nell'app, il nome utente Discord e la data di ingresso. Cerca per nome utente, oppure filtra per data di ingresso per trovare chi è stato aggiunto durante una campagna e mai rimosso.
Rivedi l'elenco ogni trimestre. Le agenzie fanno ruotare il personale, e un account amministratore che nessuno ricorda di aver creato è quello che pubblica una bozza per sbaglio.
# Accesso (/it/docs/settings/sign-in)
Due cose distinte, impostate in modo indipendente.
**L'accesso** è il modo in cui un fan ottiene un account. **Il collegamento dell'account** è ciò che collega in seguito perché le missioni di gioco e quelle social possano essere verificate.
I provider vengono attivati da noi per ogni community, quindi di' al tuo referente FanBase quali vuoi. Il pannello mostra ciò che ha la tua community, e la tabella qui sotto indica ciò che è possibile, non ciò che è attivo.
## Cosa supporta ogni provider [#what-each-provider-supports]
| Provider | Accesso | Collegamento dell'account |
| ------------- | ------- | ------------------------- |
| Google | Sì | |
| Discord | Sì | Sì |
| X | Sì | Sì |
| Twitch | Sì | Sì |
| Shopify | Sì | |
| Steam | | Sì |
| Riot | | Sì |
| FACEIT | | Sì |
| Battle.net | | Sì |
| Epic | | Sì |
| YouTube | | Sì |
| Spotify | | Sì |
| Wallet EVM | | Sì |
| Wallet Solana | | Sì |
Un fan non può scollegare l'account con cui si è registrato, perché quello è l'account. Tutto il resto può scollegarlo e ricollegarlo, entro limiti che esistono per impedire a una sola persona di accumulare ricompense su più account.
## Tempi di attivazione [#lead-time]
Chiedi i provider che ti servono durante l'[onboarding](/docs/getting-started/onboarding) e non la settimana in cui hai pianificato la campagna. Alcuni richiedono tempi veri. Shopify ha bisogno di un'app personalizzata creata per il tuo negozio, i wallet sono dietro un'opzione da attivare, e diversi provider di gaming devono dare la loro approvazione prima di funzionare per la tua community.
Una missione non può essere completata se il suo provider non è attivo per la tua community. Pubblicare una missione Steam con il collegamento Steam disattivato dà ai fan una card che possono aprire, leggere e non finire mai. Controlla il provider prima di creare la missione.
# Azioni nell'app (/it/docs/quests/templates/action)
Nessun account da collegare e niente da revisionare. Questi modelli leggono uno stato che la tua app conosce già, oppure aspettano un solo tocco.
| Modello | Il fan | Tu configuri |
| ------------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------- |
| Auto complete (completamento automatico) | Apre la missione e preme per completarla | Niente |
| Visit link (visita a un link) | Apre il tuo link, poi preme per completare | L'URL |
| Check level (controllo del livello) | Niente. Il modello legge il suo livello | Il livello, e la risorsa di cui leggere i livelli |
| Check resource balance (controllo del saldo di una risorsa) | Preme «Verifica» | La risorsa e l'importo |
| Complete a quest (completare una missione) | Completa la missione che indichi tu | Quale missione |
| Complete a number of quests (completare un numero di missioni) | Completa missioni qualsiasi fino a raggiungere il totale | Quante |
| Referral count (numero di inviti) | Condivide il suo link di invito e altre persone si iscrivono | Quante persone |
| Membership referral count (numero di inviti diventati membri) | Lo stesso link, contato in membri della community | Quante persone |
| Leaderboard ranking (posizione in classifica) | Sale fino a una posizione | La posizione da raggiungere |
| Event leaderboard ranking (posizione nella classifica di un evento) | Sale fino a una posizione all'interno di un evento | L'evento e la posizione da raggiungere |
| Join events (partecipazione a eventi) | Partecipa a eventi | Quanti |
| Own collectibles (possesso di oggetti da collezione) | Ha degli oggetti nel suo inventario | Quanti |
## Auto complete [#auto-complete]
Quello senza alcuna condizione. Il fan apre la missione, preme il pulsante e riceve la ricompensa.
Una missione Auto complete giornaliera, con una piccola ricompensa e un bonus di serie, è il modo meno costoso per far riaprire l'app ai fan domani, e si configura in circa due minuti. Vedi [ricorrenza e serie](/docs/quests/templates#recurrence-and-streaks).
Tieni bassa la ricompensa. Non c'è niente da verificare, quindi la ricompensa è il prezzo di un tocco.
## Visit link [#visit-link]
Il fan apre il tuo URL in una nuova scheda, torna indietro e il pulsante per completare si attiva.
La piattaforma registra il clic e non ciò che succede dopo, quindi non può dirti se il fan ha letto l'articolo o ha chiuso la scheda. Il modello è pensato proprio per questo: portare traffico verso un posto che misuri a parte.
Scrivi la descrizione come se fosse l'istruzione. «Visita il nostro negozio» ottiene un clic. «Visita il nostro negozio e trova il codice nel banner» ottiene un clic e un motivo per restare.
## Check level e Check resource balance [#check-level-and-check-resource-balance]
Due modi per ricompensare i fan per i progressi che hanno già fatto.
**Check level** si completa quando il fan ha raggiunto un livello a tua scelta. I livelli dipendono da una risorsa, di solito gli XP, quindi scegli la risorsa oltre al numero.
**Check resource balance** si completa quando il fan ha una certa quantità di una risorsa a tua scelta. Mostra una riga di avanzamento e un pulsante «Verifica» invece di completarsi da solo, quindi un fan che ha già superato la soglia deve comunque aprire la missione una volta.
Le missioni di livello servono anche a costruire i gradi del battlepass, e quelle sono nascoste dalla bacheca delle missioni. Se nel pannello di amministrazione vedi missioni di livello che nessuno del tuo team ha creato, sono queste. Vedi [Battlepass](/docs/battlepass).
## Complete a quest e Complete a number of quests [#complete-a-quest-and-complete-a-number-of-quests]
**Complete a quest** si completa quando il fan ha completato la missione che indichi tu. È un modo per dare un bonus a una missione che vuoi spingere, senza modificarne la ricompensa.
**Complete a number of quests** conta missioni qualsiasi, quindi è il traguardo di tutta la bacheca: completa cinque cose questa settimana e ottieni qualcosa. Il conteggio parte dal momento in cui il fan avvia la missione, quindi pubblicala all'inizio di una campagna e non alla fine.
Per vincolare una missione a un'altra missione, usa invece un requisito di tipo missione. Lo trovi in [Creare una missione](/docs/quests/creating).
## Referral count e Membership referral count [#referral-count-and-membership-referral-count]
Entrambi si basano sul link di invito del fan, che la card mostra con un pulsante per copiarlo. Nessuno dei due chiede altro al fan.
**Referral count** si completa quando il numero di persone che si sono iscritte tramite il suo link raggiunge il tuo obiettivo. Il fan torna sulla missione per completarla.
**Membership referral count** conta gli invitati che diventano membri della tua community, e si completa da solo nel momento in cui si raggiunge il totale. Il fan non deve premere alcun pulsante.
La piattaforma applica protezioni sugli inviti, e una missione che paga bene attirerà persone che provano ad aggirarle, quindi parti con una ricompensa più bassa di quanto ti sembra giusto e poi alzala.
## Leaderboard ranking e Event leaderboard ranking [#leaderboard-ranking-and-event-leaderboard-ranking]
**Leaderboard ranking** si completa quando il fan raggiunge una posizione che hai impostato nella classifica della community. **Event leaderboard ranking** fa lo stesso all'interno di un evento a tua scelta.
Entrambi sono progressivi: il fan avvia la missione e questa si completa quando ha raggiunto la posizione.
Le missioni basate sulla posizione sono i due modelli di questa pagina per cui una data di scadenza serve di più, perché una posizione si riferisce a una stagione. Vedi [Prima di pubblicare](/docs/quests/templates#before-you-publish).
Scegli una posizione che possa raggiungere più di una manciata di fan. La top 100 premia cento persone. La top 3 ne premia tre. Vedi [Classifiche](/docs/leaderboards).
## Join events [#join-events]
Conta gli eventi a cui un fan ha partecipato, qualunque sia il risultato. Usalo per riempire un evento appena aperto, o come missione per tutta la stagione del tipo «partecipa a tre di questi eventi». Vedi [Eventi](/docs/events).
## Own collectibles [#own-collectibles]
Si completa quando il fan ha un certo numero di oggetti nel suo inventario. Oggetti qualsiasi, contati insieme.
Se vuoi una missione che possano completare solo i fan con un oggetto da collezione specifico, quello è un requisito della missione e non questo modello. Vedi [Creare una missione](/docs/quests/creating) e [Oggetti da collezione e personalizzazione](/docs/rewards/collectibles).
## I modelli di visita nelle pagine social [#the-visit-templates-on-the-social-pages]
Altri quattro modelli funzionano esattamente come Visit link.
| Modello | Dove è documentato |
| ------------------------------------------------------- | ------------------------------------------------------------------ |
| Visit a Facebook page (visitare una pagina Facebook) | [Facebook, Instagram e TikTok](/docs/quests/templates/social/meta) |
| Visit an Instagram page (visitare una pagina Instagram) | [Facebook, Instagram e TikTok](/docs/quests/templates/social/meta) |
| View an Instagram post (vedere un post di Instagram) | [Facebook, Instagram e TikTok](/docs/quests/templates/social/meta) |
| View a TikTok post (vedere un post di TikTok) | [Facebook, Instagram e TikTok](/docs/quests/templates/social/meta) |
# Modelli di missione (/it/docs/quests/templates)
Un modello decide cosa osserva la piattaforma, cosa vale come prova e quali campi compili prima di poter pubblicare.
Tutto il resto di una missione è uguale qualunque modello tu scelga: il titolo, la descrizione, l'immagine, la ricompensa, la programmazione, i requisiti di accesso. Trovi tutto in [Creare una missione](/docs/quests/creating).
Il modello di una missione e la sua ricompensa non si possono più modificare una volta che la missione esiste, in bozza o pubblicata. Tutto il resto rimane modificabile. Se hai scelto il modello sbagliato, duplica la missione e ricomincia. Vedi [Gestire le missioni](/docs/quests/managing).
## Le famiglie [#the-families]
Più di 150 modelli. Il selettore li raggruppa in Actions, Answers, Social e Gaming, e aggiunge i modelli on-chain per le community che hanno attivato il collegamento del wallet.
Visitare un link, raggiungere un livello, avere un saldo, invitare un amico, partecipare a un evento.
Quiz, sondaggio, pronostico, testo libero, caricamento di un'immagine, email, wallet.
Controlli del saldo di token e NFT sulle chain EVM e su Solana.
### Social [#social]
| Pagina | Modelli | Cosa puoi chiedere |
| ------------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| [X](/docs/quests/templates/social/x) | 9 | Seguire, mettere mi piace, ripubblicare, citare, pubblicare con un hashtag o un link, e tre controlli sul profilo del fan. |
| [Discord](/docs/quests/templates/social/discord) | 2 | Entrare nel tuo server, o avere un ruolo al suo interno. |
| [YouTube](/docs/quests/templates/social/youtube) | 2 | Visitare un canale, guardare un video. Iscrizione e mi piace sono stati ritirati. |
| [Twitch](/docs/quests/templates/social/twitch) | 3 | Seguire, abbonarsi, guardare una diretta per un certo numero di ore. |
| [Facebook, Instagram e TikTok](/docs/quests/templates/social/meta) | 4 | Visitare una pagina, vedere un post su Instagram o TikTok. |
| [Spotify](/docs/quests/templates/social/spotify) | 3 | Seguire un artista o una playlist, o essere tra gli ascoltatori abituali di un artista. |
### Gaming [#gaming]
| Pagina | Modelli | Cosa puoi chiedere |
| -------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------- |
| [Steam](/docs/quests/templates/gaming/steam) | 3 | Ore giocate, ore in un gioco specifico, aggiunta di un gioco alla lista dei desideri. |
| [Counter-Strike 2](/docs/quests/templates/gaming/cs2) | 19 | Partite, vittorie, percentuale di vittorie, uccisioni, colpi alla testa, MVP, bombe, danni, denaro. |
| [Dota 2](/docs/quests/templates/gaming/dota-2) | 11 | Last hit, deny, danni alle torri, uccisioni, assist, rango, vittorie con un eroe. |
| [FACEIT](/docs/quests/templates/gaming/faceit) | 9 | ELO, livello di abilità, appartenenza a un hub e posizione nella sua classifica, e cinque statistiche di CS2. |
| [Riot Games](/docs/quests/templates/gaming/riot-games) | Pagina comune | Collegamento, regioni e reset di stagione che valgono per tutti e tre i giochi Riot. |
| [League of Legends](/docs/quests/templates/gaming/league-of-legends) | 23 | ARAM, classificate, obiettivi di corsia, uccisioni, torri, lumi, mostri epici. |
| [Valorant](/docs/quests/templates/gaming/valorant) | 18 | Uccisioni per zona colpita, piazzamenti e disinneschi della Spike, uso delle abilità, tempo di gioco. |
| [Teamfight Tactics](/docs/quests/templates/gaming/teamfight-tactics) | 4 | Vittorie, percentuale di vittorie, raggiungere un rango, migliorare un rango. |
| [World of Warcraft](/docs/quests/templates/gaming/world-of-warcraft) | 16 | PVP, dungeon, raid, livello del personaggio, fama, imprese. |
## Le quattro forme [#the-four-shapes]
La forma che pubblichi cambia l'aspetto della card e il tempo necessario per completare la missione.
| Forma | Il fan | Modelli che funzionano così |
| ---------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Un solo tocco | Apre la missione, fa ciò che è richiesto, preme per completare | Visite a link, la maggior parte dei modelli social, controlli di livello e di saldo, controlli di rango e di obiettivi nei giochi, saldi on-chain |
| Avvia, poi torna | Preme per avviare, gioca o guarda, torna quando il contatore è pieno | Modelli gaming che contano partite, vittorie o ore, guardare una diretta su Twitch, acquisire token, modelli di classifica e di evento |
| Invia qualcosa | Scrive, sceglie o carica un valore | Quiz, sondaggio, risposta, testo, immagine, email, wallet, pronostico |
| Niente | La missione si completa da sola | Auto complete, Membership referral count |
Niente conta prima che il fan prema per avviare. Una missione della seconda forma ignora tutto ciò che è successo prima: un fan che ha giocato dieci partite, guardato due ore o comprato i token prima di aprirla parte da zero, e la descrizione è l'unico posto in cui puoi avvisarlo.
## Modelli che richiedono un account collegato [#templates-that-need-a-linked-account]
Collegare un account è una cosa diversa dall'accedere. Un fan accede una volta, poi collega gli account che servono alle tue missioni, e la card della missione mostra il passaggio di collegamento su una riga a parte finché non diventa verde.
| Account | Serve per | Modelli |
| ------------- | ------------------------------------------------------- | -------------------------------------------------------------------- |
| X | Tutti i modelli X | [X](/docs/quests/templates/social/x) |
| Discord | Entrambi i modelli Discord | [Discord](/docs/quests/templates/social/discord) |
| Twitch | Seguire, abbonarsi e guardare una diretta | [Twitch](/docs/quests/templates/social/twitch) |
| Spotify | Tutti e tre i modelli Spotify | [Spotify](/docs/quests/templates/social/spotify) |
| Steam | Steam, Counter-Strike 2 e Dota 2 | [Steam](/docs/quests/templates/gaming/steam) |
| Riot | League of Legends, Teamfight Tactics e Valorant | [Riot Games](/docs/quests/templates/gaming/riot-games) |
| Battle.net | World of Warcraft | [World of Warcraft](/docs/quests/templates/gaming/world-of-warcraft) |
| FACEIT | Tutti e nove i modelli FACEIT | [FACEIT](/docs/quests/templates/gaming/faceit) |
| Wallet EVM | Saldi ERC-20, ERC-20 in staking, ERC-721 e token nativi | [On-chain](/docs/quests/templates/on-chain) |
| Wallet Solana | Saldi di NFT Solana | [On-chain](/docs/quests/templates/on-chain) |
Nessun modello di Actions o Answers richiede un collegamento. Nemmeno i modelli Facebook, Instagram, TikTok e YouTube, che registrano il clic invece di leggere un account.
Tre cose vanno storte abbastanza spesso da doverle mettere in conto.
L'account deve essere attivo per la tua community. Quali account un fan può collegare è un'impostazione di ogni singola community, e una missione il cui account è disattivato non può essere completata da nessuno. Vedi [Accesso](/docs/settings/sign-in).
Riot e Battle.net richiedono anche una regione. Il fan sceglie un server quando collega l'account. Finché non lo fa, la missione gli chiede di selezionare una regione invece di avviarsi.
I collegamenti scadono. Quando un account collegato scade, la card chiede al fan di ricollegarlo, e ogni missione in corso resta in attesa. Non si perde nulla, ma ai tuoi occhi un fan che non si ricollega sembra un fan che ha abbandonato la missione.
## Verifica [#verification]
La maggior parte dei modelli si verifica da sola. La piattaforma legge l'account collegato, il wallet o lo stato della tua app, e decide.
Il controllo avviene una sola volta, quando il fan completa la missione, e dopo non si ricontrolla nulla. Un fan che smette di seguirti, lascia il tuo server o vende il token la settimana dopo si tiene ciò che ha guadagnato. Imposta la missione con ricorrenza settimanale se la condizione deve valere nel tempo e non una volta sola.
Il testo visualizzato non viene mai controllato. Il nome dell'artista, il nome del canale, il nome del gioco, il simbolo del token, il nome del server e il nome del ruolo che scrivi sono ciò che i fan leggono sulla card, e niente li confronta con l'account, il contratto o il canale verificati davvero. Un errore di battitura lì è visibile a tutti i fan e invisibile al controllo.
Due modelli sono revisionati da una persona: gli **invii di testo** e gli **invii di immagini**. Il fan invia, la card mostra «In attesa di revisione» e non viene pagato nulla finché qualcuno non approva. Entrambi hanno un'opzione di approvazione automatica che salta la coda e paga al momento dell'invio. La coda, l'esportazione in blocco e il flusso di approvazione sono in [Revisione degli invii](/docs/quests/submissions).
I modelli di visita registrano il clic, non ciò che succede dopo. Usali quando il clic è l'obiettivo, e scrivi la descrizione in modo che il fan sappia cosa volevi.
## Prima di pubblicare [#before-you-publish]
Leggi la riga dell'obiettivo nell'anteprima della missione. Quella frase è ciò che legge il fan, ed è il modo più rapido per accorgerti di un modello che non è quello che intendevi. Diversi modelli stanno uno accanto all'altro nel selettore e differiscono solo in quella riga: raggiungere un rango o migliorare un rango, una percentuale con un numero minimo di partite o la stessa percentuale senza minimo.
Imposta una scadenza per tutto ciò che è stagionale. Una missione legata a una stagione classificata, a una classifica, a un evento o a uno sponsor deve uscire dalla pubblicazione, non restare lì a chiedere qualcosa che è finito. Indica la scadenza anche nella descrizione, perché la data di scadenza rimuove la missione senza spiegazioni, e solo la descrizione può dire a un fan quanto tempo ha.
## Missioni a più passaggi [#multi-step-quests]
Una missione a più passaggi riunisce più passaggi in un'unica card con una sola ricompensa alla fine, e il fan vede tutti i passaggi fin dall'inizio. Si costruisce nel modulo della missione e non scegliendo un modello, quindi funziona con qualunque modello. Vedi [Creare una missione](/docs/quests/creating) per i campi e [Missioni a più passaggi](/docs/quests/creating#multi-step-quests) per capire quando usarla.
I requisiti sono un controllo diverso. Decidono se un fan può completare la missione, e sono descritti in [Imposta le proprietà avanzate](/docs/quests/creating#set-the-advanced-properties).
## Ricorrenza e serie [#recurrence-and-streaks]
Per impostazione predefinita una missione si svolge una volta sola. Impostala con rinnovo giornaliero o settimanale e torna con quella cadenza. Un fan che la completa in rinnovi consecutivi ottiene un bonus di serie che fa crescere la ricompensa fino a un tetto che imposti tu, e saltarne uno azzera la serie. La ricorrenza funziona con tutti i modelli di queste pagine, quindi una missione Auto complete giornaliera e una missione Counter-Strike 2 settimanale sono entrambe normali. I campi, e cosa succede quando il tetto è impostato male, sono in [Creare una missione](/docs/quests/creating).
## Chiedere un modello o un gioco [#asking-for-a-template-or-a-game]
Tre elementi legati ai modelli sono in coda. Tutto il resto non viene pianificato finché un partner non lo chiede.
| Elemento | Stato | Cosa ti darebbe |
| ------------------------------------------ | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Verifica di mi piace e follow su Instagram | Pianificato | Missioni Instagram che controllano l'azione invece della visita. Vedi [Facebook, Instagram e TikTok](/docs/quests/templates/social/meta). |
| Altri modelli Discord | Pianificato | Oltre a entrare in un server e avere un ruolo. Reazioni e attività nei messaggi sono le due richieste dei partner. |
| Altri modelli Twitch | Pianificato | Oltre a follow, abbonamento e tempo di visione. |
### Nuovi giochi [#new-games]
Le integrazioni dei giochi vengono sviluppate quando un partner ne ha bisogno. Tutti i giochi presenti oggi nella libreria ci sono arrivati così, e gli ultimi arrivi sono venuti da partner con una data di lancio.
Chiedi il gioco che vuoi al tuo referente FanBase. È questo che cambia l'ordine della lista. Un gioco con un'API pubblica e un partner alle spalle è questione di settimane. Un gioco senza API pubblica non può essere integrato.
Lo stesso vale per un modello in un gioco che hai già. Se a Counter-Strike 2 manca proprio la statistica che serve alla tua campagna, è un lavoro molto più piccolo di un nuovo gioco.
### Integrazioni specifiche per un partner [#partner-specific-integrations]
Alcuni modelli esistono per una sola community. Apeiron è l'esempio attuale: tre modelli, attivi per la community che li ha chiesti e invisibili per tutte le altre. Se hai un gioco tuo, o quello di un partner, è questa la forma che prende il lavoro.
# On-chain (/it/docs/quests/templates/on-chain)
Tutti i modelli di questa pagina leggono un saldo e nient'altro. Il fan collega un wallet, la piattaforma guarda cosa contiene quell'indirizzo, e la missione è superata oppure no.
Gli oggetti sono conservati nella tua community e non su una chain. I modelli di questa pagina e il collegamento del wallet non cambiano. Vedi [Stato delle funzionalità](/docs/status#retired).
## I modelli [#the-templates]
| Modello | Superato quando il fan | Tu configuri |
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Hold ERC-20 | Possiede almeno l'importo che imposti | Chain, contratto del token, importo, e il nome e il simbolo del token mostrati ai fan |
| Hold staked ERC-20 | Possiede almeno quell'importo in staking | Gli stessi campi, più il contratto di staking |
| Acquire ERC-20 | Aggiunge l'importo dopo aver avviato la missione | Chain, contratto del token e importo da acquisire |
| Hold ERC-721 | Possiede almeno il numero che imposti di una collezione | Chain, indirizzo della collezione, numero e nome della collezione |
| Hold native token | Possiede almeno l'importo impostato nella moneta nativa della chain | Chain e importo |
| Hold a Solana NFT | Possiede almeno il numero che imposti di una collezione | Collezione e numero |
### Possedere, e acquisire [#hold-and-acquire]
Cinque dei sei sono un'istantanea. Il fan apre la missione, la piattaforma legge il suo saldo e, se raggiunge il tuo numero, la missione si completa. Un fan che soddisfa già il requisito la completa con un solo tocco.
**Acquire ERC-20** è l'eccezione. Scatta un'istantanea del saldo del fan quando preme per avviare, e si completa quando il fan ha aggiunto il tuo importo a quel saldo. Un fan con mille token che avvia una missione di acquisizione da cento deve arrivare a millecento per completarla, e un fan che compra prima dell'istantanea non ha comprato nulla che la missione possa vedere. Dillo nella descrizione.
## Gli account che il fan collega [#accounts-the-fan-links]
Sulle chain EVM il fan collega un wallet e firma un messaggio per dimostrare di controllare l'indirizzo. Nessuna transazione e nessun costo di gas. La schermata di consenso dice cosa può fare l'app, cioè leggere i dati pubblici della chain. Solana funziona allo stesso modo, in sola lettura, tramite Phantom, Solflare o Backpack.
Il collegamento del wallet EVM e quello del wallet Solana sono impostazioni separate, entrambe disattivate per impostazione predefinita, quindi attivarne una non attiva l'altra. Vedi [Accesso](/docs/settings/sign-in).
## Configurare nel modo giusto [#getting-the-configuration-right]
La chain e il contratto sono l'intero controllo. Un indirizzo di contratto della rete sbagliata sembra corretto e non corrisponde a nulla. Incollalo da un block explorer della chain che ti interessa, non da un risultato di ricerca.
Il nome e il simbolo del token non vengono letti dal contratto. Li scrivi tu, e sono [testo visualizzato](/docs/quests/templates#verification), come il nome della collezione nei modelli NFT.
Gli importi sono quelli che un fan riconoscerebbe. Inserisci il numero come appare in un wallet, non nell'unità più piccola del token.
Le testnet sono un'impostazione separata. Le community che hanno bisogno di fare prove su una rete di test possono farla attivare. Chiedi al tuo referente FanBase invece di puntare una missione attiva verso un contratto di test.
# Risposte e invii (/it/docs/quests/templates/submission)
Otto modelli che chiedono al fan di mandare qualcosa, invece di osservare qualcosa che ha fatto. Sei si completano da soli e due passano da una coda di revisione.
| Modello | Il fan | Tu configuri | Revisione |
| ----------------------- | --------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------- |
| Quiz | Sceglie un'opzione da un elenco | Le opzioni, e quale è quella corretta | No |
| Poll (sondaggio) | Sceglie un'opzione da un elenco | Le opzioni, e se i risultati restano privati | No |
| Answer (risposta) | Scrive una risposta | La risposta corretta, la distinzione tra maiuscole e minuscole, la corrispondenza esatta | No |
| Text (testo) | Scrive un testo libero | L'approvazione automatica, attiva o no | Sì, salvo approvazione automatica |
| Image (immagine) | Carica un'immagine | L'approvazione automatica, attiva o no | Sì, salvo approvazione automatica |
| Email | Scrive un indirizzo email | La richiesta, nella descrizione | No |
| Wallet | Incolla un indirizzo wallet | La richiesta, nella descrizione | No |
| Prediction (pronostico) | Sceglie un esito prima del blocco | Le opzioni e l'ora di blocco | No, lo risolvi tu |
## Quiz [#quiz]
Una domanda con un elenco di opzioni e una sola risposta giusta. Il fan ne sceglie una e invia.
La correzione avviene sul server, quindi la risposta corretta non viene mai inviata al dispositivo del fan e non si può ricavare dall'app. Una risposta sbagliata fa fallire il tentativo. Il limite di tentativi della missione decide se il fan può riprovare, e un quiz con un solo tentativo e una domanda difficile genererà messaggi all'assistenza.
Solo un'opzione può essere corretta. Se la tua domanda ha due risposte difendibili, usa invece un sondaggio o un invio di risposta.
## Poll [#poll]
Lo stesso elenco di opzioni, senza risposta giusta. Ogni fan che vota completa la missione.
I risultati vengono mostrati come percentuale e numero di voti dopo che il fan ha inviato. Attiva **private** (privato) e i risultati restano nascosti ai fan. Usa questa opzione quando chiedi qualcosa su cui intendi agire, non qualcosa da pubblicare.
## Answer [#answer]
Un indovinello, o un codice letto ad alta voce durante una diretta. Il fan lo scrive e la piattaforma lo confronta con la risposta che hai salvato.
Due opzioni cambiano quanto è rigido il confronto.
| Impostazione | Disattivata | Attivata |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- |
| Case sensitive (distinzione tra maiuscole e minuscole) | Fanbase, FANBASE e fanbase vanno tutti bene | Va bene solo la combinazione di maiuscole e minuscole che hai scritto |
| Match exactly (corrispondenza esatta) | Una risposta che contiene il tuo testo va bene, quindi un fan può rispondere con una frase | L'intero invio deve essere uguale alla tua risposta, carattere per carattere |
Con entrambe disattivate hai la combinazione tollerante, che è l'impostazione giusta per tutto ciò che un fan scrive a memoria. Con entrambe attivate hai quella adatta a un codice, ma farà fallire un fan che incolla uno spazio finale, quindi scrivi nella descrizione che il codice deve essere esatto.
## Text [#text]
Scrittura libera. Un parere, un'opinione forte, una didascalia, cento parole sul perché la maglia dovrebbe andare a loro.
Il fan invia almeno tre caratteri. Per impostazione predefinita l'invio finisce nella coda di revisione e non viene pagato nulla finché qualcuno del tuo team non lo approva. Attiva **auto approve** (approvazione automatica) e il fan viene pagato nel momento in cui preme il pulsante di invio.
L'approvazione automatica su una missione di testo paga per qualsiasi cosa, compresi tre caratteri senza senso. Usala quando la ricompensa è piccola e lo scopo è la partecipazione. Lasciala disattivata quando la ricompensa è abbastanza alta da attirare abusi, e metti in conto il tempo di revisione prima di pubblicare.
## Image [#image]
Un caricamento. Una fan art, una foto del giorno di partita, uno screenshot di un risultato, uno scontrino.
Un'immagine per invio, trascinata o selezionata. La card mostra «In attesa di revisione» finché qualcuno non decide, e il fan riceve una notifica in entrambi i casi. Anche qui è disponibile **Auto approve**, con la stessa avvertenza del testo, e una missione con immagine di solito paga di più.
Un rifiuto può includere una nota per il fan, che gli dice cosa correggere. La coda e l'esportazione in blocco sono in [Revisione degli invii](/docs/quests/submissions).
## Email [#email]
Un solo campo email, convalidato come indirizzo email prima di essere accettato.
Non c'è niente da configurare. Tutto ciò che il fan deve sapere va nella descrizione, compreso l'uso che farai dell'indirizzo. Gli invii si esportano dal pannello di amministrazione insieme a tutti gli altri.
## Wallet [#wallet]
Un solo campo di testo che accetta un indirizzo EVM: 40 caratteri esadecimali, con o senza lo `0x` iniziale. Tutto il resto viene rifiutato nell'app.
Serve per whitelist e liste di airdrop. Non collega un wallet all'account del fan e non controlla alcun saldo, quindi un fan può scrivere un indirizzo che non è suo. Se ti serve un wallet verificato dalla piattaforma, devi usare il collegamento del wallet e i [modelli on-chain](/docs/quests/templates/on-chain).
## Pronostici [#predictions]
Un pronostico ha una scadenza e una risposta giusta, cosa che nessun'altra famiglia qui ha, quindi ha [una pagina a parte](/docs/predictions).
# Counter-Strike 2 (/it/docs/quests/templates/gaming/cs2)
Tutti i modelli di questa pagina leggono le statistiche della modalità Competitiva, e gli stessi numeri si possono farmare contro i bot. Per questo FACEIT esiste come alternativa.
Tutti i modelli richiedono al fan di [collegare il suo account Steam](/docs/quests/templates#templates-that-need-a-linked-account).
L'API delle statistiche è affidabile in modalità Competitiva. Le altre modalità comunicano dati incoerenti, quindi un fan che macina partite in Casual può fare tutto ciò che hai chiesto senza vedere muoversi nulla. Scrivi «in Competitiva» nella descrizione.
Le uccisioni sui bot contano. Finiscono negli stessi totali, quindi un fan che vuole farmare una missione sul numero di uccisioni può farlo. Dai per scontato che i numeri più alti della tua bacheca verranno raggiunti così.
FACEIT evita entrambi i problemi. Lo stesso tipo di missione, se passa da [FACEIT](/docs/quests/templates/gaming/faceit), si gioca in una vera coda competitiva senza bot. Usa FACEIT per tutto ciò che ha una ricompensa che vale la pena farmare.
## Prestazioni nei round [#round-performance]
| Modello | Cosa vede il fan | Tu imposti |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| Games played | Giocare un certo numero di partite | Partite |
| Games won | Vincere un certo numero di partite | Partite |
| Win rate | Una percentuale di vittorie obiettivo | Percentuale di vittorie obiettivo |
| Win rate per games | Giocare almeno un certo numero di partite e mantenere una percentuale di vittorie superiore al tuo obiettivo | Partite minime, percentuale di vittorie obiettivo |
| Pistol rounds | Vincere un certo numero di pistol round | Pistol round |
| MVP titles | Ottenere un certo numero di titoli MVP | Titoli MVP |
| MVP titles per games | Ottenere un certo numero di titoli MVP | Titoli MVP |
| Total MVPs | Un numero totale di MVP | Totale MVP |
## Obiettivi del round [#round-objectives]
| Modello | Cosa vede il fan | Tu imposti |
| ------------- | --------------------------------------------- | ---------- |
| Bombs planted | Piazzare un certo numero di bombe | Bombe |
| Damage dealt | Infliggere una certa quantità di danni | Danni |
| Money earned | Guadagnare una certa somma di denaro di gioco | Denaro |
I modelli sugli obiettivi premiano chi gioca bene il round invece di pensare solo alle uccisioni, quindi sono adatti a una community che gioca insieme. Un fan può piazzare la bomba solo quando è dal lato T, quindi imposta il numero pensando a una sessione reale e non a un numero di round.
## Prestazioni nelle uccisioni [#kill-performance]
| Modello | Cosa vede il fan | Tu imposti |
| --------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| Kill count | Ottenere un numero totale di uccisioni | Uccisioni |
| Kill count per games | Uccidere un certo numero di nemici | Uccisioni |
| K/D ratio | Giocare almeno un certo numero di partite e mantenere un K/D superiore al tuo obiettivo | Partite minime, K/D obiettivo |
| Kills to deaths ratio | Mantenere un K/D superiore al tuo obiettivo | K/D obiettivo |
| Headshot kills | Ottenere un certo numero di uccisioni con colpo alla testa | Uccisioni con colpo alla testa |
| Headshot rate | Giocare almeno un certo numero di partite e mantenere una percentuale di colpi alla testa superiore al tuo obiettivo | Partite minime, percentuale obiettivo |
| Enemy weapon kills | Ottenere uccisioni con armi raccolte dai nemici | Uccisioni |
| Knife kills | Ottenere un certo numero di uccisioni con il coltello | Uccisioni con il coltello |
Le uccisioni con il coltello e quelle con armi nemiche richiedono tempo, quindi ricompensale come si deve.
## I modelli in coppia [#the-paired-templates]
Quattro statistiche compaiono due volte nel selettore: uccisioni, titoli MVP, percentuale di vittorie e K/D. I due modelli di una coppia leggono la stessa statistica e differiscono in ciò che puoi impostare. In ogni coppia, uno dei due accetta un **numero minimo di partite** oltre all'obiettivo, ed è questo che impedisce a un fan di completare una missione sul K/D grazie a un solo round fortunato.
Dove esiste una coppia, scegli il modello che ti lascia impostare un numero minimo di partite, poi [leggi la riga dell'obiettivo nell'anteprima](/docs/quests/templates#before-you-publish) per confermare di aver preso quello giusto.
## Comporre una bacheca Counter-Strike [#writing-a-counter-strike-board]
Le missioni a percentuale hanno bisogno di un minimo. Un obiettivo di percentuale di vittorie o di K/D senza un minimo di partite è un lancio di moneta, e un fan lo completerà per caso. Dieci partite sono un minimo ragionevole per tutto ciò che ricompensi con un valore reale.
I totali sono adatti alle missioni giornaliere, le percentuali a quelle settimanali. «Ottieni 30 uccisioni» è una sessione. «Mantieni un K/D di 1,2 su 20 partite» è una settimana.
Tutti i modelli di questa pagina sono progressivi, quindi [nulla conta prima dell'avvio](/docs/quests/templates#the-four-shapes).
Una missione legata a un evento o a uno sponsor non dovrebbe restare attiva dopo la loro fine. Vedi [Prima di pubblicare](/docs/quests/templates#before-you-publish).
# Dota 2 (/it/docs/quests/templates/gaming/dota-2)
Undici modelli sullo stesso collegamento Steam usato da Counter-Strike 2.
Ranked All-pick è la modalità che questi modelli leggono in modo affidabile. Un fan che gioca in Turbo o in una modalità evento può fare tutto ciò che la missione chiede senza vedere muoversi nulla, quindi indica la modalità nella descrizione.
## Obiettivi [#objectives]
| Modello | Cosa vede il fan | Tu imposti |
| ------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| Tower damage | Infliggere una certa quantità di danni alle torri nemiche | Danni |
| Sentry wards | Comprare un certo numero di sentry ward | Sentry ward |
| Win rate per games | Giocare almeno un certo numero di partite e mantenere una percentuale di vittorie superiore al tuo obiettivo | Partite minime, percentuale di vittorie obiettivo |
## Prestazioni in corsia [#lane-performance]
| Modello | Cosa vede il fan | Tu imposti |
| ------------------- | ---------------------------------------------------------------------- | --------------------------------- |
| Last hits | Ottenere un certo numero di last hit | Last hit |
| Last hits per games | Raggiungere una media di last hit su almeno un certo numero di partite | Media di last hit, partite minime |
| Denies | Ottenere un certo numero di deny | Deny |
Last hits per games è il migliore dei due modelli sui last hit per tutto ciò che ricompensi davvero, perché un totale premia chi gioca tanto e una media premia chi gioca bene.
## Prestazioni nelle uccisioni [#kill-performance]
| Modello | Cosa vede il fan | Tu imposti |
| --------- | --------------------------------------------------------------------------------------- | ----------------------------- |
| Kills | Uccidere un certo numero di nemici | Uccisioni |
| Assists | Ottenere un certo numero di assist | Assist |
| K/D ratio | Giocare almeno un certo numero di partite e mantenere un K/D superiore al tuo obiettivo | Partite minime, K/D obiettivo |
In un gioco in cui i support fanno la maggior parte del lavoro senza comparire nei conteggi delle uccisioni, una missione sugli assist è quella che i tuoi giocatori support possono vincere.
## Rango ed eroi [#rank-and-heroes]
| Modello | Cosa vede il fan | Tu imposti |
| --------------- | ------------------------------------------------------ | ------------------ |
| Rank | Raggiungere un rango | Il rango obiettivo |
| Win with a hero | Vincere un certo numero di partite con un eroe preciso | Eroe, vittorie |
**Rank** verifica dove si trova il fan, quindi un fan già al tuo obiettivo completa la missione appena la avvia. Usalo per individuare una fascia della tua community, non per far salire qualcuno.
**Win with a hero** chiede vittorie con un eroe scelto da te: vincere tre partite con l'eroe per cui il tuo giocatore è famoso, vincerne tre con quello che è stato bannato nell'ultima serie. È il modello da preferire con uno sponsor, perché nomina una cosa e non un numero.
Scegli l'eroe pensando alle partite che giocano i tuoi fan. Un eroe bannato nella maggior parte delle partite ad alto MMR dà una missione che i tuoi giocatori migliori non possono completare.
## Comporre una bacheca Dota [#writing-a-dota-board]
Tutti i modelli di conteggio di questa pagina sono [progressivi](/docs/quests/templates#the-four-shapes). Rank è l'eccezione, e legge il rango che il fan ha già.
Le partite sono lunghe. Una missione che chiede dieci vittorie vale una settimana di serate, e deve ricompensare di conseguenza.
Le missioni a percentuale hanno bisogno di un minimo. Imposta un numero minimo di partite su tutto ciò che ha una media o un rapporto come obiettivo, altrimenti basta una buona partita per completarlo.
Sentry wards è il modello sulle ward della libreria. Non sono previsti altri modelli su ward o gemme.
# FACEIT (/it/docs/quests/templates/gaming/faceit)
L'alternativa competitiva alla lettura delle statistiche di Counter-Strike 2 da Steam. Le partite FACEIT si giocano in una vera coda, senza bot.
Tutti i modelli richiedono al fan di [collegare il suo account FACEIT](/docs/quests/templates#templates-that-need-a-linked-account).
## Missioni di hub [#hub-quests]
| Modello | Superato quando il fan | Tu imposti |
| ----------------------- | -------------------------------------------------- | ---------------------------------------- |
| ELO | Raggiunge un punteggio ELO | ELO obiettivo |
| Skill level | Raggiunge un livello di abilità | Livello di abilità obiettivo, da 1 a 10 |
| Hub membership | È membro del tuo hub | ID dell'hub |
| Hub leaderboard ranking | Raggiunge una posizione in una classifica dell'hub | ID della classifica, posizione obiettivo |
**Hub membership** è il primo da pubblicare se gestisci un hub. È una verifica unica.
**ELO e Skill level** leggono il punto in cui il fan si trova già. Un fan sopra il tuo obiettivo li completa subito. Usali per dividere la tua community in fasce.
**Hub leaderboard ranking** richiede un ID della classifica, che trovi nell'URL della classifica dopo averla configurata su FACEIT. Non c'è modo di cercarlo dal pannello di amministrazione, quindi configura prima la classifica.
Le classifiche funzionano a stagioni e le missioni no, quindi [imposta una scadenza](/docs/quests/templates#before-you-publish) su ogni missione di classifica e indica nella descrizione sia le date della classifica sia il termine per il riscatto. Un fan che raggiunge la posizione e torna a riscattare dopo la scadenza della missione ha un reclamo che non puoi risolvere.
## Counter-Strike 2 su FACEIT [#counter-strike-2-on-faceit]
| Modello | Cosa vede il fan | Tu imposti |
| -------------- | -------------------------------------------- | ---------------- |
| Kill count | Uccidere un certo numero di nemici | Uccisioni |
| MVP count | Ottenere un certo numero di MVP | MVP |
| Headshot count | Ottenere un certo numero di colpi alla testa | Colpi alla testa |
| Assists | Ottenere un certo numero di assist | Assist |
| Matches won | Vincere un certo numero di partite | Partite |
Cinque statistiche contro le diciannove di [Counter-Strike 2](/docs/quests/templates/gaming/cs2), e lo scambio conviene ogni volta che c'è una ricompensa che vale la pena farmare.
Tutti e cinque sono [progressivi](/docs/quests/templates#the-four-shapes).
## Scegliere tra FACEIT e Steam [#choosing-between-faceit-and-steam]
| Vuoi | Usa |
| ------------------------------------------------------------------------------------------ | ----------------------------------------------------- |
| Un premio importante, uno sponsor, qualsiasi cosa competitiva | FACEIT |
| Una statistica che FACEIT non copre, come le uccisioni con il coltello o le bombe piazzate | [Counter-Strike 2](/docs/quests/templates/gaming/cs2) |
| Raggiungere i fan che giocano a Counter-Strike ma non su FACEIT | Counter-Strike 2 |
| Costruire una bacheca delle missioni attorno al tuo hub | FACEIT |
Usarli entrambi è normale. Lo schema abituale è una bacheca Steam ampia e poco costosa per tutti, con sopra due o tre missioni FACEIT con ricompense vere.
## Collegamento, e da dove vengono gli ID [#linking-and-where-the-ids-come-from]
Il collegamento FACEIT è disattivato per impostazione predefinita. Chiedi al tuo referente FanBase di attivarlo. Vedi [Accesso](/docs/settings/sign-in).
Gli ID degli hub e gli ID delle classifiche vengono entrambi dagli URL di FACEIT. Copiali dalla barra degli indirizzi invece di riscriverli. Un ID sbagliato fa fallire la verifica per ogni fan, compresi quelli già nell'hub.
# League of Legends (/it/docs/quests/templates/gaming/league-of-legends)
Ventitré modelli, la libreria di gioco più grande della piattaforma.
Tutti i modelli richiedono un account Riot collegato con una regione selezionata. Leggi prima [Riot Games](/docs/quests/templates/gaming/riot-games) per il collegamento, i reset di stagione e i limiti di frequenza.
## ARAM [#aram]
| Modello | Cosa vede il fan | Tu imposti |
| ------------------- | ----------------------------------------------------------------------------- | ------------- |
| High damage in ARAM | Essere il giocatore che infligge più danni in un certo numero di partite ARAM | Partite |
| Dodge skillshots | Schivare un certo numero di skillshot in ARAM | Skillshot |
| Pentakill in ARAM | Ottenere un certo numero di pentakill in ARAM | Pentakill |
| S grade in ARAM | Ottenere il voto S o superiore un certo numero di volte in ARAM | Volte |
| Snowballs | Colpire i campioni con un certo numero di palle di neve | Palle di neve |
Parti da qui. ARAM è una sola coda, venti minuti, senza la pressione delle classificate e senza l'ansia da promozione, e per questo sono le missioni che la parte più ampia della tua community completerà.
## Prestazioni generali [#general-performance]
| Modello | Cosa vede il fan | Tu imposti |
| --------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| Wins | Vincere un certo numero di partite classificate | Vittorie |
| Win rate | Giocare più di un certo numero di partite con una percentuale di vittorie superiore al tuo obiettivo | Partite minime, percentuale di vittorie obiettivo |
| Ranked duo wins | Vincere un certo numero di partite classificate in duo | Vittorie in duo |
| Reach a rank | Raggiungere una fascia e una divisione in questa stagione | Fascia, divisione |
| Improve rank | Salire fino a una fascia e a una divisione | Fascia, divisione |
| S minus grade | Ottenere il voto S meno un certo numero di volte sulla Landa | Volte |
**Reach a rank** si completa per un fan che ci è già arrivato. **Improve rank** gli chiede di arrivarci salendo. Nel selettore sembrano quasi identici e sono missioni molto diverse, quindi [leggi la riga dell'obiettivo nell'anteprima](/docs/quests/templates#before-you-publish).
**Ranked duo wins** chiede ai fan di trovare qualcuno con cui giocare.
## Prestazioni in corsia [#lane-performance]
| Modello | Cosa vede il fan | Tu imposti |
| -------------------------- | --------------------------------------------------------------------- | ----------------------------- |
| Turrets before plates fall | Distruggere un certo numero di torri prima della caduta delle placche | Torri |
| Early takedowns | Ottenere un certo numero di eliminazioni a inizio partita | Eliminazioni a inizio partita |
| Invade the enemy jungle | Uccidere un certo numero di mostri nella giungla nemica | Mostri |
| Turret takedowns | Distruggere un certo numero di torri | Torri |
| Ward takedowns | Distruggere un certo numero di lumi | Lumi |
Ward takedowns è la missione per chi gioca supporto e giungla. Turrets before plates fall è una missione di corsia che richiede vera abilità, e merita una vera ricompensa.
## Prestazioni nelle uccisioni [#kill-performance]
| Modello | Cosa vede il fan | Tu imposti |
| ------------------- | ----------------------------------------------------------------------------- | ---------------------- |
| Kills | Uccidere un certo numero di campioni nemici | Uccisioni |
| Assists | Ottenere un certo numero di assist | Assist |
| Solo kills | Ottenere un certo numero di uccisioni in solitaria | Uccisioni in solitaria |
| First blood | Ottenere il primo sangue un certo numero di volte | Primo sangue |
| Pentakill | Ottenere un certo numero di pentakill | Pentakill |
| Epic monster kills | Uccidere un certo numero di mostri epici entro 30 secondi dalla loro comparsa | Mostri epici |
| Steal epic monsters | Rubare un certo numero di mostri epici | Mostri epici |
Pentakill e Steal epic monsters sono i due modelli che dovrebbero portare le tue ricompense League più grandi. Nessuno dei due si ottiene a forza di macinare partite.
Assists è il modello da abbinare a loro, perché una bacheca in cui tutte le ricompense vanno alle missioni sulle uccisioni dice a metà della tua community che le missioni non fanno per lei.
## Cambiamenti del gioco [#game-changes]
Alcuni di questi modelli dipendono da meccaniche che Riot ha modificato negli anni, e Riot cambia il gioco a ogni stagione. Parti dai modelli che il selettore del pannello di amministrazione propone, non da un elenco scritto per una patch precedente.
## Comporre una bacheca League [#writing-a-league-board]
I reset di stagione sono il rischio maggiore. Vedi [Riot Games](/docs/quests/templates/gaming/riot-games#season-resets).
Tutti i modelli di conteggio di questa pagina sono [progressivi](/docs/quests/templates#the-four-shapes). Reach a rank è l'eccezione, e legge il rango che il fan ha già.
Dividi la bacheca per coda. Missioni ARAM per tutti, missioni classificate per i giocatori che le giocano comunque. Una bacheca tutta classificate esclude la maggior parte di una community; una bacheca tutta ARAM non ha nulla per i tuoi giocatori migliori.
# Riot Games (/it/docs/quests/templates/gaming/riot-games)
League of Legends, Teamfight Tactics e Valorant passano tutti da un unico collegamento Riot.
23 modelli. ARAM, classificate, fase di corsia, uccisioni, torri, lumi, mostri epici.
18 modelli. Uccisioni per zona colpita, obiettivi legati alla Spike, utilizzi di abilità, tempo di gioco.
4 modelli. Vittorie, percentuale di vittorie, raggiungere un rango, migliorare un rango.
## Il collegamento, e la regione [#linking-and-the-region]
Il fan collega il suo account Riot e poi sceglie una regione. Entrambi i passaggi sono obbligatori. Se un fan collega l'account senza scegliere un server, la missione gli chiede una regione prima di poter iniziare.
Il collegamento Riot è disattivato per impostazione predefinita. Vedi [Accesso](/docs/settings/sign-in).
L'accesso all'API di Riot viene approvato per singola community e non per la piattaforma nel suo insieme, e l'approvazione richiede tempo. Se le missioni Riot fanno parte del tuo piano di lancio, parlane con il tuo referente FanBase all'inizio dell'onboarding e non nella settimana prima di andare online.
## Reset di stagione [#season-resets]
Le statistiche dei giocatori vengono azzerate quando inizia una stagione classificata. Una missione pubblicata prima di un reset chiede progressi che stanno per essere cancellati, e un fan arrivato a metà perde la metà già fatta.
Ogni missione Riot che riguarda i progressi in classificata ha bisogno di una data di scadenza. Vedi [Prima di pubblicare](/docs/quests/templates#before-you-publish).
Le missioni di rango sono il caso più delicato, perché il rango di un fan viene riportato a un piazzamento e non a zero, ma ne risentono anche i totali di vittorie e le percentuali di vittorie.
## Limiti di frequenza [#rate-limits]
L'API di Riot ha limiti di frequenza, e la quota viene concessa per singola community e non condivisa su tutta la piattaforma. Per la maggior parte delle community il problema non si pone mai.
Si pone quando una community grande ha molte missioni Riot attive nello stesso momento, perché ogni missione attiva controlla la cronologia delle partite di ogni fan che l'ha avviata. Il sintomo sono progressi che si aggiornano lentamente.
Se lanci una bacheca ricca di missioni Riot a un pubblico ampio, pianificala prima con il tuo referente FanBase. Pubblica le missioni Riot a ondate invece di venti in una volta, e preferisci poche missioni con ricompense vere a un muro di missioni.
# Steam (/it/docs/quests/templates/gaming/steam)
Tre modelli usano direttamente il collegamento Steam, e lo usano anche tutti i modelli di Counter-Strike 2 e Dota 2.
| Modello | Il fan | Tu configuri |
| -------------------- | ----------------------------------------------------------- | ----------------------------------- |
| Play any Steam game | Gioca a qualsiasi gioco su Steam per un certo numero di ore | Ore giocate |
| Play a specific game | Gioca a un gioco preciso per un certo numero di ore | App ID, nome del gioco, ore giocate |
| Wishlist a game | Aggiunge il gioco alla sua lista dei desideri di Steam | App ID, nome del gioco |
Entrambi i modelli sul tempo di gioco sono [progressivi](/docs/quests/templates#the-four-shapes). È il motivo più frequente per cui un fan ti segnala che una missione Steam non funziona: ha giocato prima e ha avviato la missione dopo. Scrivilo nella descrizione.
Il profilo Steam del fan deve essere pubblico, e devono esserlo anche i dettagli di gioco. Un profilo privato si collega senza errori e poi non comunica nulla, quindi la missione resta a zero per sempre, senza spiegazioni sulla card. L'app mostra un avviso al riguardo. Ripetilo nella tua descrizione.
## Trovare l'App ID [#finding-the-app-id]
Apri la pagina del gioco nel negozio di Steam e leggi l'URL.
```
https://store.steampowered.com/app/730/CounterStrike_2/
```
`730` è l'App ID. Il nome del gioco che lo segue è quello da inserire anche nella missione, così i fan vedono un nome e non un numero. Quel nome è [testo visualizzato](/docs/quests/templates#verification); l'App ID è ciò che la verifica legge.
Se sbagli l'App ID, la missione tiene traccia di un altro gioco, senza errori e senza segnalare nulla. Un fan che gioca al gioco che intendevi tu non fa progressi. Controllalo sulla pagina del negozio prima di pubblicare.
## Lista dei desideri [#wishlisting]
Una missione a un solo tocco, non progressiva. Il fan apre la pagina del negozio, aggiunge il gioco, torna e completa la missione.
È il modello che sponsor e publisher chiedono per nome, perché le aggiunte alla lista dei desideri prima di un lancio sono il numero su cui viene valutato il loro team marketing. È anche il modello che più conviene abbinare a una scadenza, perché un'aggiunta fatta nella settimana dell'uscita vale più di una fatta sei mesi prima.
## Tempo di gioco [#playtime]
**Play any Steam game** conta tutto ciò che c'è nella libreria del fan. È la versione meno impegnativa, utile come missione settimanale per una community gaming in cui non ti interessa molto a cosa giocano le persone.
**Play a specific game** conta un solo App ID. È il modello per le sponsorizzazioni: un publisher vuole ore sul suo gioco, tu imposti l'App ID e le ore, e la ricompensa arriva da lui.
Imposta un numero di ore che un fan può raggiungere nella durata della missione. Dieci ore con una ricorrenza settimanale sono un impegno serio; due sono un sabato.
## Le librerie di gioco [#the-game-libraries]
Due giochi hanno i propri modelli di statistiche in aggiunta al collegamento Steam.
| Gioco | Modelli | Pagina |
| ---------------- | ------- | ----------------------------------------------------- |
| Counter-Strike 2 | 19 | [Counter-Strike 2](/docs/quests/templates/gaming/cs2) |
| Dota 2 | 11 | [Dota 2](/docs/quests/templates/gaming/dota-2) |
Le missioni di Counter-Strike possono passare anche da FACEIT invece che da Steam, il che cambia cosa è verificabile e cosa si può farmare. Vedi [FACEIT](/docs/quests/templates/gaming/faceit).
## Collegamento e ritardo delle statistiche [#linking-and-stat-lag]
Il collegamento Steam è disattivato per impostazione predefinita. Chiedi al tuo referente FanBase di attivarlo prima di pubblicare qualsiasi cosa di questa pagina. Vedi [Accesso](/docs/settings/sign-in).
Le statistiche di Steam arrivano in ritardo. Vengono lette da Steam e non seguite in tempo reale, quindi un fan che termina una sessione e apre subito la missione può vedere i suoi progressi un po' indietro. Poi si riallineano.
# Teamfight Tactics (/it/docs/quests/templates/gaming/teamfight-tactics)
Quattro modelli, e le uniche missioni di rango Riot al di fuori di League of Legends.
Tutti i modelli richiedono un account Riot collegato con una regione selezionata. Leggi prima [Riot Games](/docs/quests/templates/gaming/riot-games).
| Modello | Cosa vede il fan | Tu imposti |
| ------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| Wins | Vincere un certo numero di partite classificate | Vittorie |
| Win rate | Giocare almeno un certo numero di partite e mantenere una percentuale di vittorie superiore al tuo obiettivo | Partite minime, percentuale di vittorie obiettivo |
| Reach a rank | Raggiungere una fascia e una divisione in questa stagione | Fascia, divisione |
| Improve rank | Salire fino a una fascia e a una divisione | Fascia, divisione |
## Reach a rank a confronto con Improve rank [#reach-a-rank-against-improve-rank]
Nel selettore stanno uno accanto all'altro e sono missioni diverse.
**Reach a rank** è una verifica. Un fan già al tuo obiettivo o sopra la completa appena la avvia, quindi individua una fascia della tua community invece di far giocare qualcuno.
**Improve rank** chiede al fan di salire. Il fan la avvia dal punto in cui si trova e la completa quando arriva al tuo obiettivo, il che per un fan due fasce più in basso significa settimane di gioco.
[La riga dell'obiettivo nell'anteprima](/docs/quests/templates#before-you-publish) è ciò che distingue i due modelli una volta che la missione è in bozza.
## Vincere in Teamfight Tactics [#winning-in-teamfight-tactics]
Partecipano otto giocatori e i piazzamenti contano più di un risultato binario, quindi «vincere un certo numero di partite classificate» è una richiesta più pesante di quanto lo stesso numero sarebbe in un gioco cinque contro cinque. Imposta un obiettivo basso.
**Win rate** ha bisogno del suo minimo di partite, altrimenti basta una sola buona partita per completarlo.
I reset di stagione colpiscono questa pagina più di ogni altra, perché qui ogni modello riguarda il rango. Vedi [Riot Games](/docs/quests/templates/gaming/riot-games#season-resets).
# Valorant (/it/docs/quests/templates/gaming/valorant)
Quasi tutti i modelli sono contatori con un numero che imposti tu, quindi in questa pagina tutta la progettazione sta in quel numero.
Tutti i modelli richiedono un account Riot collegato con una regione selezionata. Leggi prima [Riot Games](/docs/quests/templates/gaming/riot-games) per il collegamento, i reset di stagione e i limiti di frequenza.
## Combattimento [#combat]
| Modello | Cosa vede il fan | Tu imposti |
| -------------- | ---------------------------------------------------------- | ------------------------------ |
| Total kills | Ottenere un numero totale di uccisioni | Uccisioni |
| Headshot kills | Ottenere un certo numero di uccisioni con colpo alla testa | Uccisioni con colpo alla testa |
| Bodyshot kills | Ottenere un certo numero di uccisioni con colpo al corpo | Uccisioni con colpo al corpo |
| Legshot kills | Ottenere un certo numero di uccisioni con colpo alle gambe | Uccisioni con colpo alle gambe |
| Total deaths | Un numero totale di morti | Morti |
| Assists | Ottenere un certo numero di assist | Assist |
| Damage dealt | Infliggere una certa quantità totale di danni | Danni |
Legshot kills è il modello leggero che i fan adorano e che nessuno può farmare di proposito.
## Obiettivi di Spike e di round [#spike-and-round-objectives]
| Modello | Cosa vede il fan | Tu imposti |
| ---------------- | ---------------------------------------------- | ----------- |
| Plant the spike | Piazzare la Spike un certo numero di volte | Piazzamenti |
| Defuse the spike | Disinnescare la Spike un certo numero di volte | Disinneschi |
| Team rounds won | Vincere un certo numero di round in totale | Round |
| Team wins | Vincere un certo numero di partite | Partite |
| Rounds played | Giocare un certo numero di round in totale | Round |
Piazzamenti e disinneschi sono i due modelli che premiano chi gioca l'obiettivo invece dello scontro.
## Abilità [#abilities]
| Modello | Cosa vede il fan | Tu imposti |
| ------------------- | ------------------------------------------------- | ---------- |
| Total ability casts | Un numero totale di utilizzi di abilità | Utilizzi |
| Ultimate casts | Usare l'ultimate un certo numero di volte | Ultimate |
| Grenade casts | Usare un'abilità granata un certo numero di volte | Utilizzi |
Le missioni sulle abilità non dipendono dall'agente, quindi un fan può completarle con quello che usa di più. Sono anche i numeri più facili da raggiungere di questa pagina, quindi tieni basse le ricompense e usale come riempitivo giornaliero.
## Attività [#activity]
| Modello | Cosa vede il fan | Tu imposti |
| -------------- | ----------------------------------------------- | ---------- |
| Matches played | Giocare un certo numero di partite | Partite |
| Playtime | Giocare per un certo numero di minuti in totale | Minuti |
| Total score | Raggiungere un punteggio totale | Punteggio |
Playtime si imposta in minuti, non in ore. Una missione settimanale è un numero a tre cifre, e inserire le ore per errore produce una missione che un fan completa in una partita.
Non esiste un modello di rango per Valorant. Se vuoi una missione di rango per un gioco Riot, usa [League of Legends](/docs/quests/templates/gaming/league-of-legends) o [Teamfight Tactics](/docs/quests/templates/gaming/teamfight-tactics).
## Comporre una bacheca Valorant [#writing-a-valorant-board]
Tutti i modelli di questa pagina sono progressivi, quindi [nulla conta prima dell'avvio](/docs/quests/templates#the-four-shapes).
È qui che i limiti di frequenza pesano di più. I modelli Valorant leggono la cronologia delle partite, e quando una community grande ne ha molti attivi insieme la quota per community di Riot si traduce in progressi lenti. Pubblica a ondate. Vedi [Riot Games](/docs/quests/templates/gaming/riot-games#rate-limits).
I contatori hanno bisogno di un ordine di grandezza. Calcola quanto dura una partita classificata per la tua community, poi stabilisci la ricompensa di conseguenza: venti uccisioni sono una serata e duecento sono due settimane.
# World of Warcraft (/it/docs/quests/templates/gaming/world-of-warcraft)
Solo Retail, su un collegamento Battle.net che richiede anche una regione. Cinque dei sedici modelli accettano un dungeon, un raid, un boss, un'espansione o un'impresa precisi, e sono le missioni più forti della pagina.
Questi modelli sono stati creati inizialmente per un solo partner, quindi chiedi al tuo referente FanBase di confermare che siano attivi nella tua community prima di pianificarci una campagna.
## PVP [#pvp]
| Modello | Cosa vede il fan | Tu imposti |
| --------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| Matches played | Giocare un certo numero di partite PVP | Partite |
| Matches won | Vincere un certo numero di partite PVP | Partite |
| Win rate | Giocare almeno un certo numero di partite PVP e mantenere una percentuale di vittorie superiore al tuo obiettivo | Partite minime, percentuale di vittorie obiettivo |
| Honorable kills | Ottenere un certo numero di uccisioni onorevoli | Uccisioni onorevoli |
| Honor level | Raggiungere un livello d'onore | Livello d'onore |
Honor level legge il livello che il fan ha già, quindi un fan sopra il tuo numero lo completa con un solo tocco.
## Dungeon e raid [#dungeons-and-raids]
| Modello | Cosa vede il fan | Tu imposti |
| ------------------------ | -------------------------------------------------------------------- | ---------------------- |
| Dungeon completion | Completare un dungeon preciso a una data difficoltà | Dungeon, difficoltà |
| Dungeon boss kills | Uccidere un certo numero di boss dei dungeon | Boss uccisi |
| Raid completion | Completare un raid preciso a una data difficoltà | Raid, difficoltà |
| Raid boss kills | Uccidere un certo numero di boss dei raid | Boss uccisi |
| Defeat a raid boss | Sconfiggere un boss preciso in un raid preciso a una data difficoltà | Boss, raid, difficoltà |
| Any raid in an expansion | Completare un raid qualsiasi di un'espansione | Espansione |
Dungeon e raid sono ciò attorno a cui si organizza una community di World of Warcraft, e quattro dei sei modelli qui accettano un nome.
La difficoltà fa parte della verifica. Normale, Eroica e Mitica sono missioni diverse con pubblici diversi, e una missione in Mitica è per una frazione della tua community. Indica la difficoltà nel titolo, non solo nella configurazione, altrimenti i fan daranno per scontata la più facile.
**Any raid in an expansion** è la versione ampia, ed è quella giusta per una campagna rivolta ai giocatori che tornano. Chiede di completare una volta un raid qualsiasi, cosa che la maggior parte di una community può fare.
## Progressione [#progression]
| Modello | Cosa vede il fan | Tu imposti |
| ---------------------- | ------------------------------------------- | --------------- |
| Character level | Raggiungere un livello | Livello |
| Renown level | Raggiungere un livello di Fama | Livello di Fama |
| Achievements | Completare un certo numero di imprese | Imprese |
| Achievement points | Accumulare un certo numero di punti impresa | Punti |
| A specific achievement | Completare un'impresa precisa | L'impresa |
**Character level** e **Renown level** sono i due da usare attorno a una nuova espansione o patch, perché sono le cose che ogni giocatore fa comunque nelle prime due settimane.
**A specific achievement** è l'equivalente in World of Warcraft della missione sul boss preciso, e vale lo stesso consiglio.
**Achievement points** è un totale che il fan ha già accumulato in anni di gioco, quindi la maggior parte della tua community lo completa nel momento in cui lo avvia, a meno che tu non imposti un numero alto. Consideralo un modo per trovare i giocatori di lunga data.
## Comporre una bacheca World of Warcraft [#writing-a-world-of-warcraft-board]
Tutti i modelli di conteggio di questa pagina sono [progressivi](/docs/quests/templates#the-four-shapes). I modelli di verifica, cioè livello, Fama, livello d'onore e punti impresa, leggono ciò che il fan ha già.
Dai un nome alle cose dove puoi. Un dungeon, un raid o un boss precisi dicono a un fan esattamente cosa andare a fare.
Il collegamento Battle.net è disattivato per impostazione predefinita e funziona come per i giochi Riot. Vedi [Accesso](/docs/settings/sign-in).
# Discord (/it/docs/quests/templates/social/discord)
Entrambi i modelli richiedono al fan di [collegare il suo account Discord](/docs/quests/templates#templates-that-need-a-linked-account). Entrambi hanno anche bisogno di identificativi presi dal tuo server.
| Modello | Superato quando il fan | Tu configuri |
| -------------------------------- | -------------------------- | -------------------------------------------------------------------------------------- |
| Join server (entrare nel server) | È membro del tuo server | Nome utente mostrato, ID della gilda, invito della gilda |
| Get a role (ottenere un ruolo) | Ha un ruolo nel tuo server | Nome utente mostrato, ID della gilda, invito della gilda, ID del ruolo, nome del ruolo |
## Trovare gli ID [#finding-the-ids]
Discord nasconde entrambi gli ID dietro un'impostazione per sviluppatori. Attivala una volta e resta attiva.
### Attivare la modalità sviluppatore [#turn-on-developer-mode]
In Discord, apri **User Settings** (impostazioni utente), poi **Advanced** (avanzate), e attiva **Developer Mode** (modalità sviluppatore). Nel tuo account non cambia nulla, tranne che nei menu del clic destro compaiono le opzioni di copia.
### Copiare l'ID del server [#copy-the-server-id]
Fai clic destro sull'icona del tuo server nella barra laterale sinistra e scegli **Copy Server ID** (copia ID server). Quello è l'ID della gilda.
### Copiare l'ID del ruolo [#copy-the-role-id]
Apri **Server Settings** (impostazioni server), poi **Roles**. Fai clic destro sul ruolo che ti interessa. Scegli **Copy Role ID** (copia ID ruolo). Serve solo al modello Get a role.
### Ottenere l'invito [#get-the-invite]
Fai clic destro sull'icona del server e scegli **Invite People** (invita persone), poi copia il link. Usa un invito che non scade e senza limite di utilizzi, altrimenti la missione smetterà di funzionare.
## I campi [#the-fields]
| Campo | Che cos'è | Cosa può andare storto |
| -------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| Nome utente mostrato | Il nome del server che i fan vedono sulla card | [Testo visualizzato](/docs/quests/templates#verification), quindi un errore qui è solo estetico e non te ne accorgerai |
| ID della gilda | Il server su cui viene verificata l'appartenenza | Un ID sbagliato fa fallire la verifica per ogni fan, compresi quelli già nel server |
| Invito della gilda | Dove il pulsante manda il fan | Un invito scaduto o monouso manda i fan su una pagina morta |
| ID del ruolo | Il ruolo che la verifica legge | Un ID sbagliato fa fallire la verifica per tutti, come un ID della gilda sbagliato |
| Nome del ruolo | Il nome del ruolo che i fan vedono sulla card | Rinominare il ruolo in Discord non aggiorna la missione. Modifica anche la missione |
## Comportamento delle missioni di ruolo [#role-quest-behaviour]
Il fan collega Discord, entra nel server se non ne fa già parte, e la missione si completa quando ha il ruolo. Nella missione nulla assegna il ruolo. Ciò che dà il ruolo ai fan, un bot o un moderatore, deve già esistere nel tuo server, e la missione si limita a leggere il risultato.
Le missioni di ruolo funzionano meglio come ricompensa per qualcosa che su Discord succede già. Un fan che arriva a una missione di ruolo senza alcun modo di ottenere il ruolo finisce in un vicolo cieco, senza spiegazioni sulla card.
Dare a un fan un ruolo Discord **come ricompensa** per aver completato una missione è la direzione opposta, ed è un'altra funzionalità. È descritta in [Ricompense](/docs/rewards) e richiede che l'integrazione Discord sia collegata. Per annunciare missioni ed eventi nel tuo server vedi [Discord](/docs/integrations/discord).
## Collegamento, e cosa succede quando un fan se ne va [#linking-and-what-happens-when-a-fan-leaves]
Un fan che lascia il server conserva la ricompensa, perché una volta completata la missione non viene riverificato nulla. Vedi [Verifica](/docs/quests/templates#verification).
Il collegamento Discord è attivo per impostazione predefinita. Vedi [Accesso](/docs/settings/sign-in).
# Facebook, Instagram, TikTok (/it/docs/quests/templates/social/meta)
Nessuno dei quattro verifica un follow, un mi piace o una visualizzazione. Tutti e quattro registrano il tocco che ha aperto il link.
| Modello | Il fan | Tu configuri |
| ------------------------------------------------------- | ------------------------------------------------ | -------------------------------------------------------- |
| Visit a Facebook page (visitare una pagina Facebook) | Apre la tua pagina, torna, completa la missione | L'URL della pagina, e il nome utente mostrato sulla card |
| Visit an Instagram page (visitare una pagina Instagram) | Apre il tuo profilo, torna, completa la missione | L'URL del profilo, e il nome utente mostrato sulla card |
| View an Instagram post (vedere un post Instagram) | Apre un post, torna, completa la missione | L'URL del post, e il nome utente mostrato sulla card |
| View a TikTok post (vedere un post TikTok) | Apre il tuo post, torna, completa la missione | L'URL del post, e il nome utente mostrato sulla card |
## La verifica [#the-check]
Il fan non ha alcun account Facebook, Instagram o TikTok da collegare, quindi la piattaforma non ha modo di chiedere a nessuno di questi servizi se un determinato fan ti segue, ha guardato il video o ha mai caricato la pagina. Una card della missione che dice «Seguici su Instagram» e assegna la ricompensa sta pagando il tocco che ha aperto Instagram. Tutti e quattro sono modelli [Visit link](/docs/quests/templates/action#visit-link) con una card che riprende l'aspetto del social in questione.
Tieni bassa la ricompensa. Sono le missioni più facili da completare della tua bacheca e dovrebbero essere tra quelle che rendono meno. Un fan che capisce che il pulsante paga anche senza il follow lo dirà agli altri fan.
Scrivi la descrizione come un'istruzione. La missione non può chiedere il follow, quindi deve farlo il testo. I partner ottengono comunque che una buona parte dei fan lo faccia, come succede con [YouTube](/docs/quests/templates/social/youtube), purché la descrizione dica chiaramente cosa si vuole.
Il modello TikTok ha un compito che gli altri tre non hanno: portare un picco di traffico su un post nelle ore successive alla pubblicazione. Stabilisci la ricompensa come per una missione di traffico.
## Verifica su Instagram [#instagram-verification]
Pianificato
Verificare che un fan abbia messo mi piace a un post o seguito un account su Instagram è il modello che i partner chiedono più spesso tra quelli non ancora realizzati. Richiederebbe il collegamento dell'account Instagram, cioè un fan che collega il suo Instagram alla tua app invece di toccare soltanto un link.
Finché non arriva, considera tutto ciò che c'è in questa pagina come un modello di traffico. Chiedi al tuo referente FanBase a che punto è prima di costruire una campagna che ne dipende, e vedi [chiedere un modello o un gioco](/docs/quests/templates#asking-for-a-template-or-a-game).
## Collegamento dell'account TikTok [#tiktok-account-linking]
Le verifiche di follow e mi piace richiederebbero il collegamento dell'account TikTok, come avviene su [X](/docs/quests/templates/social/x). Non è in fase di sviluppo. La verifica su Instagram viene prima nella coda, e TikTok seguirebbe lo stesso percorso se i partner lo chiedessero.
## Inserire gli URL giusti [#getting-the-urls-right]
Il link è tutta la configurazione, quindi incollalo dalla barra degli indirizzi e non da un menu di condivisione. I link di condivisione di Instagram contengono parametri di tracciamento che a volte rimandano un fan non connesso a una schermata di accesso. I link TikTok condivisi passano da un abbreviatore di URL e a volte finiscono su un invito a installare l'app invece che sul post. In entrambi i casi il fan non può completare la missione e non sa perché.
Il nome utente che inserisci è [testo visualizzato](/docs/quests/templates#verification).
# Spotify (/it/docs/quests/templates/social/spotify)
Pensata per i partner musicali, è l'unica famiglia della piattaforma che legge ciò che un fan ascolta.
Tutti e tre richiedono al fan di [collegare il suo account Spotify](/docs/quests/templates#templates-that-need-a-linked-account).
| Modello | Superato quando il fan | Tu configuri |
| ---------------------------------------- | --------------------------------------------- | ------------------------------------------------------------- |
| Follow an artist (seguire un artista) | Segue l'artista | Il link Spotify, e il nome dell'artista mostrato sulla card |
| Follow a playlist (seguire una playlist) | Segue la playlist | Il link Spotify, e il nome della playlist mostrato sulla card |
| Top artist (artista più ascoltato) | Ha l'artista tra i suoi artisti più ascoltati | Il nome dell'artista |
## I due modelli per seguire [#the-two-follow-templates]
Il fan apre Spotify dalla missione, segue, torna, e la verifica avviene sul suo account collegato. Il link che incolli è il punto in cui il pulsante lo manda. Copialo dal menu di condivisione di Spotify o dalla barra degli indirizzi del web player.
Il nome dell'artista o della playlist che inserisci è [testo visualizzato](/docs/quests/templates#verification).
Seguire una playlist è di solito la richiesta migliore delle due. Seguire un artista è un impegno maggiore per un fan che non lo ascolta già. Una playlist che controlli tu cambia di continuo, e questo ti dà un motivo per riproporre la missione il mese dopo.
## Artista più ascoltato [#top-artist]
È il modello che legge la cronologia di ascolto. Verifica se l'artista che indichi compare tra gli artisti più ascoltati del fan su Spotify, una lista che Spotify ricava da ciò che il fan ascolta.
Un fan completa questa missione con mesi di ascolto.
Individua chi ti ascolta già. Usalo per trovare e premiare i fan che ti ascoltavano già. Una missione sull'artista più ascoltato con una ricompensa grande e un pubblico idoneo ristretto è una missione che la maggior parte della tua community guarderà una volta e mai più.
Chiarisci le aspettative nella descrizione. Un fan che non la supera merita di sapere perché, e la card non può dirglielo. Basta una riga che dica che questa missione è per chi ti ascolta già a ripetizione.
## Collegamento, e verifica unica [#linking-and-the-one-time-check]
Il collegamento Spotify è disattivato per impostazione predefinita. Chiedi al tuo referente FanBase di attivarlo prima di pubblicare uno di questi modelli. Vedi [Accesso](/docs/settings/sign-in).
Un follow non viene riverificato una volta completata la missione. Vedi [Verifica](/docs/quests/templates#verification).
# Twitch (/it/docs/quests/templates/social/twitch)
Tutti e tre richiedono al fan di [collegare il suo account Twitch](/docs/quests/templates#templates-that-need-a-linked-account).
| Modello | Il fan | Tu configuri |
| ---------------------------------- | ------------------------------------------------ | --------------------------------------------------------------- |
| Follow (seguire) | Segue il tuo canale | Il nome utente del canale, e il nome utente mostrato sulla card |
| Subscribe (abbonarsi) | Si abbona al tuo canale | Le stesse impostazioni |
| Watch stream (guardare la diretta) | Guarda le tue dirette per un certo numero di ore | Le ore, più una configurazione. Vedi sotto |
## Seguire e abbonarsi [#follow-and-subscribe]
La card manda il fan su `twitch.tv` con il tuo nome utente, il fan fa quanto richiesto, e al suo ritorno la verifica avviene sul suo account collegato.
Il nome utente che inserisci è il canale che viene verificato, quindi deve essere il nome di accesso presente nell'URL e non il nome visualizzato sulla pagina del canale. Di solito coincidono, ma non sempre.
Abbonarsi costa denaro al fan. È l'unico modello social della piattaforma che lo fa, e una ricompensa stabilita come per un follow chiede al fan di spendere soldi per molto poco. I partner che gestiscono con successo le missioni di abbonamento le trattano come un ringraziamento ai fan che si sarebbero abbonati comunque.
Nessuno dei due viene riverificato una volta completata la missione. Vedi [Verifica](/docs/quests/templates#verification).
## Guardare la diretta [#watch-stream]
Progressivo. Il fan avvia la missione, guarda, e il contatore si riempie con le ore guardate fino a raggiungere il tuo obiettivo.
Il tempo di visione richiede una configurazione su misura per il tuo canale prima di poter essere pubblicato. Chiedi al tuo referente FanBase cosa comporta per la tua community prima di pianificarci attorno una campagna.
La missione deve essere pubblicata prima che inizi la diretta, perché [nulla conta prima che il fan prema per avviare](/docs/quests/templates#the-four-shapes).
## Collegamento, e collegamenti scaduti a missione in corso [#linking-and-expired-links-mid-quest]
Il collegamento Twitch è attivo per impostazione predefinita. Vedi [Accesso](/docs/settings/sign-in).
Una missione sul tempo di visione che un fan ha avviato prima che [il suo collegamento scadesse](/docs/quests/templates#templates-that-need-a-linked-account) riprende il conteggio quando il fan ricollega l'account.
Altri modelli Twitch sono una delle tre richieste aperte nella [coda dei modelli](/docs/quests/templates#asking-for-a-template-or-a-game).
# X (/it/docs/quests/templates/social/x)
Ogni modello di questa pagina richiede prima al fan di [collegare il suo account X](/docs/quests/templates#templates-that-need-a-linked-account).
## Interagire con un post o un account [#engaging-with-a-post-or-an-account]
| Modello | Il fan | Tu configuri |
| ----------------------- | --------------------------- | -------------------------------------- |
| Follow (seguire) | Segue un account | Il link dell'account, o il nome utente |
| Like (mettere mi piace) | Mette mi piace a un post | Il link al post |
| Repost (ripubblicare) | Ripubblica un post | Il link al post |
| Quote (citare) | Cita un post con parole sue | Il link al post |
Il fan apre X dalla missione, fa quanto richiesto, torna e completa la missione. La verifica avviene in quel momento sul suo account collegato.
Indica il link del post esatto, non quello del tuo profilo. Una missione che dice «metti mi piace al nostro ultimo post» e rimanda a una timeline verrà completata da fan che hanno messo mi piace al post sbagliato. Smette di funzionare per tutti quando il post non è più l'ultimo.
## Pubblicare [#posting]
Due modelli chiedono al fan di pubblicare un post suo e poi verificano che contenga un elemento preciso.
| Modello | Superato quando il post contiene | Tu configuri |
| ----------------------------------------- | -------------------------------- | ------------------------------------------ |
| Post with a hashtag (post con un hashtag) | Il tuo hashtag | Un modello di post, e l'hashtag |
| Post with a link (post con un link) | Il tuo link | Un modello di post, e il prefisso del link |
Il **modello di post** è il testo che l'app precompila per il fan quando apre la schermata di scrittura. Il fan può modificarlo, e il testo può includere il suo nome utente, così il post sembra davvero suo.
L'**hashtag** e il **prefisso del link** sono ciò che la verifica legge. Un fan che cancella il tuo hashtag mentre modifica il testo non completa la missione, mentre un fan che ci aggiunge attorno un paragrafo suo la completa. Tieni breve il testo precompilato: più è lungo, più i fan ne cancellano, e più è probabile che sparisca anche la parte verificata.
## Verificare il profilo del fan [#checking-a-fans-own-profile]
Tre modelli leggono ciò che il fan ha messo sul proprio profilo. Usali per una campagna in cui i fan mostrano di far parte di qualcosa: un tag nel nome visualizzato per un torneo, un link nella bio per un lancio.
| Modello | Legge | Tu configuri |
| --------------------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------- |
| Display name check (verifica del nome visualizzato) | Il nome visualizzato del fan | Il testo da cercare, la distinzione tra maiuscole e minuscole, la corrispondenza esatta |
| Bio check (verifica della bio) | La bio del fan | Le stesse impostazioni |
| Username check (verifica del nome utente) | Il nome utente del fan | Le stesse impostazioni |
Con **Case sensitive** (distinzione tra maiuscole e minuscole) attivo, maiuscole e minuscole devono corrispondere alle tue. Con **Exact match** (corrispondenza esatta) attivo, l'intero campo deve essere identico al tuo testo, cosa che per una bio non è quasi mai ciò che vuoi. Lasciali entrambi disattivati, a meno che tu non stia verificando un codice.
La verifica del nome utente è la più severa delle tre, perché cambiare nome utente è una decisione importante per un fan. Stabilisci la ricompensa di conseguenza.
## Account privati e verifica unica [#private-accounts-and-the-one-time-check]
Un account privato non può essere verificato. Un fan con i post protetti collega l'account senza problemi e poi non supera le verifiche sui post, e l'unica spiegazione, per lui e per te, è la missione che non si completa. Aggiungi una riga nella descrizione.
Una volta completata la missione non viene riverificato nulla, cosa che conta soprattutto per il follow e per le verifiche del profilo. Vedi [Verifica](/docs/quests/templates#verification).
# YouTube (/it/docs/quests/templates/social/youtube)
Nessuno dei due modelli disponibili chiede al fan di collegare un account YouTube, quindi entrambi registrano il clic. I modelli iscriversi e mettere mi piace sono stati ritirati e non torneranno.
| Modello | Stato | Il fan | Tu configuri |
| ---------------------------------- | ---------------------------- | ----------------------------------------------- | ------------------------------------------------------- |
| Visit channel (visitare il canale) | Disponibile | Apre il tuo canale, torna, completa la missione | L'URL della pagina e il nome utente mostrato sulla card |
| Watch video (guardare il video) | Disponibile | Apre il tuo video, torna, completa la missione | L'URL della pagina e il nome utente mostrato sulla card |
| Subscribe (iscriversi) | Ritirato | | |
| Like (mettere mi piace) | Ritirato | | |
## Visitare il canale e guardare il video [#visit-channel-and-watch-video]
Entrambi funzionano come qualsiasi altro modello di visita. Il fan tocca il pulsante, il link si apre in una nuova scheda del browser, e il pulsante per completare si attiva al suo ritorno.
I partner usano questi modelli per portare un picco di traffico su un video nelle sue prime ore, la finestra che conta di più per il posizionamento su YouTube.
## I modelli ritirati [#the-withdrawn-templates]
Le autorizzazioni che YouTube richiede per verificare che un fan preciso si sia iscritto a un canale, o abbia messo mi piace a un video, sono così ampie che nessuna ricompensa di una bacheca delle missioni le giustifica.
I modelli restano nel catalogo e non possono essere pubblicati.
## La soluzione alternativa [#the-workaround]
Usa una missione **visitare il canale** o **guardare il video** e chiedi il mi piace nella descrizione.
I partner che seguono questo schema hanno riscontrato che una quota significativa dei fan fa ciò che la descrizione chiede, anche se nulla lo verifica. Scrivi la descrizione come un'istruzione e sii preciso: «Guarda il video e lascia un mi piace» funziona meglio di «Scopri il nostro nuovo video».