Shopify
Accesso tramite il negozio, regole di ricompensa sugli acquisti, ordini generati dagli acquisti nell'app e FanBase sulla tua vetrina.
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
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
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
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
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
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
Apri 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
Il link ti porta alla schermata di autorizzazione di Shopify. Leggi cosa chiede l'app, poi installala.
Torna nel pannello di amministrazione
Vieni reindirizzato e l'installazione si completa da sola. Non c'è altro da compilare.
Verifica
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
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
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
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
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
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 spiega la differenza tra i tipi.
Quando un acquisto non fa guadagnare nulla
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.
- OK
- OK
- Si ferma qui
- Non raggiunto
- Non raggiunto
- Non raggiunto
- Non raggiunto
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
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
In sviluppoLe 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
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
Autorizza il tuo negozio Shopify per gli ordini
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
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
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
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
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
| 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
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
- 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 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.
- 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 su tutto ciò che è scarso, così un solo fan con un saldo alto non può prendersi tutto.
Distribuzione di codici
In sviluppoCodici sconto e codici regalo distribuiti come ricompensa. Vedi Distribuzione di codici.