Shopify
Início de sessão pela loja, regras de recompensa nas compras, encomendas geradas por compras na aplicação e a FanBase na sua montra.
Ligar a Shopify faz três coisas independentes: os fãs iniciam sessão com a conta da loja, as compras na sua loja rendem XP, moeda ou objetos colecionáveis na aplicação, e os artigos comprados com pontos na aplicação tornam-se encomendas reais na sua loja.
Início de sessão
O fã toca em Iniciar sessão com a Shopify. Vai para a sua loja por um URL de proxy de aplicação, parecido com https://yourstore.com/apps/proxy-redirect. Autentica-se com a conta que já tem, ou cria uma, e volta com a sessão iniciada.
Funciona com as contas padrão da Shopify e com o Shop, o início de sessão próprio da Shopify. Nos dois casos o fã chega como uma única identidade: as compras e os pontos são da mesma pessoa.
Um ponto a saber antes de dar instruções ao seu suporte. Quando um fã cria uma conta nova da Shopify durante este fluxo, a Shopify não o devolve à sua aplicação depois. Ele vai parar de novo à sua loja, inicia sessão mais uma vez, e tudo funciona daí em diante. Os fãs que já têm conta nunca veem isto.
Que conta o cliente recebe
Da primeira vez que um cliente inicia sessão desta forma, é associado a um fã pelo e-mail. Um cliente cujo e-mail já pertence a um fã recebe a conta desse fã, com os pontos e o histórico. Qualquer outra pessoa recebe uma conta nova, com esse e-mail.
Se a Shopify aparece ao lado de Google, Discord, X e Twitch ou substitui todos eles é uma configuração por comunidade. Alguns parceiros usam a Shopify como única forma de entrada, de modo que a conta de fã e a conta de cliente são a mesma coisa por construção.
Instalação
A instalação é uma aplicação personalizada da Shopify para a sua loja, o que significa algumas mensagens trocadas, e não uma listagem que se procura num catálogo.
Envie-nos o seu domínio .myshopify.com
O original, que termina em .myshopify.com.
Pode encontrá-lo no admin da Shopify, em Settings, depois Domains. O endereço .myshopify.com aparece aí mesmo quando o principal é um domínio personalizado.
O seu domínio personalizado não vai funcionar. A instalação fica associada ao domínio original da Shopify, e errar no domínio custa uma semana em vez de uma tarde.
Nós colocamo-lo na lista de permissões e enviamos um link de instalação
O link é exclusivo da sua loja e expira ao fim de cerca de uma semana. Se expirar, peça outro.
Inicie sessão no painel de administração antes de clicar nele
Abra admin.gamerbase.gg/admin e inicie sessão primeiro, no mesmo navegador. A instalação termina com o regresso ao painel de administração, e isso não é possível se ainda não tiver a sessão iniciada aí.
Aprove as permissões na Shopify
O link leva ao ecrã de autorização da Shopify. Leia o que a aplicação está a pedir e depois instale.
Volte ao painel de administração
É feito o redirecionamento de volta e a instalação termina sozinha. Nada mais para preencher.
Verifique
No painel de administração, vá a Settings, depois Automations. A Shopify deve aparecer como ligada. Se não aparecer, a instalação não terminou, e a causa mais comum é a etapa três.
Sandbox e produção são aplicações separadas, e não se misturam. Uma aplicação de sandbox liga-se apenas a uma loja de desenvolvimento da Shopify, e a aplicação de produção liga-se apenas à sua loja real. Crie uma loja de desenvolvimento para os testes em vez de apontar a sandbox para a loja verdadeira. É gratuita e já vem em modo de teste.
Regras de recompensa
Uma regra de recompensa observa a sua loja e paga quando uma encomenda lhe corresponde. Crie as regras na secção Shopify do painel de administração. Todas as regras têm um nome, uma descrição e uma recorrência.
| Campo | O que faz |
|---|---|
| Nome | Como designa a regra internamente. |
| Descrição | Para que serve a regra, para quem a herdar. |
| Recorrência | One time (uma vez) paga a um mesmo fã uma única vez, para sempre. Recurring (recorrente) paga sempre que uma encomenda corresponde. |
| Recompensa | O que o fã recebe. Veja abaixo a nota sobre os tipos de recompensa. |
Há três tipos de regra.
Compra com etiqueta
Recompensa uma encomenda que contém produtos com uma etiqueta à sua escolha. Pode escolher as etiquetas e definir se a encomenda tem de ter pelo menos uma delas, com any, ou todas, com all.
É assim que se recompensa uma categoria sem listar produtos. Coloque uma etiqueta nas camisolas, escreva uma regra, e todas as camisolas que adicionar depois já ficam cobertas.
Qualquer compra
Recompensa todas as encomendas, independentemente do que foi comprado. O mais simples dos três, e o certo para «qualquer compra connosco rende pontos».
Valor gasto
A recompensa é proporcional ao total da encomenda. Define-se uma taxa por unidade da moeda da sua loja, e o pagamento é a taxa multiplicada pelo total da encomenda, arredondado para baixo. Hoje não há teto para uma única encomenda, por isso escolha a taxa a pensar numa encomenda grande.
Tipos de recompensa
XP, a sua moeda gastável e objetos colecionáveis. Um prémio ou uma loot box por uma compra é, por enquanto, uma recompensa manual. Recompensas explica a diferença entre os tipos.
Quando uma compra não rende nada
Um fã diz que comprou algo e não recebeu nada. São verificados sete pontos em cada encomenda, por ordem, e o primeiro que falha é a resposta.
- OK
- OK
- Para aqui
- Não alcançada
- Não alcançada
- Não alcançada
- Não alcançada
Dois deles explicam quase todos os casos. Ou a regra foi criada depois da encomenda, e as encomendas anteriores a uma regra nunca são pagas. Ou o fã finalizou a compra com um e-mail diferente do que está na conta de fã, e o e-mail é a única coisa que liga os dois.
Um reembolso ou uma encomenda cancelada não retira a recompensa.
Se o seu próprio site é construído com o SDK, mostrar ao fã os pontos que uma compra rendeu é a única parte que os seus programadores escrevem. Recompensas de compra na documentação do SDK explica como, com as mesmas sete verificações vistas do lado deles.
Dois pontos a planear
As encomendas criadas por trocas de pontos na aplicação são ignoradas. Quando um fã compra um artigo da loja com pontos e a plataforma faz a encomenda na sua loja da Shopify, nenhuma regra é acionada. Sem isto, um fã poderia gastar pontos para comprar algo, ganhar pontos pela compra e repetir o ciclo.
Não há notificação na aplicação quando uma compra rende uma recompensa. O saldo do fã sobe e nada na aplicação diz de onde veio. Os parceiros resolvem isto ao mencionar a recompensa no e-mail de confirmação de encomenda da Shopify que já enviam. Uma notificação na aplicação está na nossa lista.
Na sua montra
Em desenvolvimentoAs funcionalidades da FanBase estarão disponíveis como blocos que pode adicionar ao seu tema da Shopify no editor de temas, sem código: missões, o perfil e o avatar do fã, e um pequeno indicador de conta para o seu cabeçalho. Um cliente que iniciou sessão na sua loja ficará com a sessão iniciada automaticamente na sua comunidade, nas suas próprias páginas, sem um segundo início de sessão.
A primeira versão cobre as missões, o perfil, o avatar e o indicador. Os blocos para a classificação, a loja, o battlepass, os eventos e o feed de notícias vêm depois.
Chega em conjunto uma alteração ao início de sessão. A associação de um cliente a um fã existente pelo e-mail só será válida nas lojas que usam as new customer accounts (novas contas de cliente) da Shopify, em que o cliente comprova o endereço com um código. Nas classic customer accounts (contas de cliente clássicas), em que o cliente escolhe uma palavra-passe e nada comprova o endereço, cada cliente receberá uma conta de fã própria. Se usa as contas clássicas e quer que os clientes da loja e os fãs existentes coincidam, vale a pena migrar para as novas contas de cliente nas definições da Shopify, em Settings e depois Customer accounts, antes de os blocos chegarem à sua loja.
A disponibilização acontece loja a loja, a começar pelas comunidades piloto. A instalação é feita por um link, como a ligação acima, e não pede nenhuma permissão na sua loja. A configuração, as definições de cada bloco e a forma de os estilizar de acordo com o seu tema estão em Blocos para a montra. Pergunte ao seu contacto na FanBase em que ponto da disponibilização está a sua loja.
Gastar pontos de volta na Shopify
Um fã compra um artigo da loja com pontos dentro da aplicação, e aparece uma encomenda real na sua Shopify, no registo de cliente dele, pronta para ser processada como qualquer outra encomenda. Disponível desde 7 de outubro de 2026.
O fã nunca paga em dinheiro. A encomenda chega à Shopify já marcada como paga, porque ele pagou com pontos.
Como ativar para um artigo
Autorize a sua loja para encomendas
Criar encomendas exige uma permissão que a instalação original não pediu. O painel de administração mostra um aviso na secção Shopify quando a sua loja precisa de ser autorizada de novo. É uma única aprovação na Shopify, feita uma vez.
Ative Fulfil via Shopify
No artigo da loja, ative Fulfil via Shopify (processar pela Shopify). O interruptor fica desativado até que uma loja esteja ligada, e indica-o.
Escolha o produto e a variante
Escolha o produto no seu catálogo da Shopify e depois a variante. O painel preenche o título do produto e o SKU para poder confirmar que escolheu o certo.
Guarde
Ativar o processamento pela Shopify adiciona um e-mail e uma morada de entrega ao que o artigo pede ao fã na finalização da compra. Não precisa de adicionar esses campos.
O que o fã faz
O fã compra o artigo com pontos, como qualquer outro. Antes de a compra ser concluída, indica um e-mail e uma morada de entrega, com um nome para a encomenda. Se já tiver indicado esses dados antes, vêm preenchidos.
O que chega à Shopify
| Na encomenda | Valor |
|---|---|
| Cliente | O fã, encontrado ou criado pelo e-mail |
| Morada de entrega | A morada que ele indicou |
| Estado do pagamento | Pago |
| Etiqueta | fanbase-redemption |
A etiqueta é a forma de distinguir estas encomendas no admin da Shopify, e de a FanBase saber que não lhes deve aplicar regras de recompensa.
Como acompanhar uma encomenda
Cada compra no separador de distribuição da loja mostra a encomenda da Shopify correspondente e em que ponto está. Se a criação de uma encomenda falhar, por exemplo porque a Shopify estava indisponível, a FanBase tenta de novo sozinha, e pode tentar novamente a partir do mesmo separador. Um fã que pagou com pontos não perde o artigo por causa de uma tentativa falhada.
Três limites a ter em conta
- Um artigo da loja é uma variante. Um tamanho M e um L são dois artigos da loja, cada um associado à sua própria variante. As variantes num único artigo estão em desenvolvimento.
- Apenas compras na loja. Um prémio físico ganho numa missão, num evento ou numa loot box não é enviado para a Shopify. Esses são processados à mão, como antes. Veja Recompensas personalizadas.
- O artigo da loja tem stock próprio. A quantidade que define no artigo da loja é o que limita as vendas na aplicação. Defina-a de acordo com o que consegue realmente enviar.
Combine isto com um limite de compra em tudo o que for escasso, para que um fã com um saldo grande não leve tudo.
Distribuição de códigos
Em desenvolvimentoCódigos de desconto e de oferta entregues como recompensa. Veja Recompensas personalizadas.