# Estatísticas (/pt/docs/analytics)
Todas as comunidades têm um dashboard, sem configuração e sem nada para ligar.
## Secções do dashboard [#dashboard-sections]
| Secção | A pergunta a que responde |
| ------------------------------ | ------------------------------------------------------------------------------------------ |
| Crescimento de membros | Quantos fãs tem, a que velocidade esse número muda e que parte deles está ativa |
| Envolvimento | Missões concluídas e objetos distribuídos no período |
| Padrões de atividade | Quando é que a sua comunidade está de facto na aplicação, por hora e por dia |
| Médias por fã | Missões concluídas e objetos detidos por fã, além da retenção e da parte de fãs ativos |
| Desempenho das funcionalidades | Que missões convertem e que modelos os fãs concluem, para poder criar mais do que funciona |
O **seletor de período** aplica-se a todo o dashboard. Compare a mesma janela semana a semana em vez de ler um número isolado, porque um único dia reflete um único jogo.
Verifique que modelos os seus fãs realmente concluem antes de planear as próximas vinte missões.
## Exportações e a Data API [#exports-and-the-data-api]
| Necessidade | Use |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| As conclusões de uma missão e os fãs por trás delas | A exportação por missão em [Gerir missões](/docs/quests/managing#per-quest-analytics) |
| Um retrato de cada fã e dos totais dele | A [exportação de membros](/docs/members#exporting-the-member-list) |
| Os mesmos dados de forma programada, nos seus próprios sistemas | A [Data API](/docs/integrations/data-api) |
## Estatísticas web [#web-analytics]
O Google Analytics e o Google Tag Manager podem ser adicionados à sua aplicação. Veja [Integrações de estatísticas](/docs/analytics).
# Battlepass (/pt/docs/battlepass)
Uma escada de recompensas que se desbloqueia à medida que o fã ganha XP, com um lado gratuito que todos sobem e um lado pago que só os membros podem reivindicar.
As missões recompensam cada ação. O battlepass recompensa o total, por isso vale a pena fazer a trigésima missão mesmo quando a recompensa dela é pequena.
## Temporadas [#seasons]
Uma temporada é um elemento de pleno direito no painel de administração. Crie uma, preencha-a com patamares e coloque-a online.
| Ação | O que faz |
| -------- | ------------------------------------------------------------------------------------------------------ |
| Rascunho | Preparar uma temporada sem que os fãs a vejam |
| Duplicar | Copiar a estrutura da temporada anterior e trocar as recompensas, em vez de refazer quarenta patamares |
| Editar | Alterar uma temporada, incluindo uma que já está online |
| Encerrar | Terminar uma temporada e arquivá-la |
As datas são opcionais. Uma temporada sem datas dura até ser encerrada, o que se adequa a uma escada de progressão permanente. Uma temporada com início e fim dura duas semanas em torno de um torneio, mostra uma contagem decrescente aos fãs e encerra-se sozinha.
Os fãs alternam entre temporadas na aplicação, por isso uma temporada encerrada continua visível em vez de ser eliminada.
Migrar um battlepass criado da forma antiga, como um conjunto de missões de verificação de nível feitas à mão, significa eliminá-lo e voltar a criá-lo como uma temporada. Não existe uma atualização que aproveite o que já está feito. Faça-o entre temporadas, nunca a meio de uma, porque refazê-lo a meio da temporada retira o progresso e as reivindicações aos fãs que já tinham subido parte da escada. Os battlepasses criados da forma antiga continuam a aparecer exatamente como antes, por isso não há prazo nem pressão para migrar antes de uma pausa natural.
Se a sua comunidade ainda tiver um battlepass criado da forma antiga, a secção Battlepass mostra um separador **Legacy** (formato antigo) ao lado das suas temporadas. As recompensas dele ficam aí listadas e ainda podem ser editadas. O separador desaparece sozinho quando já não resta nada nele, e uma comunidade que começou com temporadas nunca o vê.
## Patamares [#tiers]
Um patamar é um degrau: um nível e a recompensa que nele espera.
Os patamares desbloqueiam-se com XP, com base no mesmo total que define os [níveis](/docs/levels) e a [classificação](/docs/leaderboards). Não há uma segunda moeda para acompanhar nem uma pontuação separada de battlepass para explicar. Um fã que chega ao nível 12 desbloqueou todos os patamares até ao 12.
Isso também significa que os limiares de XP dos seus níveis e o seu battlepass são o mesmo problema de design. Níveis demasiado espaçados dão ao fã um patamar por mês.
Qualquer recompensa pode ficar num patamar, incluindo prémios e loot boxes. Veja [Recompensas](/docs/rewards).
## O percurso gratuito e o percurso Premium [#the-free-track-and-the-premium-track]
Dois percursos, lado a lado, em cada nível.
Todos podem reivindicar as recompensas do percurso gratuito. O percurso Premium tem o plano de subscrição como requisito de acesso: o fã vê exatamente o que o espera nele e que plano precisa de ter para reivindicar, e as recompensas ficam acumuladas em vez de expirarem. Um fã que muda para o plano Premium no nível 20 recebe tudo aquilo por que passou na subida.
Esconda as recompensas Premium e ninguém compra a subscrição. Deixe o percurso gratuito sem valor e ninguém sobe o suficiente para se interessar pelo percurso Premium.
## Subscrição Premium [#premium-membership]
Um plano pago que os fãs compram dentro da sua aplicação. É ele que dá acesso ao percurso Premium do battlepass, e funciona de forma autónoma, quer use um battlepass quer não.
| Definição | Como funciona |
| ------------------- | ----------------------------------------------- |
| Pagamentos | Stripe, ligada à sua conta |
| Modelo | Uma subscrição recorrente ou um pagamento único |
| Preço e moeda | Definidos por si |
| Receita | Fica consigo. Não passa por nós |
| Benefícios | Definidos por si |
| Onde os fãs a gerem | Na aplicação, em Definições |
Os benefícios são o que decidir reservar ao plano. Os que os parceiros usam:
* Missões exclusivas, visíveis apenas para membros
* Recompensas melhores nas missões que todos podem ver
* O percurso Premium do battlepass
* Publicações com requisitos de acesso no [feed de notícias](/docs/newsfeed)
* Artigos da loja que os membros podem comprar e os outros não
* Um selo personalizado na linha deles na classificação e no perfil
O selo é o único benefício que os outros fãs conseguem ver, e ser visivelmente membro perante a comunidade é grande parte do que as pessoas estão a comprar.
Defina o preço com base no que o fã já gasta consigo, e não com base noutras aplicações. E escreva a lista de benefícios antes de definir o preço, porque um plano que é um percurso de battlepass e nada mais é difícil de vender no segundo mês. O que isto muda no seu acordo comercial connosco está em [Quanto custa](/docs/getting-started/pricing).
# Registo de alterações (/pt/docs/changelog)
As correções e os pequenos ajustes ficam de fora, a menos que mudem a forma como usaria alguma coisa.
**O SDK alcançou a plataforma.** Prognósticos, eventos, o battlepass, o feed de notícias, a loja, as classificações e os avatares já podem ser integrados no seu próprio site. A lista está em Estado das funcionalidades do SDK da FanBase.
**Os blocos da FanBase para temas da Shopify estão em desenvolvimento.** Missões, o perfil e o avatar do fã e um indicador de conta para o seu cabeçalho, adicionados no editor de temas da Shopify, sem código. A disponibilização começa pelas lojas-piloto. [Shopify](/docs/integrations/shopify#on-your-storefront)
**Agora os pontos compram encomendas reais.** Lançamento a 7 de outubro. O fã compra um artigo da loja com pontos e aparece uma encomenda paga na sua Shopify, associada ao registo de cliente dele, com a morada de entrega que indicou. [Shopify](/docs/integrations/shopify#spending-points-back-into-shopify)
* Ative **Fulfil via Shopify** (processar pela Shopify) num artigo da loja e depois escolha o produto e a variante que ele representa
* O artigo pede ao fã um e-mail e uma morada de entrega na finalização da compra, com o nome do destinatário
* Cada compra mostra a encomenda da Shopify e o respetivo estado no painel de administração, com a opção de tentar de novo se alguma falhar
* Estas encomendas recebem a etiqueta `fanbase-redemption` e nunca acionam uma regra de recompensa
* A sua loja precisa de ser autorizada mais uma vez para as encomendas. O painel de administração mostra um aviso quando isso é necessário.
**Limites de compra por fã.** Lançamento a 7 de outubro. Cada artigo da loja pode limitar quantas unidades compra um mesmo fã, com um número separado para os fãs do plano gratuito e os fãs Premium. Os fãs veem o limite no artigo, e também o que o outro plano recebe. [Loja](/docs/store#purchase-limits)
* Use-os para um drop justo, em que um limite de um põe cinquenta artigos em cinquenta mãos
* Ou como motivo para mudar de plano, ao dar aos fãs Premium um limite maior do que o dos fãs do plano gratuito
**Um separador Legacy para battlepasses antigos.** Lançamento a 27 de outubro. As comunidades com um battlepass criado antes das temporadas ainda podem ver e editar as recompensas dele. [Battlepass](/docs/battlepass#seasons)
**O battlepass é agora uma funcionalidade própria.** Antes era um conjunto de missões de verificação de nível feitas à mão. Agora é uma secção de pleno direito do painel de administração, com temporadas que pode deixar em rascunho, duplicar, editar e encerrar. Uma temporada tem um percurso gratuito e um percurso Premium, além de datas opcionais, por isso pode durar para sempre ou duas semanas.
* Os battlepasses existentes continuam a funcionar e a aparecer como antes
* Migrar um deles significa refazê-lo como temporada, por isso planeie-o entre temporadas, e não a meio de uma
**Os artigos da loja podem ser objetos de personalização**, por isso as fotos de perfil e as molduras podem ser compradas, e não apenas ganhas.
**A criação de encomendas na Shopify** entrou em fase de testes. O fã gasta pontos na sua loja, e aparece uma encomenda real na sua Shopify, com uma morada de entrega e um limite de compra por fã.
**O SDK.** Dois pacotes que colocam missões, recompensas e contas de fãs dentro do seu próprio site, com o seu design e sem iframe. Missões, recompensas e início de sessão já estão disponíveis nos pacotes. [O seu próprio front-end](/docs/getting-started/integration-paths#your-own-front-end).
**Comentários ao estilo do Reddit no feed de notícias.** As respostas ficam aninhadas, as conversas podem ser recolhidas, os fãs podem editar e eliminar os próprios comentários, e cada comentário tem um link permanente.
**Mais duas regras de recompensa da Shopify.** Recompense todas as compras, independentemente do que foi comprado, e recompense por unidade de moeda gasta. As duas juntam-se à regra original, baseada em etiquetas.
**A redução progressiva de recursos** ganhou uma contagem decrescente e uma apresentação mais clara antes da reivindicação, para o fã ver o que está a perder ao esperar.
**Missões em várias etapas.** Uma sequência que antes exigia várias missões encadeadas e com requisitos de acesso cabe agora num único cartão, com uma única recompensa. Todas as etapas ficam visíveis desde o início. Os fãs desistiam depois da quarta missão de uma cadeia cujo fim não conseguiam ver.
**Fotos de perfil, molduras e fundos personalizados.** Carregue os seus e distribua-os através de missões, de eventos, da loja e de loot boxes. Aparecem na classificação, nos perfis, nos comentários e na barra de navegação.
**Redução progressiva de recursos.** Uma recompensa que diminui quanto mais o fã demora a reivindicá-la. Defina um valor inicial, uma taxa de redução e um valor mínimo.
**Melhorias na loja.** Um carrossel de destaques na entrada da loja, etiquetas com filtros visíveis para os fãs, ordenação personalizada e filtro por artigos em stock.
**Imagens nos cartões de missão**, para que cada missão do quadro de missões tenha a sua própria imagem.
**Acesso público à API.** Chaves de API para organizações que levam os dados da comunidade para a sua própria infraestrutura. [Data API](/docs/integrations/data-api).
Endpoints só de leitura com chaves de API por comunidade, emitidas a pedido: membros, eliminações de membros, atividade, saldos de recursos, objetos detidos, aberturas de loot boxes e estatísticas principais. Documentados com Swagger, com limite de pedidos, e incrementais com `updatedSince`, para poder sincronizar em vez de transferir tudo de novo.
**Um modelo de missão de prognóstico.** Peça aos fãs um prognóstico sobre um jogo, uma mudança no plantel ou qualquer outra coisa que tenha um resultado. As opções têm as suas próprias imagens, as participações são bloqueadas à hora que definir, e as recompensas são distribuídas automaticamente na resolução, com uma notificação.
A participação é gratuita. Nada fica em jogo e não há aposta, por isso o fã não tem como perder nada.
**A emissão e a queima on-chain de objetos colecionáveis foram descontinuadas** quando o fornecedor responsável cessou a atividade. Os objetos colecionáveis continuam a existir, continuam a ser ganhos e continuam a ser apresentados. O início de sessão com carteira e as missões on-chain não foram afetados.
**Os nomes de utilizador funcionam agora como no Discord.** Um nome de apresentação mais um sufixo oculto de quatro dígitos, para que dois fãs possam ser `sniper` e nenhum precise de ser `sniper_2847`.
**Transferência em massa dos envios de missão.** Todos os envios de imagem e de texto de uma missão num ficheiro zip, mais um CSV de quem enviou o quê.
**Concessão de recursos em massa** por carregamento de CSV, e criação por conta própria de uma segunda moeda gastável. As duas coisas exigiam antes um pedido a um engenheiro.
**Modo claro.** Definido por comunidade: escuro, claro ou os dois, com um seletor para os fãs. O escuro continua a ser a predefinição. Fale connosco antes de escolher os dois, porque dois temas significam verificar tudo a dobrar.
**Navegação personalizada.** Mude o nome e a ordem das secções, oculte as que não usa e adicione os seus próprios links para o seu site ou a sua loja.
**Um fluxo de revisão mais claro.** As missões que aguardam revisão manual aparecem como pendentes no quadro de missões, e as missões com recompensas por reivindicar ficam mais fáceis de encontrar.
**Artigos da loja com requisito de acesso por nível ou por plano de subscrição**, visíveis mas bloqueados, para que a progressão tenha um objetivo que puxe pelo fã.
**Spotify.** Associação de conta e três modelos de missão: seguir um artista, seguir uma playlist e verificar os artistas mais ouvidos do fã.
**Mude o nome das funcionalidades.** As missões podem chamar-se desafios, os eventos podem chamar-se torneios, e o novo nome aplica-se em toda a aplicação.
**Google Analytics e Tag Manager** na sua aplicação.
**Imagens de fundo por página** para o quadro de missões, a loja, a classificação, o perfil e as restantes páginas, além de tipos de letra personalizados.
**Início de sessão único com a Shopify.** Os fãs iniciam sessão com a conta que já têm na sua loja. Sem um segundo registo, e as compras e os pontos deles ficam numa única identidade. [Shopify](/docs/integrations/shopify).
**Níveis e planos** com nomes e ícones personalizados, apresentados na classificação e nos perfis, com um selo personalizado por plano de subscrição.
**Duas recompensas numa mesma missão**, concedidas em conjunto.
**Uma nova animação de abertura de loot box** nas missões, nos eventos e no battlepass.
**Associação de carteira Solana** com Phantom, Solflare e Backpack, além de um modelo de missão de posse de NFT.
**Anúncios do bot do Discord.** Publique num canal quando uma missão fica online, um evento começa ou um evento termina.
**Selos Premium** apresentados na classificação e nos perfis, configuráveis por plano.
**Uma revisão a fundo da versão para telemóvel** do feed de notícias, da loja e da navegação.
# Eventos (/pt/docs/events)
Um evento é um quadro de missões com um relógio e uma classificação à volta. Os fãs entram, competem durante um período fixo e são recompensados consoante a posição em que terminam.
## Configurar o evento [#setting-it-up]
| Campo | O que faz |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Título | O nome no cartão do evento e no topo da página do evento. |
| Descrição | Em que competem os fãs e como ganham. |
| Banner | A imagem do cartão do evento. |
| Período do evento | Quando o evento começa e termina. |
| Período de inscrição | Quando os fãs podem entrar. |
| Requisitos | Quem pode entrar: um nível, um cargo no Discord, um objeto colecionável, outra missão ou um plano de subscrição. |
| Máximo de participantes | Um teto para o número de fãs que podem entrar. Deixe em branco para não haver teto. |
A inscrição tem um período próprio, separado do período do evento. Se a inscrição encerrar no momento em que o evento abre, todos os fãs que ouvirem falar do evento no segundo dia ficam de fora. A menos que esteja a organizar um torneio com um quadro de eliminatórias fixo, encerre a inscrição quando o evento terminar.
## Escolher o tipo [#choosing-the-type]
O tipo define como os fãs pontuam e não pode ser alterado depois.
| Tipo | Como funciona | Quando usar |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Básico | As missões são escolhidas por si na biblioteca de modelos. Os fãs concluem-nas, cada conclusão vale pontos, e a classificação ordena pelo total. | Qualquer coisa que não esteja ligada a um jogo: uma semana de lançamento, uma ativação de patrocinador, um drop de produtos oficiais. Funciona para qualquer comunidade. |
| Por pontuação | Só para jogos eletrónicos. A pontuação é dinâmica e acompanha o jogo real, por isso cada eliminação ou cada vitória vale pontos, em vez de uma única conclusão. | Um torneio, uma ação para jogar em simultâneo durante uma partida, qualquer situação em que queira que o desempenho conte mais do que a participação. |
| Colaborativo | Uma meta partilhada por toda a comunidade. Todos os que participaram são recompensados quando é atingida. | Chegar em conjunto a um número: envios recolhidos, partidas ganhas por toda a comunidade, um marco que queira alcançar em grupo. |
Nos eventos por pontuação, cada participante precisa de ter associado a conta de jogo correspondente antes de poder pontuar. Diga-o na descrição e conte com a perda de alguns participantes no passo de associação se o evento for curto. Veja [início de sessão e associação de contas](/docs/settings/sign-in).
Os eventos colaborativos são a melhor escolha quando a sua comunidade é tão pequena que uma classificação seria desmotivante.
## Recompensas por posição [#rewards-by-position]
As recompensas estão ligadas às posições finais, e uma posição pode ser um intervalo. O primeiro lugar recebe uma coisa, do segundo ao quinto recebem outra, do sexto ao quinquagésimo recebem outra ainda.
Recompense além do pódio. Um evento em que só três fãs são recompensados é um evento que noventa por cento da sua comunidade deixa de acompanhar no segundo dia. Uma pequena recompensa até ao quinquagésimo lugar mantém o meio da classificação a competir.
Os eventos colaborativos dão o mesmo a todos os que participaram, por isso há uma única recompensa, e não uma escada delas.
As recompensas vêm do mesmo conjunto das missões: XP, moeda gastável, prémios, objetos colecionáveis e loot boxes. Veja em [Criar uma missão](/docs/quests/creating) o que é cada uma.
## Depois de publicar [#after-publishing]
Só o **título** e a **descrição** podem ser editados depois de um evento ser publicado. O período, o tipo, os requisitos e as recompensas ficam fixos.
Se algum deles estiver errado, duplique o evento, corrija a cópia e retire o original de publicação antes que os fãs reparem que há dois. Faça-o cedo: um evento com participantes já inscritos não pode ser substituído discretamente.
## Exportar os participantes [#exporting-participants]
Exporte a lista de participantes em CSV, durante o evento ou depois dele, incluindo de um evento arquivado.
É isto que envia a um patrocinador, e é o que usa para entregar os prémios que dependem de uma pessoa no processo. As recompensas personalizadas que exigem morada de entrega ou e-mail são acompanhadas à parte em [Recompensas personalizadas](/docs/rewards/custom-rewards).
Para que servem os eventos, e os três tipos do ponto de vista do fã, estão em [Eventos](/docs/events).
# Introdução (/pt/docs)
A FanBase dá à sua comunidade um lugar onde prestar atenção compensa. Os fãs iniciam sessão, concluem missões, sobem na classificação, gastam o que ganham e colecionam objetos que vale a pena guardar.
Para a integrar no seu próprio site com código, existe o SDK da FanBase, documentado num site separado.
## Três formas de o gerir [#three-ways-to-run-it]
A plataforma por baixo é a mesma. O que muda é quem é dono do front-end.
Alojamo-la no seu domínio. As suas cores, o seu logótipo e o seu layout. Online em poucos dias.
O SDK dentro do seu site. Cada píxel e cada rota são seus.
Concebemos e desenvolvemos consigo. Para organizações com requisitos próprios.
A maioria dos parceiros começa com a aplicação alojada e passa mais tarde para um front-end próprio. O painel de administração, os fãs e o progresso deles mantêm-se, porque só o front-end mudou.
## Mecânicas que a sua equipa gere [#mechanics-your-team-runs]
Tudo o que o fã vê é configurado no painel de administração. Uma missão fica online no momento em que alguém a publica, sem qualquer deploy pelo meio.
Seguir, jogar, fazer prognósticos, responder, enviar, comprar. Mais de 150 modelos.
Pontos, prémios, loot boxes, objetos colecionáveis, cargos do Discord.
Temporadas com um percurso gratuito e um percurso Premium.
Os fãs gastam o que ganham. Liga-se à sua Shopify.
# Classificações (/pt/docs/leaderboards)
Uma única classificação, acumulada desde o início, com toda a comunidade. Não custa nada a configurar, e os fãs abrem-na sem que ninguém lhes peça.
## A base da classificação [#the-ranking-basis]
Duas bases, e escolhe-se uma por comunidade. É definida quando criamos a sua comunidade, por isso diga-nos qual pretende durante o [onboarding](/docs/getting-started/onboarding).
| Base | Ordena por | O que recompensa |
| ------------------ | ------------------------------------------------------------------- | ---------------------------------------------------------- |
| XP | O total de XP ganho, o mesmo número que define os níveis | O esforço, ponderado pelo valor que atribuiu a cada missão |
| Missões concluídas | O número de missões concluídas, independentemente de quanto rendiam | A abrangência. Fazer tudo, em vez de fazer o que tem valor |
Escolha XP, a menos que tenha um motivo para não o fazer. Com a classificação por missões concluídas, um fã que despachou trinta missões de um minuto passa à frente de um fã que suou para concluir três difíceis, e os valores das suas recompensas deixam de servir de sinal. É a escolha certa quando o seu quadro de missões é propositadamente uniforme e pretende participação em vez de intensidade.
Não é possível usar as duas ao mesmo tempo, e mudar a base mais tarde reordena a classificação e tira do lugar os fãs que tinham conquistado a sua posição.
## As classificações de evento são separadas [#event-leaderboards-are-separate]
Cada evento tem a sua própria classificação, restrita a esse evento, que fica na página do evento e não aqui. Ordena só os participantes, conta só o que o evento conta e termina quando o evento termina.
Um fã que chegou na semana passada pode ganhar um evento sem ter primeiro de ultrapassar um ano de XP acumulado. Veja [Eventos](/docs/events).
## Sequências [#streaks]
As sequências pertencem às missões, e não à classificação. Configure uma missão para se renovar todos os dias ou todas as semanas, e o fã que a concluir em renovações consecutivas ganha uma recompensa crescente até atingir o teto que definir. Se falhar uma renovação, a sequência volta a zero.
O comportamento completo, incluindo o teto de recompensa e o que acontece quando o fã falha um dia, está em [Criar uma missão](/docs/quests/creating#set-the-advanced-properties).
Para uma competição curta e independente que os fãs mais recentes possam ganhar, crie um [evento](/docs/events): permite definir quem compete e o que conta, numa classificação que tem fim.
## Redefinir saldos [#resetting-balances]
Uma redefinição põe a zero o saldo e o nível de todos os fãs, por isso a classificação começa vazia e os colegas que testaram as suas missões deixam de aparecer no topo no primeiro dia.
A redefinição de saldos não pode ser anulada, por isso faça-a uma única vez, depois dos testes e antes de convidar quem quer que seja. O que apaga e o que mantém está em [Redefinir saldos](/docs/rewards/resources#reset-balance).
## Histórico por temporada [#seasonal-history]
Em estudo
Hoje uma redefinição apaga a classificação e nada guarda o registo de quem estava em que posição. Manter as temporadas passadas, para que um fã possa mostrar que terminou entre os dez primeiros numa temporada que entretanto foi apagada, está na lista. Pergunte ao seu contacto na FanBase em que ponto isto está antes de planear uma temporada em torno disso, e veja [Estado das funcionalidades](/docs/status).
# Níveis (/pt/docs/levels)
Os níveis são a única definição cuja alteração os fãs notam. Acerte a escada antes do lançamento e nunca mais precisa de lhe mexer.
## Criar um nível [#creating-a-level]
**Create level** e depois quatro campos. Três são obrigatórios e o ícone é opcional.
| Campo | O que faz |
| ----- | -------------------------------------------------------------------------------------------------------------- |
| Ordem | A posição na escada: 1, 2, 3. Define o que vem depois de quê. |
| Nome | Como os fãs lhe chamam. Os números funcionam. De Rookie a Legend também, ou os seus próprios títulos. |
| XP | O total de XP de que o fã precisa para o alcançar. É cumulativo, não a diferença em relação ao nível anterior. |
| Ícone | Opcional. O selo apresentado ao lado do nome do fã na classificação, nos comentários e no perfil. |
## Gerir a escada [#managing-the-ladder]
* **Reorder** move um nível para cima ou para baixo na escada.
* **Rename** muda o nome de um nível. Os fãs veem o novo nome de imediato.
* **Adjust XP** altera qualquer limiar. Os fãs são reavaliados com base nos novos números, por isso descer um limiar promove pessoas e subi-lo despromove-as.
* **Reset** redefine a escada inteira, seja para os nossos níveis e limiares predefinidos, seja para uma escada personalizada construída de raiz.
## Boas práticas [#best-practice]
### Finalize antes do lançamento [#finalise-before-launch]
Os fãs tomam a escada como referência no dia em que a veem. Alguém que está há uma semana a trezentos XP de Contender e descobre que Contender agora custa o dobro entende isso como uma mudança das regras a meio do jogo.
### Alinhe o XP por missão com os seus limiares [#align-xp-per-quest-with-your-thresholds]
Decida quanto tempo devem demorar os primeiros níveis e depois conte as missões do seu quadro de missões e o XP que rendem.
Uma distribuição que funciona com a escada predefinida:
| Dificuldade da missão | XP | Exemplos |
| --------------------- | --- | ------------------------------------------------------------------------------------------------------------------ |
| Simples | 10 | Visitar um link, seguir uma conta, entrar no Discord |
| Moderada | 25 | Ver uma transmissão em direto durante uma hora, responder a um quiz, concluir uma missão diária durante uma semana |
| Difícil | 50 | Atingir uma determinada posição no ranking do jogo, jogar um certo número de horas, enviar um trabalho a sério |
| Especial | 100 | O final de uma campanha, uma vitória num evento, algo que só acontece uma vez |
Há duas formas de isto correr mal. Com XP a mais por missão, os fãs chegam ao nível máximo numa semana, a classificação deixa de mexer porque toda a gente está no teto, e não sobra nada para dar a quem mais se importa. Este é o erro mais comum, e o único que não consegue corrigir sem [redefinir saldos](/docs/rewards/resources#reset-balance). Com XP a menos por missão, a barra de progresso nunca se move de forma visível: os fãs concluem quatro missões, não veem nada acontecer e param.
Um teste rápido antes do lançamento: pegue nas missões que um fã dedicado conseguiria concluir na primeira sessão, some o XP e veja a que nível isso corresponde. Se for o máximo, as suas recompensas são demasiado altas. Se não for o segundo, são demasiado baixas.
As missões recorrentes também entram nas contas, porque uma missão diária de 10 XP representa por si só 3650 XP por ano. São os [tetos de recompensa nas sequências](/docs/quests/creating#set-the-advanced-properties) que mantêm isso sob controlo.
# Membros (/pt/docs/members)
Uma linha por fã, e a linha é o registo completo: como iniciou sessão, o que associou, o que ganhou, o que possui.
## Encontrar um fã [#finding-a-fan]
Pesquise pelo nome de utilizador dele na aplicação. Os nomes de utilizador seguem o estilo do Discord, um nome de apresentação mais um sufixo de quatro dígitos, por isso vários fãs podem ter o mesmo nome sem ambiguidade no painel.
Quando só tiver um nome de utilizador de uma rede social, por exemplo o nome de utilizador no X da pessoa que está a reclamar, pesquise por ele. A pesquisa é feita nas contas associadas e devolve o fã que está por trás delas.
## Ler um registo [#reading-a-record]
Selecione um fã e depois **Edit**.
| Secção | O que mostra |
| ----------------- | --------------------------------------------------------------------------------------------------------- |
| Contas associadas | Todas as contas de redes sociais, de jogos e de carteira que associou, e com qual delas se registou |
| Estatísticas | O nível, os saldos, as missões concluídas, os objetos detidos, os eventos em que participou e os convites |
| Zona de perigo | Eliminar ou banir |
Eliminar ou banir um fã é permanente e não pode ser anulado. A eliminação remove a conta e o respetivo progresso. Peça a uma segunda pessoa que confirme antes de usar qualquer uma das duas ações e anote o motivo fora do painel.
Editar um registo serve para correções, não para o trabalho de rotina. Ajustar à mão o saldo de um fã não tem problema; para ajustar cinquenta, existe o carregamento em massa descrito abaixo.
## Exportar a lista de membros [#exporting-the-member-list]
**Export** gera um CSV com todos os fãs da comunidade.
| Coluna | O que contém |
| ------------ | ---------------------------------------------------------------------------------------------------------------- |
| User ID | O identificador único do fã. É a coluna a usar como chave se for cruzar este ficheiro com os seus próprios dados |
| Handle | O nome de utilizador dele na aplicação |
| Email | O endereço de e-mail dele, se tiver indicado um |
| Discord | O nome de utilizador dele no Discord, se estiver associado |
| X | O nome de utilizador dele no X, se estiver associado |
| XP | O total de XP acumulado |
| Level | O nível atual dele |
| Total quests | As missões concluídas |
| Total items | Os objetos detidos |
| Referred | Quantos fãs convidou com sucesso |
| Joined at | Quando entrou |
| Left at | Quando eliminou a conta, se o tiver feito |
A exportação é um retrato do momento. É a ferramenta certa para uma necessidade pontual: sortear um vencedor ou preparar um resumo para um patrocinador.
Este ficheiro contém dados pessoais. Trate-o como trata a sua própria lista de clientes: mantenha-o nos sistemas abrangidos pela sua política de privacidade e elimine a cópia da sua pasta de transferências quando terminar de o usar.
## Concessões e débitos em massa [#bulk-grants-and-debits]
Uma moeda pode ser concedida a muitos fãs, ou debitada a muitos fãs, de uma só vez a partir de um CSV. Carregue o ficheiro e o painel executa-o.
Use esta ferramenta para uma compensação depois de uma indisponibilidade, uma migração de saldos de um sistema que usava antes ou a lista de prémios de uma competição avaliada fora da aplicação.
Peça primeiro um teste em sandbox com cinco linhas, porque um débito em massa é tão rápido como uma concessão em massa. E anote o que enviou e porquê, já que os saldos mudam sem qualquer explicação para os fãs afetados.
# Feed de notícias (/pt/docs/newsfeed)
Todas as publicações saem em nome de um autor, por isso crie os seus autores antes de escrever a primeira publicação.
## Primeiro, os autores [#publishers-first]
O autor é quem assina a publicação, e todas as publicações têm um.
Para criar um, bastam um nome e uma imagem de perfil.
A maioria das equipas quer mais do que um. Uma organização de esports publica como organização nos anúncios e como cada jogador profissional no conteúdo dele, e os fãs filtram o feed por autor para acompanhar o jogador que lhes interessa.
Crie-os todos logo no início. Adicionar um autor mais tarde não muda a autoria das publicações que já saíram com outro nome.
## Criar uma publicação [#creating-a-post]
| Elemento | O que faz |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Imagens | Uma ou várias por publicação. |
| Vídeo | Carregado e reproduzido no feed. |
| Texto formatado | Títulos, negrito, listas e links no corpo do texto. |
| Links | Um link para o X, o YouTube ou a Twitch aparece como conteúdo incorporado, e não como um URL solto, por isso a publicação mostra o vídeo ou o tweet ali mesmo. |
O conteúdo incorporado é o motivo para publicar aqui, e não só nas redes sociais: o fã vê o clipe sem sair da aplicação, e tudo o resto na página é uma missão.
## Definir requisitos de acesso para uma publicação [#gating-a-post]
Restrinja uma publicação aos fãs que conquistaram o direito de a ver.
| Requisito | Quem entra |
| ------------------- | ------------------------------------------------------------------------------------------ |
| Nível | Fãs num nível à sua escolha ou acima dele |
| Cargo no Discord | Fãs que têm um cargo no seu servidor. Exige o [Discord](/docs/integrations/discord) ligado |
| Objeto colecionável | Fãs que possuem um objeto específico |
| Subscrição Premium | Fãs num plano pago. Veja [Subscrição Premium](/docs/battlepass#premium-membership) |
O conteúdo com requisitos de acesso é uma das poucas recompensas que não custam nada a produzir uma segunda vez. Imagens de bastidores ou um anúncio antecipado da equipa: publique com requisitos de acesso e rende mais do que o mesmo clipe publicado para todos.
Não coloque requisitos de acesso em tudo. Um feed que um fã novo não consegue ler não lhe dá nenhum motivo para voltar e conquistar a entrada.
## Fixar e destacar [#pinning-and-featuring]
Fixar mantém uma publicação no topo do feed. Destacar retira uma publicação do feed para a mostrar à parte. O destaque serve para as publicações duradouras, as que ainda vão valer a leitura daqui a três meses: como funciona a comunidade, o que são as temporadas, por onde começar.
As duas opções servem para uma publicação de cada vez. Um feed com quatro publicações fixadas não tem topo.
Desafixe quando o momento passar. Uma antevisão fixada de um jogo que terminou na semana passada diz aos fãs que o feed não está a ser mantido em dia.
## Comentários [#comments]
Os fãs respondem às publicações, e as respostas ficam encadeadas, por isso a conversa mantém-se legível em vez de se tornar uma lista corrida. Os fãs podem editar e eliminar os próprios comentários, e as conversas longas são recolhidas. Um comentário editado é marcado como editado. Um comentário eliminado deixa intactas as respostas que estão abaixo dele.
Cada comentário tem um link permanente, por isso pode apontar diretamente para ele em vez de descrever até onde é preciso percorrer a página.
A moderação faz-se no painel de administração: remova um comentário que viole as suas regras e trate do fã em [Membros](/docs/members) se for um padrão, e não um caso isolado.
Decida quem modera antes do lançamento, e decida a pensar no pior dia, não num dia normal. As noites de jogo e as notícias do plantel geram comentários mais depressa do que qualquer outra coisa na aplicação, e um feed em que a resposta mais agressiva ficou três dias visível dá o tom do mês seguinte.
A votação em comentários, positiva e negativa, com ordenação por pontuação, está pronta, mas vem desativada por predefinição. Peça-nos que a ativemos se a quiser. Adequa-se a uma comunidade grande, em que as melhores respostas precisam de subir. Numa comunidade mais pequena, deixe-a desativada.
# Prognósticos (/pt/docs/predictions)
Um prognóstico pede aos fãs que escolham um resultado antes de este ser conhecido. O resultado de um jogo, uma mudança no plantel, um marcador, o cara ou coroa num evento ao vivo. As participações encerram à hora que definir e, quando a coisa acontece, basta marcar o que estava certo e a plataforma recompensa todos os que escolheram essa opção.
Participar é gratuito. Nada fica em jogo, nada é apostado, e o fã não tem como ficar pior do que estava antes de responder.
## O que tem de preencher [#what-you-fill-in]
| Campo | Obrigatório | O que faz |
| ---------------- | ----------- | ------------------------------------------ |
| Opções | Sim | O que o fã pode escolher |
| Hora de bloqueio | Sim | O momento em que as participações encerram |
Cada opção tem três elementos, e dois deles pode usar ou ignorar como quiser.
| Por opção | Obrigatório | Para que serve |
| --------- | ----------- | -------------------------------------------------------------------- |
| Rótulo | Sim | A resposta pura e simples. É com base nela que resolve o prognóstico |
| Imagem | Não | Apresentada com 40 px ao lado do rótulo |
| Descrição | Não | Uma linha por baixo do rótulo |
**Mantenha o rótulo simples e ponha a parte interessante na descrição.** O rótulo é o que vai marcar como correto mais tarde, por isso tem de continuar claro quando for relido semanas depois de ter sido escrito. «Camisola principal branca» pode ser resolvido. «A que toda a gente quer» não pode. A linha de baixo é o lugar de «invictos com ela desde março», e é essa linha que leva o fã a escolher uma opção em vez da outra.
**As imagens valem a pena quando as opções são coisas que se reconhecem mais depressa do que se leem.** Uma combinação de cores, uma capa de disco, uma cidade. Em 40 px cabem uma forma e duas ou três cores, por isso a fotografia de uma multidão torna-se um borrão e a imagem renderizada de um produto continua legível. São um desperdício num marcador, em que o rótulo já diz tudo.
## Quem pode participar [#who-can-enter]
Um prognóstico é uma missão, por isso aceita as mesmas regras de público de todas as outras
missões. Defina um requisito de acesso e o cartão continua a aparecer, mas não abre para quem
não cumpre o requisito, e o fã fica a saber o motivo em vez de ficar a tocar num cartão sem resposta.
Um prognóstico aceita todas as condições descritas em [Requisitos de acesso](/docs/settings/gating), e o
requisito aplica-se ao cartão inteiro, e não ao envio: um fã que escolhe um resultado
e só depois descobre que nunca foi elegível teve o trabalho duas vezes.
Duas merecem destaque aqui. **Activated users** (utilizadores ativados), porque a participação é gratuita
e algo que vale a pena ganhar é exatamente o que atrai uma conta descartável.
**Membership** (subscrição), porque muda o significado da contagem: um prognóstico só para
membros mostra o que pensam os seus fãs pagantes, o que é uma pergunta diferente
de saber o que toda a gente pensa, e geralmente a mais útil.
## O bloqueio [#the-lock]
As participações encerram à hora de bloqueio e as opções deixam de responder. Antes dela, o cartão indica quando será bloqueado. Depois, indica que as participações estão encerradas e mostra a hora.
**Defina o bloqueio para antes de o resultado poder ser conhecido.** É a única coisa que corre mal. Um fã que está a ver o jogo pode responder com o resultado à sua frente, por isso um bloqueio definido para o fim do jogo não é um prognóstico, é uma recompensa de graça. O início do jogo costuma ser o momento certo, e mais cedo é mais seguro do que mais tarde.
A plataforma aplica isto pelo relógio, não pela sua resolução. Passado o bloqueio, já ninguém pode participar, quer tenha marcado uma resposta quer não.
## O que o fã vê [#what-a-fan-sees]
Uma única escolha. É definitiva no momento do envio, e o cartão indica-o em vez de deixar o fã tentar de novo. Um fã que já respondeu vê o que escolheu.
**A divisão das respostas fica visível antes de o fã participar**, e este é o único ponto em que um prognóstico se comporta de forma diferente de uma [sondagem](/docs/quests/templates/submission#poll). Uma sondagem esconde o resultado até se votar, para que a opinião dos outros não influencie a resposta. Um prognóstico mostra-o desde o início, porque estar com a maioria ou contra ela é boa parte do motivo para participar.
O número total de participações fica por cima das opções, e a participação do próprio fã soma-se a ele. Num prognóstico com alguns milhares de pessoas, uma participação a mais mexe nesse total, e não nas percentagens, e é isso que o cartão deve mostrar para ser honesto.
## Resolver o prognóstico [#resolving-it]
Marque a opção que se revelou correta. A ação resume-se a isso.
Todos os que a escolheram recebem a recompensa automaticamente e são avisados de que acertaram. Todos os que escolheram outra coisa são avisados de que erraram. Ninguém perde nada do que tinha.
Enquanto não o resolver, a missão fica ali, bloqueada e sem pagar a recompensa. Não existe resolução automática, porque a plataforma não tem como saber o que aconteceu no seu evento.
## Quando usar um prognóstico [#when-to-use-one]
Os prognósticos mostram o seu valor em torno de um jogo marcado, porque dão ao fã um motivo para estar na aplicação antes de ele começar e um motivo para voltar depois de terminar. Um prognóstico antes do início e o resultado publicado depois no [feed de notícias](/docs/newsfeed): é este o formato que funciona.
Funcionam mal como conteúdo permanente. Um prognóstico sem um acontecimento por trás não tem um prazo que interesse a alguém nem nada com base em que possa ser resolvido.
## O que não é [#what-it-is-not]
Não é uma aposta. Não há valor apostado, nem odds, nem um pagamento que cresce consoante o número de pessoas que erraram. Todos os que acertam recebem a mesma recompensa, e é a recompensa que definiu na missão, como em qualquer outra.
Não é uma sondagem. Coloque as mesmas opções nos dois e só a pergunta muda: uma sondagem pergunta que combinação de cores se quer e recompensa todos os que respondem, um prognóstico pergunta qual sai na sexta e recompensa os fãs que acertaram. A primeira é pesquisa. O segundo tem uma resposta certa que já conhece.
# Estado das funcionalidades (/pt/docs/status)
Tudo o que não aparece nesta página está disponível. O SDK recebe as funcionalidades depois da aplicação alojada, porque uma funcionalidade tem de existir antes de poder ser empacotada, e a página Estado das funcionalidades do SDK da FanBase acompanha isso em separado.
## Disponível [#live]
Tudo nesta tabela está em produção na aplicação alojada. A segunda coluna responde a outra pergunta: se a mesma funcionalidade já faz parte do SDK, o que é acompanhado na página Estado das funcionalidades do SDK da FanBase. De propósito, não reutiliza as quatro designações de estado acima, porque uma linha com «Planeado» dentro de uma tabela intitulada Disponível seria lida como algo que não foi desenvolvido.
| Funcionalidade | No SDK | Observações |
| ------------------------------------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Contas de fãs e início de sessão | Sim | Google, Discord, X, Twitch e Shopify. [Início de sessão](/docs/settings/sign-in) |
| Missões | Sim | Mais de 150 modelos entre aplicação, redes sociais, jogos e on-chain. [Modelos de missão](/docs/quests/templates) |
| Missões em várias etapas | Sim | Várias etapas dentro de um único cartão, uma única recompensa. [Criar uma missão](/docs/quests/creating#multi-step-quests) |
| Prognósticos | Sim | Participação gratuita, com hora de bloqueio. Basta marcar o resultado e a recompensa é paga. [Prognósticos](/docs/predictions) |
| Recompensas e loot boxes | Sim | Pontos, prémios, objetos colecionáveis, loot boxes, cargos do Discord. [Recompensas](/docs/rewards) |
| Redução progressiva de recursos | Sim | Recompensas que diminuem à medida que os fãs as reivindicam. [Recompensas](/docs/rewards#decaying-rewards) |
| Eventos | Sim | Básicos, por pontuação e colaborativos. [Eventos](/docs/events) |
| Classificações | Sim | Acumuladas desde o início, por pontos ou por missões concluídas. [Classificações](/docs/leaderboards) |
| Battlepass com temporadas | Sim | Percursos gratuito e Premium, temporadas que pode duplicar. [Battlepass](/docs/battlepass) |
| Loja | Sim | Gastar a moeda ganha, com requisitos de acesso por nível ou por subscrição. [Loja](/docs/store) |
| Limites de compra na loja | Ainda não | Quantas unidades de um artigo pode comprar um mesmo fã, com definição separada para os fãs do plano gratuito e os fãs Premium. [Loja](/docs/store#purchase-limits) |
| Feed de notícias | Sim | Publicações, reações, comentários encadeados. [Feed de notícias](/docs/newsfeed) |
| Subscrição Premium | Não | Subscrições pela Stripe ou pagamento único, com o preço que definir. [Battlepass](/docs/battlepass#premium-membership) |
| Personalização do perfil | Sim | Fotos de perfil, molduras e fundos como recompensa. [Objetos colecionáveis e personalização](/docs/rewards/collectibles) |
| Avatares 3D e objetos equipáveis | Sim | Um complemento, que não está ativado em todas as aplicações. [Avatares 3D](/docs/rewards/avatars-3d) |
| Início de sessão com a Shopify | Não se aplica | Os fãs usam a conta que têm na sua loja. [Shopify](/docs/integrations/shopify) |
| Regras de recompensa da Shopify | Não se aplica | Recompense qualquer compra, compras com etiqueta ou cada unidade gasta. [Shopify](/docs/integrations/shopify#reward-rules) |
| Encomendas na Shopify a partir de compras na aplicação | Sim | Um artigo da loja comprado com pontos torna-se uma encomenda paga na sua Shopify, com a morada de entrega do fã. [Shopify](/docs/integrations/shopify#spending-points-back-into-shopify) |
| Anúncios no Discord | Não se aplica | Missões e eventos anunciados no seu servidor. [Discord](/docs/integrations/discord) |
| Data API | Não se aplica | Leia os dados da sua comunidade com uma chave de API. [Data API](/docs/integrations/data-api) |
| Estatísticas | Não se aplica | Membros, envolvimento e desempenho das missões. [Estatísticas](/docs/analytics) |
| Tema e navegação | Não se aplica | Cores, tipos de letra, fundos, modos claro e escuro, ordem e rótulos da navegação. [Definições](/docs/settings/general) |
| Idiomas | Sim | Cinco idiomas. Veja [Definições gerais](/docs/settings/general#languages). |
## Em desenvolvimento [#in-build]
| Funcionalidade | Observações |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Níveis de temporada | Um segundo conjunto de níveis que volta a zero a cada temporada do battlepass, ao lado dos níveis permanentes. Uma nova temporada vai colocar toda a gente no mesmo ponto de partida, sem apagar o nível que um fã antigo conquistou. |
| Um motivo em cada concessão manual | Conceder ou debitar moeda manualmente vai pedir um motivo e manter um histórico de quem fez o quê e porquê. [Membros](/docs/members#bulk-grants-and-debits) |
| Distribuição de códigos | Carregue um lote de códigos de desconto ou de oferta e distribua-os como recompensa, com entrega por e-mail. |
| Variantes e SKUs na loja | Tamanhos e cores nos artigos da loja, associados às variantes da Shopify. |
| Renovação do painel de administração | Uma revisão visual do painel de administração. Nenhuma mudança no funcionamento. |
| Blocos para a montra da Shopify | Missões, o perfil do fã, o avatar dele e um indicador de conta como blocos que adiciona ao seu tema da Shopify, sem código. A disponibilização começa pelas lojas-piloto. [Shopify](/docs/integrations/shopify#on-your-storefront) |
| Mais anúncios no Discord | Publicações do feed de notícias, alterações na loja e vencedores de eventos, a juntar aos anúncios de missões e de eventos que já existem. [Discord](/docs/integrations/discord) |
## Planeado [#planned]
Mais ou menos por ordem de prioridade. Nenhuma data é garantida até que a funcionalidade passe para Em desenvolvimento.
| Funcionalidade | Observações |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Selos de conquista | Marcos que o fã conquista e fixa no perfil, separados dos níveis. |
| Bónus de pontos e de XP | Multiplicadores por tempo limitado, vendidos na loja ou distribuídos através de missões. |
| Recompensas para transferir | Fundos de ecrã e pacotes de ficheiros entregues na reivindicação, sem depender de uma pessoa. |
| Redução ao longo do tempo | Recompensas que diminuem com o passar do tempo e mostram uma contagem decrescente, ao lado da redução por reivindicação que já está disponível. [Recompensas](/docs/rewards#decaying-rewards) |
| Calendário | O seu calendário de jogos e eventos dentro da aplicação. |
| Organização da loja | Arquivo de artigos, scroll infinito, compra em quantidade. |
| Criação de comunidade por conta própria | Registe-se, configure e receba as suas chaves sem depender de nós. |
| Mais modelos de missão | Primeiro a verificação de gostar e seguir no Instagram, depois mais modelos do Discord e da Twitch. [Modelos de missão](/docs/quests/templates#asking-for-a-template-or-a-game) |
## Em estudo [#exploring]
| Ideia | Observações |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Listagem na Shopify App Store | Instalar a FanBase diretamente a partir da Shopify. Hoje gerimos aplicações personalizadas da Shopify para cada loja, o que funciona bem com o volume atual. |
| Um assistente no painel de administração | Pedir uma missão ou um relatório em linguagem corrente em vez de preencher um formulário. |
| Webhooks | Enviar eventos para os seus sistemas no momento em que acontecem, em vez de ter de consultar a Data API periodicamente. |
| Histórico de classificação por temporada | Manter as temporadas passadas depois de uma redefinição de saldos, em vez de apenas a classificação atual. |
## Descontinuado [#retired]
Já não fazem parte do produto.
| Funcionalidade | O que aconteceu |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Widgets incorporáveis e iframes | Substituídos pelo SDK, que faz o mesmo trabalho sem uma aparência fixa e sem iframe. Veja [Como escolher uma integração](/docs/getting-started/integration-paths#widgets). |
| Emissão e queima on-chain de objetos colecionáveis | Descontinuadas em meados de 2026, quando o fornecedor responsável cessou a atividade. Nada do que um fã possuía se perdeu: os objetos colecionáveis continuam a ser ganhos, detidos, apresentados e utilizáveis como requisitos de missão, guardados na sua comunidade, e não numa blockchain. Nenhuma definição os volta a colocar numa blockchain, e não existe um marketplace fora da aplicação. A associação de carteira, o início de sessão com carteira e as missões on-chain não foram afetados. Veja [Missões on-chain](/docs/quests/templates/on-chain). |
| Páginas de link na bio para criadores | Testadas e depois descontinuadas. |
| Verificação de subscrição e de gosto no YouTube | Retirada porque verificá-los exige muito mais acesso à conta do fã do que estamos dispostos a pedir. Os modelos de visita e de visualização mantêm-se. Veja [YouTube](/docs/quests/templates/social/youtube). |
## Pedir uma funcionalidade [#asking-for-something]
Diga ao seu contacto na FanBase que funcionalidades são importantes para si. Mantemos uma lista interna de prioridades, e são as necessidades dos parceiros que lhe dão forma, por isso dizer-nos de que está à espera é o que faz uma funcionalidade subir nela.
Isto vale também para tudo o que não esteja nesta página. Se tiver uma ideia, partilhe-a. Em geral a questão não é se algo pode ser desenvolvido, mas quando poderia de facto estar disponível, e saber que a quer é o que faz a ideia ganhar uma data.
# Loja (/pt/docs/store)
Se tem uma moeda gastável, dê aos fãs um sítio onde a gastar. Em cerca de uma semana os fãs percebem se o saldo deles compra alguma coisa. Tudo nesta página é configurado no painel de administração.
## Artigos que pode oferecer [#items-you-can-list]
| Artigo | O que o fã recebe |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| Prémios e recompensas personalizadas | Algo de fora da aplicação: um vale-oferta, um código, um produto oficial, um bilhete. A reivindicação é igual à de um prémio de missão |
| Objetos colecionáveis | Um objeto que passa a ser dele |
| Objetos de personalização | Uma foto de perfil, uma moldura ou um fundo que pode equipar |
| Loot boxes | Uma hipótese de ganhar o que estiver lá dentro |
Cada tipo está descrito em [Recompensas](/docs/rewards). A loja acrescenta um segundo caminho para os mesmos artigos: ganhá-los ou comprá-los.
## Preços [#pricing]
Os artigos têm preço na sua moeda gastável, não em dinheiro. O valor de cada artigo é definido por si.
Defina os preços com base no que o fã ganha, e não no que o artigo lhe custa a si. Calcule mais ou menos quanto ganha um fã ativo numa semana e depois decida quantas semanas deve demorar o artigo mais barato. Se tudo na prateleira estiver a um mês de distância, os fãs deixam de abrir a loja. Se tudo for acessível ao segundo dia, a prateleira está vazia ao terceiro e terá ensinado aos fãs que os pontos não valem nada.
Deixe uma folga no topo. Um artigo que quase ninguém consegue comprar dá aos fãs do topo da sua classificação um motivo para poupar.
## Requisitos de acesso [#gating]
Dois requisitos, e são cumulativos.
| Requisito | É cumprido quando o fã |
| ------------------- | ----------------------------------------------------------------------------------- |
| Nível | Alcançou um nível à sua escolha |
| Plano de subscrição | Está num plano pago. Veja [Subscrição Premium](/docs/battlepass#premium-membership) |
Um artigo bloqueado continua visível, com o motivo do bloqueio.
## Stock e quantidade limitada [#stock-and-limited-supply]
Defina uma quantidade e o artigo esgota-se. Os fãs podem filtrar a prateleira para ver só o que ainda está em stock.
Há dois pontos a planear antes de oferecer algo escasso. Decida se prefere que vá para o fã mais rápido ou para o mais dedicado, porque stock ilimitado com um requisito de nível dá um resultado diferente de stock limitado sem requisito. E verifique a sua logística de entrega: cinquenta artigos físicos vendidos numa manhã são cinquenta moradas para alguém da sua equipa tratar.
## Limites de compra [#purchase-limits]
O stock limita quantas unidades de um artigo existem. Um limite de compra limita quantas pode comprar um mesmo fã.
Em cada artigo da loja, **Purchase limit per cohort** (limite de compra por grupo) recebe um número por plano de subscrição: um para os fãs do plano gratuito, um para os fãs Premium.
| O que indica | O que acontece |
| ------------ | ---------------------------------------------------------------------- |
| Um número | Um fã desse plano pode comprar o artigo esse número de vezes, no total |
| Nada | Sem limite para esse plano |
O limite vale para todo o tempo do fã na comunidade. Não volta a zero a cada mês nem a cada temporada, por isso um limite de um significa um.
Os fãs veem o limite no artigo: «Limite: 2 por utilizador», ao lado do que o outro plano recebe. Depois de o fã esgotar o limite dele, o artigo mostra «Limite de compra atingido» e já não pode ser comprado.
Serve para três coisas:
* **Um drop justo.** Cinquenta camisolas autografadas e um limite de um significam que cinquenta fãs recebem uma, ao passo que sem limite os três primeiros fãs levam todas
* **Um motivo para mudar para o plano Premium.** Os fãs do plano gratuito podem comprar uma unidade, os fãs Premium podem comprar três. O artigo mostra os dois números, por isso um fã do plano gratuito vê o que ganha ao mudar de plano.
* **Proteger algo caro.** Um limite num artigo de valor elevado impede que um fã com um saldo grande leve tudo
Defina o limite antes de o artigo ficar online. Reduzir um limite depois não tira nada a um fã que já comprou mais.
## Etiquetas e filtros [#tags-and-filters]
Coloque etiquetas nos artigos e os fãs ganham filtros na entrada da loja. Vestuário, Digital, Patrocinador, Dia de jogo. Os fãs também podem ordenar e filtrar por preço e pelo que está em stock.
Crie as etiquetas pelo tipo de artigo, e não pelo assunto, tal como faz com as [missões](/docs/quests/tags). Seis etiquetas que o fã entende valem mais do que vinte que descrevem as suas categorias internas.
## Ordenação e o carrossel de destaques [#sorting-and-the-featured-carousel]
Os fãs podem ordenar por mais barato, mais caro e mais recente. A predefinição é a sua própria ordem: a prateleira é organizada por si no painel de administração e é isso que o fã vê primeiro.
Aproveite. A ordenação predefinida é o espaço mais valioso que tem, e se não lhe mexer, o que criou primeiro fica no topo.
Por cima da prateleira fica um **carrossel de destaques**. Cada diapositivo tem uma imagem de fundo, um título, uma descrição curta e um apelo à ação, e o carrossel roda sozinho. É o lugar certo para um drop, uma ativação de patrocinador ou aquele artigo que quer mesmo que os fãs comprem esta semana.
## Histórico de compras [#purchase-history]
Todas as compras ficam registadas, e os fãs podem ver as deles em Definições. O seu lado fica no painel de administração, junto com as reivindicações vindas de missões e eventos, por isso uma única lista mostra o que tem de entregar, quer o fã o tenha ganho quer o tenha comprado. Veja [Recompensas personalizadas](/docs/rewards/custom-rewards).
## Variantes e SKUs [#variants-and-skus]
Em desenvolvimento
Os tamanhos e as cores vão ficar num único artigo da loja, associados às variantes correspondentes do seu catálogo da Shopify. Hoje um tamanho M e um tamanho L são dois artigos, cada um com o seu próprio stock.
## Ligar a sua loja [#connecting-your-store]
A loja descrita acima funciona inteiramente na plataforma. Ao ligar a Shopify, fica ligada à loja que já tem, em dois sentidos independentes um do outro.
**As compras na sua Shopify rendem recompensas na aplicação.** Isto já está disponível. O fã compra algo na sua loja real e as regras de recompensa dão-lhe XP, moeda ou um objeto colecionável, sem ninguém no processo. Pode escolher se isto é acionado em produtos com etiqueta, em qualquer compra ou em proporção ao valor gasto.
**Gastar pontos na aplicação cria uma encomenda real na Shopify.** Isto também já está disponível. Ative **Fulfil via Shopify** (processar pela Shopify) num artigo da loja e escolha o produto e a variante que ele representa. Quando um fã o compra com pontos, aparece uma encomenda na sua Shopify, associada ao registo de cliente dele, já paga, com a morada de entrega que indicou. A sua loja precisa de ser autorizada mais uma vez para as encomendas antes da primeira.
Os dois sentidos estão detalhados campo a campo em [Shopify](/docs/integrations/shopify).
# Como escolher uma integração (/pt/docs/getting-started/integration-paths)
A plataforma é a mesma nos três casos. Os fãs, as missões, a verificação, as recompensas e o painel de administração não mudam. O que muda é quem é dono do front-end, e isso define a rapidez do seu lançamento e até onde pode levar o design.
## Aplicação alojada [#hosted-app]
Nós operamos a aplicação e servimo-la no seu domínio, e a configuração é feita por si no painel de administração, para que a aplicação fique com a sua imagem: logótipo, imagem de capa e imagens de fundo por página, uma cor de destaque presente em toda a interface, tipos de letra, arredondamento dos cantos e espaçamentos, as funcionalidades que aparecem na navegação e por que ordem, o nome de cada funcionalidade (as missões podem chamar-se desafios, por exemplo), modo claro ou escuro, e os idiomas disponibilizados. O layout de cada página e a forma dos componentes continuam a ser nossos, e um design system que tem de ser seguido à risca é o que leva um parceiro ao caminho seguinte. A configuração em si demora dias, de duas a quatro semanas quando se contam o conteúdo, os materiais gráficos e um plano de lançamento, e de dois a três meses em organizações maiores, com revisão jurídica e ecrãs de onboarding personalizados. É indicada para um hub de fãs que é um destino próprio, gerido por uma equipa de comunidade sem tempo de engenharia disponível.
## O seu próprio front-end [#your-own-front-end]
A interface é construída na sua própria base de código com o SDK da FanBase e alojada por si. Dois pacotes npm fornecem o cliente da API, a máquina de estados das missões, os textos de apresentação e componentes React sem estilos. Assim, tudo o que o fã vê fica nas suas próprias rotas e componentes, renderizado pelo seu design system, sem folha de estilos da FanBase e sem iframe. A verificação, a atribuição de recompensas e as regras sobre quando uma missão pode ser enviada continuam na plataforma, pelo que não precisa de reimplementar a verificação de que alguém seguiu realmente a conta. Uma primeira versão com início de sessão, uma lista de missões, um ecrã de detalhe e uma reivindicação demora cerca de um dia de trabalho de programação, ou mais ou menos uma hora se entregar os prompts do próprio SDK a um agente de programação e rever o diff. É indicado para criar envolvimento dentro de um site que já tem, para uma campanha que deve ficar numa única página, ou para qualquer equipa cujo design system não é negociável.
Toda a parte técnica está no site do SDK da FanBase. [Integrar no seu próprio site](/docs/getting-started/integration-paths) explica quando mudar e o que se mantém.
## Desenvolvimento à medida [#bespoke-build]
Nós concebemos e desenvolvemos a experiência consigo, na mesma plataforma, com uma equipa dedicada à sua conta. É indicado para organizações com diretrizes de marca próprias, processo de compras, requisitos de acessibilidade e um roadmap sobre o qual querem ter influência. Fale com o seu contacto na FanBase antes de concluir que este é o caminho certo, porque os dois anteriores cobrem a maioria dos casos com uma fração do esforço.
## Comparação [#comparing-them]
| O que muda | Aplicação alojada | O seu próprio front-end | Desenvolvimento à medida |
| ------------------------------------ | --------------------------------------------- | --------------------------------------------------------------------------- | ------------------------ |
| Quem escreve o front-end | Nós | A sua equipa | Nós, consigo |
| Engenharia necessária do seu lado | Nenhuma | Um programador, por pouco tempo | Nenhuma |
| Controlo do design | Tema personalizável | Total | Total |
| Tempo até ao primeiro lançamento | De dias a semanas, meses com revisão jurídica | De horas a dias | De semanas a meses |
| Fica no seu site atual | Não | Sim | Qualquer um dos dois |
| Painel de administração | Sim | Sim | Sim |
| Todas as funcionalidades disponíveis | Sim | As que estão nos pacotes, veja o [estado das funcionalidades](/docs/status) | Sim |
## Usar mais do que um [#running-more-than-one]
É possível, e é cada vez mais a resposta normal. Mantenha a aplicação alojada como hub de fãs e use o SDK para colocar três missões numa página de lançamento de produto ou num centro de jogos.
Mesma comunidade, mesmos fãs, um único registo de progresso. Um fã que inicia sessão em qualquer uma das superfícies é o mesmo fã, com os mesmos pontos.
## Widgets [#widgets]
Os widgets não fazem parte do produto. O SDK faz o mesmo trabalho sem um aspeto fixo e sem colocar um iframe entre si e os seus fãs.
Se tem um contrato mais antigo que menciona widgets, fale com o seu contacto na FanBase sobre a migração para o SDK.
# Estratégia de lançamento (/pt/docs/getting-started/launch-strategy)
A forma como lança importa mais do que a data de lançamento. As quatro abaixo combinam bem entre si, e o seu contacto na FanBase pode planear o calendário de conteúdos em torno das que escolher.
## Crie primeiro uma lista de espera [#build-a-waitlist-first]
Uma landing page com um formulário de registo, duas a quatro semanas antes. Mostra a dimensão do público antes de se comprometer com uma data de lançamento, e dá-lhe uma lista de e-mails. A própria espera faz a aplicação parecer algo por que vale a pena aparecer.
Publique a página cedo e divulgue-a em todos os sítios onde já está presente: redes sociais, newsletter, transmissões em direto, site. Ofereça a quem entra na lista de espera algo concreto por se ter registado cedo, e mantenha essas pessoas informadas durante a espera para que a lista não arrefeça.
A Team BDS reuniu mais de cinco mil registos na lista de espera ao divulgar a aplicação durante as transmissões em direto dos jogos e nas redes sociais.
## Acesso antecipado restrito [#gated-early-access]
Abra primeiro a um grupo pequeno, numa página de registo protegida por links de utilização única. Assim recebe feedback enquanto o público ainda é tolerante, e os seus fãs mais fiéis ficam com a sensação de terem chegado primeiro.
A maioria das equipas de esports e das comunidades de videojogos que lançámos escolheu este caminho. É a opção mais segura: fica a saber que missões precisam de um texto mais claro e que recompensas os fãs realmente querem enquanto estão cinquenta pessoas a ver, e não cinquenta mil.
Os fãs do acesso antecipado não são uma amostra representativa. São os seus fãs mais envolvidos e vão terminar num dia tudo o que publicar. Tenha uma segunda vaga de conteúdos pronta.
## Lance num momento importante [#launch-on-a-moment]
Associe o lançamento a algo que já está a atrair atenções. Um torneio, uma abertura de temporada, o anúncio de um plantel, um aniversário, um grande jogo.
A Team Liquid lançou durante a Race to World First e atraiu milhares de fãs em poucos dias ao apontar para a aplicação durante as suas transmissões em direto. Funcionou porque alguém com público disse aos fãs para lá irem, várias vezes, enquanto já estavam a assistir.
Um momento destes gera um pico. Tenha missões diárias e semanais publicadas para que as pessoas que chegam tenham um motivo para voltar na terça-feira.
## Traga parceiros e patrocinadores [#bring-partners-and-sponsors]
A sua aplicação é um espaço comercial. Os patrocinadores podem financiar recompensas, as marcas podem fornecer prémios, e ambos alargam o seu alcance para além do público que já tem.
| Caminho | O que traz |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ativações de patrocinadores | Missões com as duas marcas, produtos do patrocinador como recompensa, códigos de desconto para a loja dele. |
| Os seus jogadores e criadores | Um jogador profissional a apontar para a aplicação durante uma transmissão em direto converte melhor do que qualquer publicação que venha a escrever. Dê-lhes um motivo: uma missão sobre eles, uma recompensa que eles escolheram, uma classificação que lhes importa. |
| Outras comunidades | Divulgação cruzada com equipas, torneios e plataformas do seu ecossistema. |
A Ninjas in Pyjamas fez uma parceria com a Fila que deu objetos colecionáveis exclusivos da marca aos três mil primeiros fãs do acesso antecipado. Os registos aumentaram durante o período promocional, e a parceria abriu caminho a novas campanhas.
## Seja qual for a sua escolha [#whichever-you-pick]
* Tenha conteúdo suficiente para que um fã não consiga terminar tudo no primeiro dia, o que significa [de vinte a trinta missões](/docs/quests/designing-a-board#publish-twenty-to-thirty-at-launch)
* Tenha uma missão diária, para que exista um motivo para voltar
* Decida quem revê os envios de imagem e de texto, e com que rapidez
* Teste num telemóvel, porque a maioria dos seus fãs usa um
* Use [Redefinir saldos](/docs/rewards/resources#reset-balance) depois dos testes internos e antes da chegada dos fãs
* Tenha a segunda vaga de conteúdos pronta antes de a primeira sair
# Onboarding (/pt/docs/getting-started/onboarding)
Um lançamento demora de alguns dias a alguns meses. O trabalho na plataforma demora dias. Tudo o resto é conteúdo, materiais gráficos, revisão jurídica e decidir o que quer realmente que os fãs façam.
Um contacto dedicado da FanBase percorre consigo a sequência abaixo. Cada etapa indica qual dos lados é responsável por ela.
## Do que precisamos da sua parte [#what-we-need-from-you]
Reúna estes elementos cedo. Cada um deles já bloqueou um lançamento em algum momento.
| Do que precisamos | Detalhe |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Domínio | O endereço em que a aplicação fica, por exemplo `hub.yourclub.com`. Terá de adicionar um registo DNS indicado por nós. |
| Materiais de marca | Logótipo, imagem de capa, imagem de fundo, cor de destaque. Os tamanhos estão em [Definições gerais](/docs/settings/general). |
| Métodos de início de sessão | Quais de entre Google, Discord, X, Twitch e Shopify os fãs usam para entrar. |
| Domínio da loja Shopify | Se vai ligar uma loja, o endereço original `.myshopify.com`, não o seu domínio personalizado. |
| Idiomas | Quais dos idiomas disponíveis quer oferecer. |
| Base da classificação | XP ou missões concluídas. É definida quando criamos a sua comunidade, e mudá-la depois desloca fãs que conquistaram o seu lugar. Veja [Classificações](/docs/leaderboards). |
| Equipa de administração | Nomes e endereços de e-mail de todas as pessoas que precisam de acesso, e a função de que cada uma precisa. |
| Páginas legais | A sua política de privacidade e os seus termos de utilização, ou a decisão de usar os nossos. |
| Lista de fãs existente | Se vai migrar pessoas, um CSV. Peça-nos o formato antes de exportar. |
## O que lhe enviamos [#what-we-send-you]
| O que recebe | Detalhe |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| Acesso ao painel de administração | Primeiro numa sandbox, depois em produção. |
| Os identificadores da sua comunidade | O tenant (o id da sua organização na plataforma), o slug da comunidade e o id da aplicação. O seu programador precisa deles para o SDK. |
| Um ambiente de sandbox | Uma cópia completa da sua aplicação para estragar sem risco. |
| Link de instalação da Shopify | Se vai ligar uma loja. Expira ao fim de cerca de uma semana, por isso use-o assim que chegar. |
| Chave da Data API | A pedido, para trazer os dados da sua comunidade para os seus próprios sistemas. Veja [Data API](/docs/integrations/data-api). |
## As etapas [#the-steps]
### Reunião inicial e demonstração do painel [#kickoff-and-a-panel-demo]
Uma demonstração da plataforma e, em seguida, o painel de administração aberto diante da sua equipa. Traga as pessoas que o vão operar no dia a dia, não apenas quem assinou o contrato. As equipas que lançam bem são aquelas em que o community manager já criou dez missões antes do dia do lançamento.
Aqui acordamos os marcos e uma data-alvo de lançamento.
### Nós criamos a sua comunidade [#we-build-your-community]
Criamos a sua comunidade e a respetiva configuração. Ligamos os seus fornecedores de início de sessão. Entregamos-lhe uma sandbox.
Hoje esta é uma configuração manual do nosso lado, por isso reserve alguns dias e avise-nos cedo se o domínio for invulgar. A criação por conta própria está planeada. Veja o [estado das funcionalidades](/docs/status).
### A sua equipa configura e preenche [#you-configure-and-fill-it]
A parte que demora realmente tempo, e a parte que só a sua equipa pode fazer.
Defina a sua identidade visual e a navegação. Decida a sua economia: como se chama o XP, se vai usar uma moeda gastável e o que significa um nível. Crie as suas primeiras missões. Adicione-lhes etiquetas. Configure as suas recompensas. Abasteça a loja. Escreva os textos que os fãs leem.
Tenha como objetivo [vinte a trinta missões no lançamento](/docs/quests/designing-a-board#publish-twenty-to-thirty-at-launch), com dificuldades variadas.
### Ligue o que já utiliza [#connect-what-you-already-run]
[Shopify](/docs/integrations/shopify), para que as compras rendam pontos e os pontos valham alguma coisa. [Discord](/docs/integrations/discord), para que as missões e os eventos se anunciem sozinhos. [Google Analytics ou Tag Manager](/docs/analytics#web-analytics), para que os registos possam ser atribuídos à campanha que pagou por eles.
### Teste e depois redefina [#test-then-reset]
Nós testamos em produção antes de alguém ser convidado. Deve testar também, com a sua própria equipa, num telemóvel e num portátil, no modo claro e no escuro se oferecer os dois.
Depois, apague os saldos criados pelos seus testes, antes da chegada dos fãs e não depois. Veja [Redefinir saldos](/docs/rewards/resources#reset-balance).
### Lançamento [#launch]
Acesso antecipado restrito ou lançamento público. [Estratégia de lançamento](/docs/getting-started/launch-strategy) apresenta as opções e quais já deram resultado.
Monitorizamos a plataforma durante todo o dia do lançamento e podemos divulgá-lo em conjunto consigo.
### Depois do lançamento [#after-launch]
O seu contacto na FanBase continua na conta. A maioria dos parceiros mantém uma chamada regular para ideias de conteúdo e planeamento de campanhas, porque um fluxo constante de novas missões e publicações é o que faz os fãs voltarem.
## Prazos [#timelines]
Números honestos, de lançamentos reais e não do melhor cenário.
| Fase | Duração |
| ------------------------------------------------------------------------------------ | --------------------- |
| Configuração da plataforma do nosso lado | De um a três dias |
| Configuração e conteúdo do seu lado | De uma a três semanas |
| Um clube com ecrãs de onboarding personalizados, revisão jurídica e migração de loja | De dois a três meses |
| Uma comunidade sem trabalho à medida, que reaproveita uma configuração existente | Menos de um dia |
A variável quase nunca é o software. São os materiais gráficos, as aprovações e a decisão sobre o que uma missão deve recompensar.
## Se está a construir o seu próprio front-end [#if-you-are-building-your-own-front-end]
As etapas um, dois, quatro e sete são as mesmas. A configuração da aplicação é dispensada, e o seu programador assume depois da etapa dois com os identificadores que enviamos.
Indique-lhe o guia de início rápido do SDK da FanBase. As missões continuam a ser criadas no painel de administração, por isso a sua equipa de comunidade continua a precisar da etapa três.
# Quanto custa (/pt/docs/getting-started/pricing)
O preço é orçamentado caso a caso, porque os três caminhos de integração representam volumes de trabalho muito diferentes do nosso lado. A base e os complementos estão abaixo, para que o orçamento chegue sem surpresas.
Para ter um número, [marque uma chamada](https://calendly.com/gauthier-/meet). Uma aplicação alojada padrão pode normalmente ser orçamentada logo nessa primeira chamada.
## Incluído em todos os planos [#included-in-every-plan]
| Incluído | O que cobre |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A plataforma | Todas as funcionalidades de envolvimento desta documentação. Missões, eventos, classificações, recompensas, loot boxes, battlepass, loja, feed de notícias e a biblioteca completa de modelos. As funcionalidades chegam a todos assim que são lançadas, sem custos adicionais. |
| O painel de administração | Missões e eventos ilimitados, toda a sua equipa como administradores, acesso por função, estatísticas e exportação de dados. |
| Alojamento e operação | Infraestrutura, domínio personalizado, certificados, monitorização e atualizações. Nada para implementar e nada para corrigir. |
| Suporte | Um contacto dedicado, monitorização com correções priorizadas por gravidade e um canal no Discord ou no Slack com a nossa equipa. |
| A parceria | Apoio no onboarding e no lançamento, estratégia de conteúdos, ideias de missões e planeamento de campanhas. Os parceiros que tiram partido disto têm números melhores do que os que não o fazem. |
## As variáveis de um orçamento [#the-variables-in-a-quote]
| Variável | Como afeta o preço |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Caminho de integração | A aplicação alojada é a base. Com o seu próprio front-end, o esforço passa para o seu lado e o preço acompanha. O desenvolvimento à medida é um projeto de desenvolvimento. |
| Dimensão da comunidade | A cobrança é por fãs ativos, e não por seguidores ou registos. |
| Prazo do contrato | Prazos mais longos têm melhor preço. Há contratos curtos, de campanha, que não exigem um compromisso de vários anos. |
| Complementos | A lista abaixo. |
Vale a pena perguntar pelos contratos curtos. Um único torneio, um drop de produto ou uma campanha de verão não precisa de um contrato anual, e o SDK tornou isso barato o suficiente para o podermos oferecer.
## Complementos [#add-ons]
Cobrados à parte porque nem todos os querem.
| Complemento | O que cobre |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Avatares 3D e objetos equipáveis | Um avatar de fã que coleciona objetos da marca, desbloqueados através de missões, eventos e loot boxes. Há um avatar padrão e a opção de uma personagem personalizada, criada para si. Os objetos equipáveis são produzidos pela nossa equipa de 3D a um ritmo mensal. Os termos de propriedade intelectual são diferentes para o avatar padrão e para um personalizado, por isso peça tudo por escrito. |
| Design e criação | Fluxos de onboarding personalizados, ecrãs à medida e materiais gráficos da marca para além da configuração padrão. |
| Gestão de comunidade | Planeamento do calendário de conteúdos, criação de campanhas e relatórios, feitos com a sua equipa. |
| Migração | Importação de uma base de fãs existente com os saldos. |
Os avatares e os objetos equipáveis são um complemento e não estão ativados em todas as aplicações. Antes de construir uma temporada em torno deles, confirme com o seu contacto na FanBase se cabem no seu plano e no seu calendário.
## Receita gerada com os fãs [#fan-facing-revenue]
Separada do que nos paga, e fica consigo.
Pode vender uma subscrição Premium dentro da sua aplicação através da Stripe, como subscrição recorrente ou pagamento único, na sua moeda e ao seu ritmo. Os fãs Premium podem ter missões exclusivas, recompensas melhores, publicações com requisitos de acesso e um selo. O preço e os benefícios são definidos por si. Veja [Subscrição Premium](/docs/battlepass#premium-membership).
Ligar a sua loja é o outro lado disto. Os fãs ganham pontos ao comprar e gastam pontos em coisas que valem a pena, e esse ciclo paga-se a si próprio. Veja [Shopify](/docs/integrations/shopify).
{/* Oculto, a aguardar uma decisão sobre a permanência desta secção.
## Perguntas frequentes [#common-questions]
Para uma aplicação alojada padrão, não. Os desenvolvimentos à medida e as migrações são orçamentados como projetos.
A dimensão da comunidade é um fator do orçamento, não um contador que traz surpresas. Pergunte ao seu contacto na FanBase onde ficam os escalões do seu plano.
A solução é passar para o seu próprio front-end com o SDK. A comunidade, os fãs, o progresso deles e o painel de administração mantêm-se. Só muda o front-end, por isso é um projeto e não uma migração.
Sim. Exporte os seus membros e a respetiva atividade pelo painel de administração em qualquer altura, ou obtenha tudo de forma contínua com a [Data API](/docs/integrations/data-api).
Os prazos variam. Os contratos de vários anos não são obrigatórios, e existem contratos com a duração de uma campanha. Peça o prazo mais curto que sirva para o que realmente quer comprovar.
*/}
# Agentes e ferramentas de IA (/pt/docs/integrations/agents)
Cada página deste site tem uma versão gémea em Markdown, porque boa parte do tráfego aqui não é humana.
## Esta documentação, lida por uma máquina [#these-docs-read-by-a-machine]
Quatro formas de acesso, todas geradas no momento do build, e nenhuma delas é um produto separado.
[/llms.txt](/llms.txt) é um índice de todas as páginas com as respetivas descrições, suficientemente pequeno para colar num prompt. [/llms-full.txt](/llms-full.txt) é o site inteiro num único ficheiro Markdown, e é esse que se entrega a um agente.
As outras duas servem para chegar a uma única página. O código-fonte de cada página fica em `/llms.mdx/docs//content.md`, e o cabeçalho de cada página tem um botão **Copy Markdown** que o vai buscar. Peça qualquer URL da documentação com um cabeçalho `Accept: text/markdown` e recebe o Markdown em vez de uma página HTML de onde extrair o conteúdo.
A documentação antiga servia Markdown em todas as páginas, e os agentes dos parceiros passaram a depender disso. É por isso que continua a funcionar aqui.
## Utilizações atuais [#uses-today]
As dúvidas de configuração são respondidas sem que ninguém leia o site. Aponte o Claude, o Cursor ou o Codex para `/llms-full.txt` e faça a pergunta que nos faria a nós. Como configuro uma missão diária com um teto de sequência, o que faz realmente «oculta se bloqueada», que modelos exigem primeiro uma conta associada. As respostas estão todas lá.
Os relatórios chegam sem que a sua equipa precise de os montar. Entregue a um agente a referência da [Data API](/docs/integrations/data-api) e uma chave, e depois peça o que realmente quer. Os fãs que concluíram uma missão no mês passado mas não abriram a aplicação desde então, em CSV. Ele escreve as chamadas, pagina os resultados e entrega o ficheiro. Não precisa de nada da nossa parte.
Ambos são trabalho só de leitura do seu lado, e nenhum exige que uma funcionalidade seja desenvolvida primeiro.
## Construir a experiência do fã com um agente [#building-the-fan-experience-with-an-agent]
Se está a colocar a FanBase dentro do seu próprio produto em vez de usar a aplicação alojada, o caminho por agente é a forma prevista de instalar o SDK. Os pacotes trazem os ficheiros que um agente lê, um prompt inicial e uma skill de agente compacta, de modo que o material de referência chega ao repositório juntamente com o código.
Cole dois prompts, e a ordem importa: primeiro o início de sessão, depois as missões. Combinar os dois gera algo que parece pronto e tem um início de sessão simulado. Integrar com um agente traz os dois prompts e a lista do que vale a pena verificar manualmente depois.
## Um assistente no painel de administração [#an-assistant-in-the-admin-panel]
Em estudo
A ideia é pedir o que quer em vez de preencher o formulário. Crie uma missão diária que vale cinquenta XP com um teto de sequência, e ele prepararia um rascunho para aprovar. Mostre as conclusões de missões por etiqueta no mês passado, e ele geraria o relatório.
Está em discussão, ainda sem data. Se isto mudasse a forma de trabalhar da sua equipa, avise o seu contacto na FanBase: saber que um parceiro o quer é o que faz a ideia ganhar uma data.
## Os agentes ligam-se através da leitura de ficheiros, não por MCP [#agents-connect-by-reading-files-not-by-mcp]
Não há MCP para esta plataforma hoje. Um agente que afirme o contrário está a adivinhar, e não há nada para instalar nem para ligar.
O padrão suportado é dar ao agente ficheiros para ler e uma chave de API quando precisar dela. Funciona com qualquer ferramenta capaz de ler um ficheiro.
# Data API (/pt/docs/integrations/data-api)
Acesso HTTP só de leitura aos membros, à atividade, aos saldos e aos objetos detidos da sua própria comunidade, autenticado por uma chave. Nunca toca na experiência do fã.
## Âmbito e primeiras utilizações [#scope-and-first-uses]
As três coisas que os parceiros construíram primeiro com ela:
* Um segmento de CRM. Os membros e os respetivos saldos cruzados com a lista de e-mails, para que uma campanha vá para os fãs acima do nível dez e não para toda a gente.
* Uma tabela no data warehouse. Um carregamento noturno de membros e atividade no mesmo sítio onde os dados da loja já chegam, para que o envolvimento na aplicação e a receita possam ser vistos numa única consulta.
* Um dashboard que a sua direção já lê. Os totais principais na ferramenta de BI que mostra todos os outros números, em vez de mais um início de sessão para mais um painel.
## Como obter uma chave [#getting-a-key]
Peça uma chave ao seu contacto na FanBase.
É apresentada uma única vez, na criação, e nunca mais. Guarde-a diretamente num gestor de palavras-passe ou no seu cofre de segredos. Se se perder, a solução é uma chave nova.
Uma chave pode ter data de expiração. Peça uma para tudo o que for de curta duração, como a integração de um prestador de serviços ou uma migração pontual. Uma chave sem expiração é uma chave que dura mais do que a pessoa que a pediu.
Avise-nos quando uma chave deve deixar de funcionar e nós revogamo-la.
Esta é uma API de servidor para servidor. A chave nunca deve ir para um navegador, uma aplicação móvel, um build de front-end ou qualquer outra coisa que um fã possa ler. A chave lê a sua comunidade inteira, e um fã que a encontre também o pode fazer. Coloque a chave num servidor, numa tarefa agendada ou no conector do seu data warehouse.
Se o que está a construir se destina aos fãs, use o SDK. Autentica-se como o fã e devolve apenas os dados desse fã. Veja a referência da API do SDK da FanBase.
## Como chamar [#calling-it]
Envie a chave num cabeçalho `x-api-key`. O URL 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"
```
Sem fluxo de OAuth e sem renovação de token.
## Recursos que pode ler [#resources-you-can-read]
| Recurso | Para que serve |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Membros | Uma linha por fã da sua comunidade. A chave de junção para tudo o resto aqui, e a tabela sobre a qual o seu CRM segmenta. |
| Eliminações de membros | Fãs que eliminaram a conta. É a única forma de respeitar uma eliminação também nos seus próprios sistemas, porque um fã eliminado deixa de aparecer em membros, e na exportação de membros, sem nada que assinale a ausência. |
| Atividade | O que os fãs fizeram e quando. O registo de eventos por trás de cada número do dashboard, e a fonte para análises de retenção e de coortes. |
| Saldos de recursos | Um saldo por fã e por recurso, ou seja, o XP e cada moeda gastável que a sua comunidade criou. É o que se usa para segmentar quando quer os seus mil melhores fãs e não todos. |
| Objetos detidos | Que objetos colecionáveis e objetos de inventário cada fã detém. Útil para verificar quem tem realmente o objeto em torno do qual uma campanha foi criada. |
| Aberturas de loot boxes | Cada abertura e o que saiu dela. Serve para reconciliação e para responder ao fã que diz que as probabilidades estão erradas. |
| Totais de estatísticas | Contagens gerais de toda a comunidade, entre elas `totalMembers` e `totalQuestsCompleted`. O conjunto completo está na [referência](https://api.gamerbase.gg/api). É a chamada barata para um painel de acompanhamento que não precisa de linhas por fã. |
| Catálogo de missões | As suas missões publicadas. É público, e a única parte que não exige chave nenhuma. |
## Paginação e sincronização [#paging-and-syncing]
Todas as respostas de lista têm o mesmo formato: `data` traz as linhas, `total` traz quantas linhas correspondem no total, e `offset` indica onde começa a página que tem em mãos. A paginação faz-se com `limit` e `offset`. O máximo atual de `limit` está na [referência](https://api.gamerbase.gg/api), que é gerada a partir da API e é o valor a usar no seu código.
Use `updatedSince`. Passe um timestamp e recebe de volta apenas as linhas que mudaram depois dele. A sua primeira execução traz a comunidade inteira. Cada execução seguinte traz as poucas linhas que mudaram desde a anterior.
Dois pontos a acertar ao construir este ciclo.
Guarde a hora a que a execução começou. Podem ser gravadas linhas enquanto pagina, pelo que um cursor definido na última linha que viu as deixa para trás. Tome como âncora o início da execução, sobreponha a execução seguinte em alguns minutos, e uma linha gravada a meio da sincronização continuará a ser apanhada. Grave as suas linhas de modo que ver a mesma duas vezes seja inofensivo, e a sobreposição não custa nada.
Leia as eliminações de membros com a mesma frequência que os membros. Um fã eliminado deixa de aparecer em membros, e uma sincronização incremental baseada apenas em `updatedSince` não tem como dar por uma ausência. Mantém a linha desatualizada no seu CRM para sempre e continua a enviar e-mails a alguém que pediu para ser esquecido. As eliminações são um recurso separado precisamente para que as possa ir buscar e agir.
## Limites de pedidos [#rate-limits]
O limite é por minuto e por chave, e é suficientemente alto para que uma sincronização incremental bem construída nunca se aproxime dele. Todas as respostas trazem cabeçalhos `X-RateLimit-*` com os números em tempo real, e esses cabeçalhos são a referência oficial. Um cliente que os lê e abranda o ritmo quando a contagem restante fica baixa mantém-se dentro do limite sem nenhum ajuste da sua parte.
Se está a atingir o limite, a causa é quase sempre uma nova transferência completa agendada.
## A referência interativa [#the-interactive-reference]
Cada endpoint, cada parâmetro e cada formato de resposta está em [api.gamerbase.gg/api](https://api.gamerbase.gg/api), e pode chamá-los a partir da própria página com a sua chave. É gerada a partir da API, por isso mostra o formato atual e não uma cópia. Indique-a primeiro aos seus engenheiros e ao seu agente de programação.
## Webhooks [#webhooks]
Em estudo
Hoje a API é consultada periodicamente. Os webhooks inverteriam isso: registaria um URL, e a plataforma enviar-lhe-ia um pedido quando algo acontecesse, de modo que a conclusão de uma missão poderia chegar ao seu CRM em segundos, e não na sincronização seguinte.
Está em discussão, ainda sem data. Se a sua campanha depende de uma reação em tempo real, avise o seu contacto na FanBase: saber que um parceiro precisa disso é o que faz a ideia ganhar uma data.
# Discord (/pt/docs/integrations/discord)
Cinco funcionalidades diferentes levam o nome Discord, e ativar uma não ativa as outras.
| O que quer | O que é de facto | Onde é configurado |
| ------------------------------------------------------------------- | --------------------------------- | ----------------------------------------------------------- |
| Os fãs iniciam sessão com a conta do Discord | Um fornecedor de início de sessão | Por comunidade, por nós |
| Os fãs associam o Discord a uma conta que já têm | Associação de conta | Por comunidade, por nós |
| O seu servidor recebe uma mensagem quando publica algo | O bot da FanBase | **Settings**, depois **Automation** |
| Uma missão que verifica se um fã entrou no servidor ou tem um cargo | Dois modelos de missão | [Missões do Discord](/docs/quests/templates/social/discord) |
| Um cargo do Discord concedido por concluir algo | Um tipo de recompensa | [Recompensas](/docs/rewards) |
## Início de sessão e associação de conta [#sign-in-and-account-linking]
São duas coisas diferentes, configuradas de forma independente.
**O início de sessão** é o Discord como porta de entrada da sua aplicação. O fã toca em **Continuar com o Discord** e já está dentro, sem palavra-passe separada. Fica ao lado de Google, X, Twitch e Shopify, e pode escolher quais aparecem.
**A associação de conta** é um fã que já iniciou sessão a associar a conta do Discord depois, a partir do perfil. Vem ativada por predefinição, porque um fã que iniciou sessão com o Google continua a precisar de uma conta do Discord associada antes que qualquer missão do Discord possa ser verificada.
A associação é a que importa para as missões. Um fã que iniciou sessão com o Discord fica associado automaticamente, mas um fã que iniciou sessão de outra forma não fica, e as missões do Discord dele ficam bloqueadas até que associe a conta. O cartão trata disso sozinho. Veja [Modelos que exigem uma conta associada](/docs/quests/templates#templates-that-need-a-linked-account).
Diga ao seu contacto na FanBase que métodos de início de sessão quer e se a associação do Discord deve ficar disponível: é uma alteração de configuração, não um desenvolvimento. [Início de sessão](/docs/settings/sign-in) traz a lista completa.
Os nomes de utilizador na aplicação têm o formato `name#1234`. É um nome de utilizador da FanBase com um formato parecido com o do Discord, e não tem relação com a conta do Discord do fã.
## Anúncios no seu servidor [#announcements-in-your-server]
O bot publica num canal do seu servidor quando algo acontece na aplicação. O anúncio sai, quer alguém da sua equipa se lembre de escrever um, quer não.
| Gatilho | O que o servidor vê |
| ---------------------- | ------------------------------------------------------- |
| Uma missão é publicada | Uma mensagem com a missão e um link para chegar até ela |
| Um evento começa | Uma mensagem quando o evento abre |
| Um evento termina | Uma mensagem quando encerra |
Cada tipo de notificação tem o seu próprio interruptor, por isso pode anunciar as missões e ficar em silêncio sobre tudo o resto. Vêm aí mais tipos: publicações do feed de notícias, alterações na loja e vencedores de eventos são os que estão a ser desenvolvidos. Em desenvolvimento
### Como configurar [#setting-it-up]
### Coloque o bot no seu servidor [#get-the-bot-into-your-server]
Vá a **Settings**, depois **Automation**. Prima **Connect** no cartão do Discord. O Discord pede que escolha o servidor e aprove o bot, e depois encaminha de volta para o painel de administração.
Quem clicar precisa da permissão **Manage Server** (Gerir servidor) nesse servidor do Discord, por isso garanta que essa pessoa está presente antes de começar. Se o cartão já oferece **Disconnect**, o bot está instalado e pode saltar esta etapa.
### Escolha o canal [#choose-the-channel]
Indique o ID do canal em que quer receber as mensagens. Vale a pena criar um canal dedicado: num chat geral movimentado, os anúncios desaparecem em minutos.
### Escolha um cargo para mencionar, ou nenhum [#choose-a-role-to-mention-or-none]
Opcional. Escolha um cargo e todas as mensagens o mencionam. Deixe em branco e a mensagem não notifica ninguém.
Mencionar toda a gente a cada missão é a forma de um servidor aprender a silenciar o seu canal de anúncios. Se quer uma menção, crie um cargo opcional para os fãs que a pediram.
### Ative as notificações que quer [#turn-on-the-notifications-you-want]
Ative uma de cada vez e deixe as outras desativadas. Pode voltar e adicionar mais quando souber qual é o volume.
### Publique algo e observe o canal [#publish-something-and-watch-the-channel]
O único teste a sério.
### Como obter os IDs [#getting-the-ids]
Os dois IDs ficam atrás do modo de programador do Discord, que [Como encontrar os IDs](/docs/quests/templates/social/discord#finding-the-ids) ensina a ativar.
| ID necessário | Como obter |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID do canal | Clique com o botão direito no canal na lista de canais e depois em **Copy Channel ID** (Copiar ID do canal) |
| ID do cargo | Clique com o botão direito no cargo em **Server Settings** (Definições do servidor), depois **Roles**, e em **Copy Role ID** (Copiar ID do cargo) |
Confirme que o cargo do bot pode ver o canal e enviar mensagens nele. Um canal em que o bot não consegue publicar tem exatamente o mesmo aspeto de um bot que não funciona, e é a primeira hipótese a descartar.
## O Discord como fonte de missões [#discord-as-a-source-of-quests]
Dois modelos leem o seu servidor em vez de escreverem nele.
**Join the server** (entrar no servidor) pede que o fã seja membro de um servidor indicado por si, e verifica isso. **Hold a role** (ter um cargo) pede um cargo específico e também verifica, e é assim que se recompensa quem já conquistou algo no Discord.
Os dois exigem que a conta do Discord do fã esteja associada, e os dois exigem o ID do servidor. Todos os campos estão em [Missões do Discord](/docs/quests/templates/social/discord).
Um cargo do Discord também pode ser um requisito de acesso em vez de uma missão: pode ocultar uma missão, ou bloqueá-la, até que o fã tenha um cargo. Isso está em [Criar uma missão](/docs/quests/creating#set-the-advanced-properties).
## Um cargo do Discord como recompensa [#a-discord-role-as-a-reward]
O sentido inverso. Um fã conclui uma missão e o bot atribui-lhe um cargo no seu servidor, sem ninguém a meio do processo.
É isto que sustenta o padrão que a maioria dos parceiros quer: o nível dez na aplicação dá direito a uma cor no Discord. É preciso que o bot esteja ligado, e o cargo do próprio bot tem de ficar acima do cargo que ele atribui na lista de cargos do seu servidor. O Discord não deixa um bot conceder um cargo posicionado acima do dele. Verifique primeiro essa ordem se um cargo não estiver a ser atribuído.
Os tipos de recompensa que pode associar a uma missão estão em [Recompensas](/docs/rewards).
# Shopify (/pt/docs/integrations/shopify)
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 [#sign-in]
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 [#whose-account-a-customer-gets]
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 [#installing-it]
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` [#send-us-your-myshopifycom-domain]
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 [#we-whitelist-it-and-send-you-an-install-link]
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 [#log-in-to-the-admin-panel-before-you-click-it]
Abra [admin.gamerbase.gg/admin](https://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 [#approve-the-permissions-in-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 [#land-back-in-the-admin-panel]
É feito o redirecionamento de volta e a instalação termina sozinha. Nada mais para preencher.
### Verifique [#verify-it]
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 [#reward-rules]
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 [#tagged-purchase]
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 [#any-purchase]
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 [#amount-spent]
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 [#reward-types]
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](/docs/rewards) explica a diferença entre os tipos.
### Quando uma compra não rende nada [#when-a-purchase-pays-nothing]
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.
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 [#two-things-to-plan-for]
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 [#on-your-storefront]
Em desenvolvimento
As 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 [#spending-points-back-into-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 [#turning-it-on-for-an-item]
### Autorize a sua loja para encomendas [#authorise-your-store-for-orders]
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 [#switch-on-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 [#pick-the-product-and-variant]
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 [#save]
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 [#what-the-fan-does]
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 [#what-lands-in-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 [#following-an-order]
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 [#three-limits-to-plan-around]
* **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](/docs/store#variants-and-skus) 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](/docs/rewards/custom-rewards).
* **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](/docs/store#purchase-limits) em tudo o que for escasso, para que um fã com um saldo grande não leve tudo.
## Distribuição de códigos [#code-distribution]
Em desenvolvimento
Códigos de desconto e de oferta entregues como recompensa. Veja [Recompensas personalizadas](/docs/rewards/custom-rewards#code-distribution).
# Criar uma missão (/pt/docs/quests/creating)
Criar uma missão envolve sete decisões. Duas delas não podem ser alteradas depois de a missão ser guardada.
## O formulário, campo a campo [#the-form-field-by-field]
### Escolha um modelo [#choose-a-template]
O modelo é a verificação. Define o que a plataforma verifica antes de recompensar um fã, e é a primeira coisa que o formulário pede.
| Categoria | O que abrange | Campos |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ações | Visitar um link, alcançar um nível, ter um saldo, concluir outra missão, convidar um amigo, participar num evento | [Ações na aplicação](/docs/quests/templates/action) |
| Respostas e envios | Enviar uma imagem, escrever uma resposta, responder a um quiz ou a uma sondagem, fazer um prognóstico sobre um resultado, enviar um e-mail ou uma carteira | [Respostas e envios](/docs/quests/templates/submission) |
| Social | Seguir, gostar, republicar, verificar uma bio, entrar num servidor, ver uma transmissão em direto, seguir um 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, TikTok](/docs/quests/templates/social/meta), [Spotify](/docs/quests/templates/social/spotify) |
| Gaming | Vencer partidas, atingir uma posição no ranking, jogar durante horas, alcançar uma marca nas estatísticas | [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 | Ter um token ou um NFT, ou adquirir um | [On-chain](/docs/quests/templates/on-chain) |
O modelo não pode ser alterado depois de a missão ser guardada. Veja [Gerir missões](/docs/quests/managing#editable-and-locked-fields).
Cada modelo está descrito campo a campo em [Modelos de missão](/docs/quests/templates).
### Preencha os campos próprios do modelo [#fill-the-templates-own-fields]
Cada modelo pede aquilo de que precisa para verificar. Uma missão de visita a um link pede o URL. Um quiz pede as opções e a resposta correta. Uma missão de cargo do Discord pede o cargo. Uma missão de CS2 pede o número de eliminações.
O fornecedor tem de estar ativado para a sua comunidade, caso contrário os fãs conseguem abrir a missão e nunca a terminam. Veja [início de sessão e associação de contas](/docs/settings/sign-in). E o alvo tem de existir: uma publicação apagada leva a missão consigo.
### Defina as propriedades [#set-the-properties]
| Campo | O que faz |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Featured (destaque) | Fixa a missão no topo do quadro de missões. Use para a campanha que está a decorrer agora e retire o destaque da anterior. Cinco missões em destaque equivalem a nenhuma. |
| Tag (etiqueta) | A etiqueta que os fãs usam para filtrar, e a sua forma de agrupar uma campanha. Escolha uma etiqueta existente ou crie uma aqui. As missões sem etiqueta ficam em **Other** (outras). Veja [Etiquetas](/docs/quests/tags). |
| Ordering (ordem) | A posição da missão no quadro de missões: **First** (primeiro), **Last** (último) ou **Custom** (personalizado), que permite posicioná-la em relação às missões que já tem. |
### Defina as propriedades avançadas [#set-the-advanced-properties]
**End date.** A data de fim, ou seja, quando a missão fecha. Deixe em branco para uma missão permanente.
**Requirements.** Os requisitos: o que um fã já tem de ter para poder concluir a missão.
| Requisito | Cumprido quando o fã |
| ------------------------------------- | --------------------------------------------------------------------------------------------- |
| Level (nível) | Alcançou um nível definido por si |
| Discord role (cargo do Discord) | Tem um cargo no seu servidor. Exige que o [Discord](/docs/integrations/discord) esteja ligado |
| Collectible (objeto colecionável) | Possui um objeto específico |
| Another quest (outra missão) | Concluiu uma missão que indicar |
| Membership tier (plano de subscrição) | Tem um plano pago. Veja [Battlepass](/docs/battlepass#premium-membership) |
**Visibility.** A visibilidade, que é independente dos requisitos. Um requisito define se um fã pode concluir a missão; a visibilidade define se a pode ver.
| Visibilidade | O que o fã vê |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Visible (visível) | A missão, bloqueada ou não |
| Hidden (oculta) | Nada. A missão existe e pode ser acedida por link direto, e é assim que funciona um código QR num evento presencial |
| Hidden if locked (oculta se bloqueada) | Nada até cumprir o requisito, e então a missão aparece |
**Recurrence.** A recorrência: uma vez, diária ou semanal.
| Recorrência | O que acontece |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| Once (uma vez) | A predefinição. O fã conclui a missão uma única vez. |
| Daily (diária) | Renova-se todos os dias. O lugar habitual de uma recompensa pequena, simples e impossível de falhar. |
| Weekly (semanal) | Renova-se todas as semanas. Serve para tudo o que exige esforço a sério, como horas de jogo. |
Qualquer valor diferente de Once ativa as sequências, o que acrescenta dois campos. O **streak boost** (bónus de sequência) é quanto a recompensa cresce a cada conclusão consecutiva, e o **reward cap** (teto de recompensa) é o limite em que deixa de crescer. Se o fã falhar uma renovação, a sequência volta ao início.
Com um teto demasiado alto, um fã que não falha nenhum dia ganha mais com uma única missão diária do que com todo o seu quadro de missões. Com um teto demasiado baixo, o bónus é apenas decorativo. A página [Níveis](/docs/levels) explica onde o teto deve ficar em relação aos seus limiares de XP.
**Expiry.** A expiração, ou seja, como a missão fecha sozinha: **none** (nenhuma), por **date** (data) ou por **participants** (participantes). A expiração por participantes despublica a missão assim que um certo número de fãs a conclui, e é assim que se faz uma campanha para os cinquenta primeiros sem ter de vigiar o contador.
Conte o que um fã recém-chegado consegue ver antes de publicar um quadro cheio de missões em Hidden if locked. Essa opção faz o quadro abrir-se à medida que os fãs avançam, e um quadro formado quase só por essas missões parece vazio no primeiro dia.
### Escreva o conteúdo [#write-the-content]
| Campo | O que faz |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Language (idioma) | O idioma em que está a escrever esta versão. Adicione uma versão para cada idioma que oferece, caso contrário os fãs desse idioma veem a versão predefinida. |
| Title (título) | A linha que aparece no cartão. Diga a ação: «Siga a equipa no X», e não «Missão social 4». |
| Description (descrição) | Como concluir a missão, pela ordem em que o fã o faz. Quando este campo é vago, é dele que vêm os pedidos de suporte. |
| Image (imagem) | A arte da missão. Opcional, e vale a pena em tudo o que está em destaque ou ligado a uma campanha. Um quadro com trinta linhas de texto é difícil de percorrer. |
### Escolha as recompensas [#choose-the-rewards]
| Recompensa | O que o fã recebe |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| XP | Progresso rumo ao nível seguinte e um lugar na classificação |
| Spendable currency (moeda gastável) | Saldo para gastar na loja |
| Prize (prémio) | Uma recompensa personalizada que sai da aplicação: produtos oficiais, um vale-oferta, uma experiência. Veja [Recompensas personalizadas](/docs/rewards/custom-rewards) |
| Collectible (objeto colecionável) | Uma foto de perfil, uma moldura, um fundo ou um objeto equipável. Veja [Objetos colecionáveis e personalização](/docs/rewards/collectibles) |
| Loot box | Uma caixa que o fã abre para receber um objeto aleatório |
| Discord role (cargo do Discord) | Um cargo atribuído automaticamente no seu servidor |
Pode associar várias recompensas à mesma missão, pelo que o fecho de uma campanha pode pagar XP, moeda e um objeto colecionável em conjunto.
**Decay** (redução progressiva) faz a recompensa diminuir à medida que os fãs a reivindicam. Define o valor inicial, quanto desce a cada reivindicação e um valor mínimo abaixo do qual nunca desce. Isto recompensa a rapidez, e não o volume. Use num lançamento ou numa ação de dia de jogo, e não numa missão que dura a temporada inteira.
A recompensa não pode ser alterada depois de a missão ser guardada. Veja [Gerir missões](/docs/quests/managing#editable-and-locked-fields).
### Publique, agende, guarde como rascunho ou arquive [#publish-schedule-draft-or-archive]
| Ação | O que acontece |
| ------------------------------------- | -------------------------------------------------- |
| Publish (publicar) | A missão aparece de imediato no quadro de missões. |
| Schedule (agendar) | É publicada na data que escolher. |
| Save as draft (guardar como rascunho) | Fica no painel de administração e nenhum fã a vê. |
| Archive (arquivar) | Fecha a missão e retira-a da lista. |
**Fusos horários.** O painel de administração lê o relógio do seu computador e guarda tudo em UTC. Uma missão agendada é publicada no início do dia escolhido, na sua hora local, seja qual for a hora indicada no formulário. Se a sua comunidade estiver noutro fuso, agende pelo fuso dela: uma missão marcada para sábado na Europa chega às Américas na sexta-feira à noite.
## Missões em várias etapas [#multi-step-quests]
Várias etapas dentro de um único cartão, com uma só recompensa no final. O fã vê todas as etapas desde o início e avança pela lista de cima para baixo.
Construa-a como uma única missão com etapas, e não como uma cadeia de missões escondidas umas atrás das outras. A cadeia funcionava, mas os fãs abandonavam-na no quarto elo porque não conseguiam ver quanto faltava.
Use para tudo o que, na cabeça do fã, é uma só tarefa. Associar as contas, depois seguir, depois entrar no servidor. Ver o jogo, depois fazer um prognóstico sobre o seguinte, depois publicar sobre ele.
# Planear um quadro de missões (/pt/docs/quests/designing-a-board)
Qualquer missão se resume a três decisões: o que pede, como a plataforma comprova que aconteceu e o que o fã recebe. A primeira e a terceira são suas. Esta página trata do quadro que todas elas formam em conjunto.
## Doseie a dificuldade [#mix-the-difficulty]
Cerca de metade do quadro deve poder ser concluída em menos de um minuto, um terço deve exigir esforço a sério e umas poucas missões devem ser mesmo difíceis. Os quadros só com missões fáceis são concluídos e abandonados numa tarde. Os quadros só com missões difíceis parecem trabalhos de casa.
## Publique de vinte a trinta missões no lançamento [#publish-twenty-to-thirty-at-launch]
Um quadro de lançamento com quatro missões parece vazio ao segundo dia, e não há forma de recuperar os fãs que o viram assim.
De vinte a trinta é o intervalo em que os lançamentos dos parceiros estabilizaram: o suficiente para um fã dedicado não concluir o quadro inteiro numa sessão, e suficientemente poucas para a sua equipa as escrever todas antes do dia do lançamento. Conte o que um fã recém-chegado consegue realmente ver, e não o total no painel de administração.
## Tenha exatamente uma missão diária [#run-exactly-one-daily]
Uma coisa pequena que se renova todos os dias é o que traz os fãs de volta numa terça-feira, e demora dois minutos a configurar. Com mais de uma missão diária, o hábito torna-se uma obrigação.
## Faça a recompensa valer o esforço [#make-the-reward-worth-the-effort]
Um fã que gasta vinte minutos num envio pela mesma recompensa de um clique num link fica a saber quanto valem as suas missões. Recompense o esforço de forma justa, e use [recompensas decrescentes](/docs/rewards#decaying-rewards) quando quiser rapidez, e não volume.
## Deixe espaço para a segunda vaga [#leave-room-for-the-second-wave]
Seja o que for que publique no lançamento, os seus fãs mais dedicados vão terminar tudo num dia. Tenha o lote seguinte escrito antes de o primeiro ser publicado.
## Onde está o resto [#where-the-rest-of-it-lives]
| O que procura | Página |
| ---------------------------------------------------------- | ------------------------------------------- |
| Todos os campos do formulário de missão | [Criar uma missão](/docs/quests/creating) |
| O que cada modelo pede, e quais exigem uma conta associada | [Modelos de missão](/docs/quests/templates) |
| Editar, agendar e arquivar uma missão publicada | [Gerir missões](/docs/quests/managing) |
| Agrupar missões e dar um filtro aos fãs | [Etiquetas](/docs/quests/tags) |
| Aprovar envios de imagem e de texto | [Rever envios](/docs/quests/submissions) |
# Gerir missões (/pt/docs/quests/managing)
Dois campos ficam bloqueados no momento em que a missão é guardada.
## Campos editáveis e campos bloqueados [#editable-and-locked-fields]
| Campo | Depois de a missão ser guardada |
| ---------------------------------------------------- | ------------------------------- |
| Modelo | Bloqueado |
| Recompensa | Bloqueado |
| Título, descrição e imagem | Editável |
| Etiqueta e ordem no quadro de missões | Editável |
| Data de fim e expiração | Editável |
| Visibilidade e requisitos | Editável |
| Recorrência, bónus de sequência e teto de recompensa | Editável |
| Destaque | Editável |
Dois campos ficam bloqueados. Todos os outros campos do formulário continuam editáveis, pelo que uma descrição confusa pode ser corrigida enquanto os fãs estão a fazer a missão.
O motivo é a justiça. Os fãs já concluíram a missão nos termos que publicou, e mudar o que ela verifica ou o que ela paga levaria dois fãs a fazer trabalhos diferentes, por recompensas diferentes, sob o mesmo título.
Na criação, o modelo e a recompensa são os dois campos a verificar duas vezes. Tudo o resto pode ser corrigido depois. Se errar num deles, duplique a missão, corrija a cópia e arquive a original. O histórico de conclusões fica com a original.
Uma missão guardada como rascunho já fixou o modelo e a recompensa.
## Despublicar [#unpublishing]
A missão sai do quadro de missões.
* Os fãs deixam de a conseguir ver e concluir.
* Um fã que estava a meio da missão perde-a. Isto pesa mais nas missões de gaming, em que o progresso se acumula ao longo de horas de jogo: o cartão desaparece e as horas não contam.
* Os fãs que já a concluíram mantêm-na no histórico de missões, com a recompensa que receberam.
Despublique uma missão cujo alvo deixou de funcionar, por exemplo uma publicação apagada ou um link inativo. Para uma missão que já cumpriu o seu ciclo, uma data de fim é mais simpática, porque os fãs a veem fechar em vez de desaparecer.
## Duplicar [#duplicating]
Duplicar copia todos os campos para um novo rascunho, incluindo o modelo e a recompensa que de outra forma não conseguiria alterar.
É assim que se corrige um erro, e é assim que se repete a mesma missão no mês seguinte sem a reconstruir. Mude o nome da cópia antes de publicar. Duas missões com o mesmo título no mesmo quadro são um pedido de suporte garantido.
## Estatísticas por missão [#per-quest-analytics]
Abra uma missão para ver como correu.
| Medida | O que mostra |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Completions (conclusões) | Quantos fãs a terminaram |
| Attempts (tentativas) | Quantos tentaram. A diferença entre tentativas e conclusões é a dificuldade real da missão |
| Completion history (histórico de conclusões) | Um gráfico ao longo do tempo, que mostra se a missão ainda atrai atenção ou se foi concluída na primeira tarde |
| Fan detail (detalhe por fã) | Quem a concluiu, em quantas tentativas e quando |
| Timeframe (período) | Hoje, os últimos sete dias ou desde sempre |
## A coluna Audience [#the-audience-column]
O quadro de missões apresenta uma percentagem em Audience. É a parte de toda a sua comunidade que concluiu a missão:
```
completions / total members x 100
```
Assim, uma missão com 4% numa comunidade de cinquenta mil membros foi concluída por dois mil fãs. Avalie esse número em relação ao separador em que a missão está e em relação às suas outras missões, nunca em relação a 100. Uma missão diária e uma missão que pede uma foto nunca vão gerar números comparáveis, e esperar isso é a forma mais rápida de pôr de parte algo que estava a funcionar.
Exporte o detalhe por fã em CSV para tudo o que precisar fora do painel de administração, como sortear um vencedor ou preparar um resumo para um patrocinador.
Muitas tentativas com poucas conclusões costumam indicar que as instruções estão erradas, e não que a missão é difícil. Releia a sua própria descrição antes de mudar a recompensa.
Para números de toda a comunidade, e não de uma única missão, veja [Estatísticas](/docs/analytics). Para levar estes dados de forma contínua para os seus próprios sistemas, veja [Data API](/docs/integrations/data-api).
# Rever envios (/pt/docs/quests/submissions)
As missões de imagem e de texto não podem ser verificadas por uma máquina, pelo que uma pessoa tem de ver cada envio.
## A fila [#the-queue]
Dois separadores. **Pending** (pendentes) reúne tudo o que aguarda uma decisão, com a contagem ao lado do nome do separador. **History** (histórico) reúne todas as decisões já tomadas, para poder verificar o que foi aprovado e por quem.
Abra um envio para ver a imagem ou o texto, o fã que o enviou e a missão a que pertence.
Aprovar é definitivo. A recompensa é paga de imediato e não é possível anular. Leia o envio antes de premir o botão, e tenha cuidado com o teclado quando estiver a percorrer uma fila longa.
## O que o fã vê [#the-fans-view]
Enquanto um envio aguarda, o cartão da missão mostra «Enviada, em revisão». O fã sabe que o envio chegou e que ainda nada foi pago.
Ao rejeitar, pode deixar um comentário, e o fã pode voltar a enviar. Use essa opção. «Rejeitado», sozinho, soa a um juízo sobre o fã; «a foto tem de mostrar a camisola inteira» soa a uma instrução, e o envio costuma voltar correto.
## Exportação em massa [#bulk-export]
Transfira de uma só vez todos os envios de uma missão: um ficheiro zip com as imagens e os ficheiros de texto, mais um CSV que lista quem enviou o quê.
O CSV inclui o ID do fã, o nome de utilizador e o envio, e os ficheiros recebem o nome da missão e o nome de utilizador, pelo que uma pasta com duzentas participações continua fácil de ordenar.
É assim que se faz um concurso de design ou uma campanha de fotos sem abrir duzentos cartões um a um. Exporte, avalie offline com as pessoas que têm de avaliar, depois volte e aprove.
## Ritmo [#cadence]
* Decida quem revê e quando, antes de publicar a missão.
* Reveja à mesma hora todos os dias. Uma hora fixa, de manhã ou ao meio-dia, basta. Os fãs aprendem quando saem as decisões e deixam de atualizar o ecrã.
* Designe um segundo revisor para as campanhas. Tudo o que divulgou vai gerar mais envios num dia do que o resto do quadro de missões num mês.
Uma fila lenta é a forma mais rápida de levar os fãs a deixar de enviar. Um concurso de design em que as aprovações demoram duas semanas parece uma missão avariada, e os fãs que entregaram trabalho a sério são os primeiros a reparar. Se não consegue rever no prazo de um dia, não publique ainda a missão.
Os modelos de envio e os seus campos estão em [Respostas e envios](/docs/quests/templates/submission).
# Etiquetas (/pt/docs/quests/tags)
Uma etiqueta faz dois trabalhos ao mesmo tempo: é o filtro que os fãs usam no quadro de missões, e é a sua forma de agrupar uma campanha para a encontrar depois.
## Criar uma etiqueta [#creating-a-tag]
**Create tag**, e depois três campos.
| Campo | O que faz |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Label (nome) | O que os fãs veem no filtro. |
| Slug | O identificador no URL quando um fã seleciona a etiqueta. Por predefinição, usa o nome, e **não pode ser alterado depois**. |
| Order (ordem) | A posição da etiqueta na linha de filtros. Os números mais baixos vêm primeiro, e duas etiquetas com o mesmo número são ordenadas da mais antiga para a mais recente. |
O slug é o único campo aqui que não consegue corrigir. Escolha algo curto e estável, e deixe de fora o ano da campanha: `daily` sobrevive, `daily-2026` não.
Também pode criar uma etiqueta enquanto cria uma missão, no campo Tag. Ela entra nesta lista com as mesmas três propriedades.
## Gerir etiquetas [#managing-tags]
| Ação | O que acontece |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Edit (editar) | Altera o nome e a ordem. O slug, não. |
| Merge (fundir) | Move todas as missões de uma etiqueta para outra e remove a original. Fundir Social em Comunidade deixa todas as missões com a etiqueta Comunidade. |
| Delete (eliminar) | Remove a etiqueta definitivamente. As missões dela não são eliminadas; ficam em **Other** (outras). |
**Other** é o destino predefinido de qualquer missão sem etiqueta, seja porque nunca teve uma, seja porque a etiqueta foi eliminada. Não é uma etiqueta que possa gerir.
## Como usá-las bem [#using-them-well]
| Faça isto | Porquê |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Crie etiquetas por tipo de missão | Diárias, Social, Gaming, Patrocinador. Os fãs filtram para encontrar algo que possam fazer agora. Uma etiqueta chamada Meia-final da Champions League é uma campanha, e para campanhas existe o [destaque](/docs/quests/creating). |
| Mantenha a linha curta | Seis etiquetas cabem num telemóvel. Doze passam para uma segunda linha e deixam de parecer um filtro. |
| Defina a ordem com intenção | A primeira etiqueta é a que a maioria dos fãs prime. Ponha em primeiro lugar a etiqueta com as suas missões fáceis e repetíveis. |
| Funda em vez de eliminar | Eliminar atira as missões para Other, onde os fãs não as vão encontrar. Fundir mantém-nas num lugar para onde o fã está a olhar. |
# Avatares 3D (/pt/docs/rewards/avatars-3d)
Uma personagem que o fã possui e veste com objetos equipáveis colecionáveis ganhos na aplicação.
O avatar 3D é um complemento. Não está ativado em todas as aplicações e é cobrado à parte. Confirme com o seu contacto na FanBase que faz parte do seu plano antes de construir uma temporada, uma campanha ou um calendário de recompensas em torno dele.
## Objetos equipáveis [#wearables]
Cada um ocupa um espaço no avatar e tem um grau de raridade, pelo que um casaco mítico é visivelmente mais raro do que um comum. Ganham-se da mesma forma que os objetos de personalização: missões, eventos, loja e loot boxes.
Três espaços, pelo que são três coisas que um fã pode usar ao mesmo tempo.
A posse também pode servir de requisito de acesso. Uma missão, um evento ou uma publicação pode exigir um objeto equipável específico, e é assim que um objeto lendário ganho na temporada passada se torna a chave para algo nesta temporada.
## Padrão ou personalizado [#standard-or-custom]
O avatar padrão é uma personagem humana partilhada por todas as comunidades que usam o complemento, vestida com objetos equipáveis criados para a sua marca. Uma personagem personalizada é só sua: uma mascote, outro corpo, outra linguagem visual, com um conjunto de objetos feito para ela.
Ambos são produzidos pela nossa equipa de 3D a um ritmo acordado consigo. Uma personagem personalizada é um projeto com calendário próprio, e os termos de propriedade intelectual são diferentes entre os dois, por isso peça tudo por escrito antes de o trabalho começar. Veja [Quanto custa](/docs/getting-started/pricing).
# Objetos colecionáveis e personalização (/pt/docs/rewards/collectibles)
Os objetos de personalização e os objetos equipáveis de avatar partilham este ecrã. Os primeiros são carregados por si, e os segundos são produzidos pela nossa equipa de 3D.
## Objetos de personalização [#personalisation-items]
Fotos de perfil, molduras e fundos que o fã equipa no perfil. São carregados por si, e aparecem em toda a aplicação: na classificação, nos comentários, ao lado do nome dele na barra de navegação.
| Objeto | Onde aparece |
| -------------- | ---------------------------------------------- |
| Foto de perfil | Em todo o lado onde o avatar do fã aparece |
| Moldura | Por cima da foto de perfil, à volta do rebordo |
| Fundo | Atrás do perfil dele |
Carregue quantos quiser. Os ficheiros animados funcionam.
As molduras ficam por cima da foto, e não atrás dela, por isso deixe o meio da moldura transparente e desenhe só o contorno. Uma moldura que preenche o quadrado inteiro esconde o avatar que está por baixo.
## Objetos equipáveis de avatar [#avatar-wearables]
Objetos usados por um avatar 3D: roupa, acessórios, equipamentos. São produzidos pela nossa equipa de 3D de acordo com as diretrizes da sua marca e publicados no seu painel de administração, prontos a configurar.
Os avatares são um complemento. Se a sua comunidade não tem avatares, esta secção trata só de objetos de personalização. Veja [Avatares 3D](/docs/rewards/avatars-3d).
## Raridade [#rarity]
Todos os objetos têm um grau de raridade. Muda a forma como o objeto é apresentado na aplicação, e é o atalho que os fãs usam entre si.
Defina a escala antes de carregar o primeiro lote, e mantenha o topo dela realmente escasso. A raridade é uma promessa sobre quantos existem. Um objeto lendário numa missão diária ensina aos fãs que a palavra não significa nada, e não há volta a dar.
## Caminhos até ao fã [#routes-to-a-fan]
| Caminho | Configure em |
| -------------------- | ----------------------------------------- |
| Recompensa de missão | [Criar uma missão](/docs/quests/creating) |
| Prémio de evento | [Eventos](/docs/events) |
| Artigo da loja | [Loja](/docs/store) |
| Conteúdo de loot box | [Recompensas](/docs/rewards) |
O mesmo objeto pode ser usado nos quatro. Um objeto colecionável que é ao mesmo tempo um artigo da loja e um prémio de loot box não é problema, e isso dá aos fãs que perderam o drop uma forma de conseguirem um.
Os objetos ficam guardados na sua comunidade, e não numa blockchain. Veja [Estado das funcionalidades](/docs/status#retired).
# Recompensas personalizadas (/pt/docs/rewards/custom-rewards)
Uma recompensa personalizada é tudo o que é entregue por si: uma camisola da equipa, uma camisola autografada, um vale-oferta, um bilhete, uma chamada com um jogador. A plataforma regista quem ganhou e recolhe aquilo de que precisa para fazer a entrega.
## Criar uma recompensa [#creating-one]
| Campo | O que faz |
| ---------- | ----------------------------------------------------------------------------------------------------------------- |
| Título | O que os fãs veem quando ganham. Seja específico: «Camisola principal 2026 autografada», e não «Prémio de merch». |
| Descrição | O que é e o que acontece depois. Diga quanto tempo demora a entrega, porque o fã não tem outra forma de saber. |
| Imagem | A imagem no cartão da recompensa. |
| Requisitos | O que o fã tem de indicar antes de poder fazer a entrega. |
Cada requisito acrescenta um formulário que o fã preenche ao reivindicar.
| Requisito | Peça quando |
| -------------------- | ------------------------------------------- |
| Endereço de e-mail | Vai enviar um código, um link ou um convite |
| Morada postal | Vai expedir algo físico |
| Endereço de carteira | Vai enviar algo on-chain |
Peça o mínimo necessário. Um fã a quem se pede uma morada postal para receber um código de desconto conclui que algo correu mal, e alguns fecham o formulário.
## Editar e eliminar [#editing-and-deleting]
Todos os detalhes de uma recompensa que ainda não foi distribuída podem ser editados.
A eliminação é definitiva. Se uma recompensa já foi distribuída, o registo dela continua no painel de administração depois da eliminação. Lista todos os que a ganharam e o que enviaram, para que ainda possa entregar o que deve.
## Acompanhamento da distribuição [#distribution-tracking]
Abra uma recompensa para ver quem a recebeu.
| Lista | O que mostra |
| -------------- | ------------------------------------------------------------------------------------ |
| Ganhas | Todos os fãs que a ganharam, e em que missão ou evento |
| Reivindicadas | Quais deles preencheram o formulário de reivindicação, e quais ainda estão pendentes |
| Dados enviados | O que cada fã indicou: morada, e-mail ou carteira |
A diferença entre ganhas e reivindicadas é a lista de quem é preciso lembrar. Os fãs esquecem-se de reivindicar.
Processe as reivindicações em lotes, a um ritmo que consiga manter. Os dados de reivindicação têm sempre o mesmo formato, pelo que exportá-los para a ferramenta que a sua equipa de entregas já usa é melhor do que copiar linhas à mão.
## Distribuição de códigos [#code-distribution]
Em desenvolvimento
Vai poder carregar um lote de códigos de desconto ou de oferta e distribuí-los como recompensa, entregues ao fã por e-mail. Um código por fã, retirado de um conjunto que controla, em vez de um código partilhado que acaba num site de cupões.
Até lá, os códigos são uma recompensa personalizada com requisito de e-mail, enviada por si. Veja [Estado das funcionalidades](/docs/status).
# Visão geral das recompensas (/pt/docs/rewards)
Todas as missões terminam em algo que o fã recebe.
Sete tipos de recompensa, e a maioria das comunidades usa três. A lista abaixo está ordenada pelo tempo que cada um lhe consome, a começar pelo mais barato.
| Recompensa | O que o fã recebe | O que lhe custa |
| ----------------------------------------- | ------------------------------------------------------------------------- | --------------------------------- |
| XP | Progresso rumo ao nível seguinte e um lugar na classificação | Nada. É automático |
| Moeda gastável | Um saldo para gastar na loja e em loot boxes | Nada, até ele a gastar |
| Objetos colecionáveis e de personalização | Uma foto de perfil, uma moldura, um fundo ou um objeto que é dele | Um carregamento por cada um |
| Loot boxes | Uma hipótese de ganhar qualquer coisa que esteja na caixa | Definir as probabilidades uma vez |
| Cargos do Discord | Um cargo no seu servidor, atribuído automaticamente | Ligar o Discord uma vez |
| Prémios e recompensas personalizadas | Um vale-oferta, um código, produtos oficiais, um bilhete, uma experiência | Uma pessoa, para fazer a entrega |
| Recompensas decrescentes | Uma recompensa em moeda que diminui à medida que outros fãs a reivindicam | Uma decisão sobre o valor mínimo |
## Os dois recursos [#the-two-resources]
**O XP** só pode ser ganho. O fã ganha XP ao concluir coisas e nunca o pode gastar, por isso mede quanto alguém já fez. Determina os níveis, a [classificação](/docs/leaderboards) principal e os patamares do [battlepass](/docs/battlepass). Não o associa manualmente a uma missão: é distribuído automaticamente na conclusão.
**A moeda gastável** é o segundo recurso, opcional. Chama-se Pontos ou Créditos por predefinição, e pode mudar-lhe o nome para o que fizer sentido na sua comunidade. Os fãs ganham-na em missões e eventos e gastam-na na [loja](/docs/store) e em loot boxes.
Usar os dois é a configuração normal, e existe para que gastar nunca custe ao fã a sua posição.
A forma como os limiares de XP se transformam em níveis está em [Níveis](/docs/levels). Como criar uma moeda e mudar-lhe o nome está em [Recursos](/docs/rewards/resources).
## Prémios e recompensas personalizadas [#prizes-and-custom-rewards]
Tudo o que existe fora da aplicação. Vales-oferta, códigos de desconto, produtos autografados, bilhetes para jogos, uma chamada com um jogador.
São as recompensas de que os fãs realmente falam, e as únicas que precisam de uma pessoa. Crie uma com título, descrição e imagem, e depois decida o que precisa do fã antes de poder fazer a entrega.
| Requisito | Recolha quando |
| -------------------- | -------------------------------------------------------- |
| Endereço de e-mail | Vai enviar um código ou um cupão |
| Morada postal | Vai expedir algo |
| Endereço de carteira | Vai enviar algo on-chain |
| Nada | A recompensa é honorária, ou já sabe como contactar o fã |
O fã indica os dados no momento em que reivindica, e não quando ganha, pelo que não guarda endereços de pessoas que nunca voltaram. Tudo o que é reivindicado chega ao painel de administração com o fã, a recompensa e os dados indicados, e a sua equipa trabalha a partir dessa lista. Veja [Recompensas personalizadas](/docs/rewards/custom-rewards).
Recompense o esforço de forma justa. Um fã que gasta vinte minutos num envio por cem XP fica a saber exatamente quanto valem as suas missões.
## Objetos colecionáveis e de personalização [#collectibles-and-personalisation-items]
Objetos que o fã possui e guarda.
**Os objetos de personalização** são os que qualquer comunidade pode usar: fotos de perfil, molduras que ficam por cima da foto, e fundos. Carrega-os, distribui-os por missões, eventos, loja e loot boxes, e eles aparecem na classificação, nos perfis, nos comentários e na barra de navegação.
**Os objetos equipáveis** ficam no avatar 3D e fazem parte do complemento de avatar, e não da plataforma base. Ambos são tratados em [Objetos colecionáveis e personalização](/docs/rewards/collectibles) e [Avatares 3D](/docs/rewards/avatars-3d), e a configuração está em [Objetos colecionáveis e personalização](/docs/rewards/collectibles).
Os objetos ficam guardados na sua comunidade, e não numa blockchain. Veja [Estado das funcionalidades](/docs/status#retired).
## Loot boxes [#loot-boxes]
Uma caixa com qualquer combinação das recompensas acima, com probabilidades que define para cada objeto, aberta com uma animação.
O fã compra uma na loja com moeda gastável ou recebe uma como recompensa. Em ambos os casos, o conteúdo é decidido no momento da abertura, por isso a mesma caixa pode ter um lote comum de moeda e um prémio raro.
As loot boxes são a forma de pôr em circulação algo realmente escasso sem decidir quem fica com ele. Dez camisolas autografadas como recompensa de missão significam escolher dez fãs. Dez camisolas autografadas numa caixa significam que todos os fãs têm um motivo para abrir uma.
Duas coisas a acertar. Probabilidades demasiado generosas esvaziam o seu stock num fim de semana. Probabilidades demasiado mesquinhas criam uma caixa que os fãs abrem duas vezes e nunca mais, porque receber cem de moeda cinco vezes seguidas ensina que não vale a pena abrir a caixa. Publique as probabilidades na descrição.
## Cargos do Discord [#discord-roles]
Uma missão pode atribuir um cargo no seu servidor do Discord na conclusão. É preciso ter o [Discord](/docs/integrations/discord) ligado, e o cargo já tem de existir no seu servidor.
Use para ligar a aplicação ao servidor que já gere: terminar o onboarding na aplicação, receber o cargo de verificado no Discord, ver os canais. Também funciona como requisito de acesso no sentido contrário, porque um cargo do Discord pode ser um requisito de missão.
## Recompensas decrescentes [#decaying-rewards]
Uma recompensa que vale mais para os fãs que chegam primeiro. Define um valor inicial, quanto desce a cada reivindicação e um valor mínimo abaixo do qual nunca desce. O fã vê quanto a recompensa vale agora.
Desce com as reivindicações, e não com o relógio, por isso o valor depende de quantos fãs chegaram antes dele, e não de quanto tempo esperou. Numa missão pouco movimentada, a redução progressiva deixa o valor perto do inicial durante dias.
| Campo | O que faz | Se errar |
| --------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Valor inicial | O que recebem os primeiros fãs a reivindicar | Demasiado baixo, e a descida não muda em nada o momento em que um fã reivindica |
| Taxa de redução | Quanto o valor desce a cada reivindicação | Demasiado rápida, e todos os que ficam fora das primeiras reivindicações recebem o valor mínimo |
| Valor mínimo | O valor em que ela para | Um valor mínimo de zero significa que um fã atrasado faz o trabalho de graça |
Esta é a ferramenta para premiar quem chega cedo, e não o volume. Use quando o objetivo é que os fãs apareçam antes de toda a gente: um drop, uma missão de dia de jogo, uma reação a uma notícia que publicou há uma hora. Não use na sua missão diária.
Defina o valor mínimo num montante que pagaria de bom grado, e defina a taxa pelo número de fãs que espera, e não por um prazo.
A redução por tempo decorrido, com uma contagem decrescente no cartão, está com o estado Planeado. Veja [Estado das funcionalidades](/docs/status).
## Várias recompensas numa missão [#several-rewards-on-one-quest]
Uma missão pode ter mais de uma recompensa. XP mais moeda mais um objeto colecionável é uma combinação normal, e o fã reivindica tudo de uma vez.
Combine uma recompensa pequena e automática com uma rara. Toda a gente recebe a moeda, e o objeto colecionável é o motivo para se esforçar. Isto também permite dividir uma recompensa por tipos, pelo que uma missão difícil pode pagar ao mesmo tempo em algo para gastar e em algo para guardar.
## Atribuição e reivindicação [#allocation-and-claim]
Todas as recompensas passam por duas etapas, e um fã que pergunta onde está o seu prémio geralmente ficou entre as duas.
**A atribuição** acontece quando o fã ganha a recompensa. A plataforma reserva a recompensa na conta dele. Num evento, é o momento em que o evento é resolvido e as posições são definitivas.
**A reivindicação** é a ação do fã. Ele prime o botão de reivindicar, a recompensa chega, e tudo o que pediu é recolhido nesse momento. Um prémio que exige morada postal pede a morada aqui.
As recompensas não se reivindicam sozinhas. Um fã que ganhou um prémio e nunca mais abriu a aplicação tem uma atribuição por reivindicar, e ela vai ficar ali. Se faz uma campanha com prazo, essa lacuna merece um aviso. A lista de reivindicações no painel de administração e a lista de recompensas ganhas são duas listas diferentes.
# Recursos (/pt/docs/rewards/resources)
Um recurso é um número que o fã acumula. Há três tipos, e comportam-se de forma suficientemente diferente para que confundi-los estrague a sua economia.
## Os três tipos [#the-three-kinds]
| Propriedade | Primário | Secundário | Pontuação de evento |
| ------------------- | ------------------------------------- | -------------------------------------- | ----------------------------------------- |
| Nome predefinido | XP | Pontos ou Créditos | Pontuação de evento |
| Como o fã ganha | Missões, eventos, compras | Da mesma forma | Ao concluir missões dentro de um evento |
| O fã pode gastar | Não. Só pode ser ganho. | Sim. É a moeda da loja. | Não |
| O que determina | Os níveis e a classificação principal | O saldo, e o que o fã consegue comprar | A classificação desse evento, e mais nada |
| Quantos tem | Um | Quantos criar, embora o ideal seja um | Uma por evento |
| Sobrevive ao evento | Sim | Sim | Não. Vale só para o evento que a gerou |
O XP só sobe, e é isso que dá significado a uma classificação ao longo de uma temporada. O recurso secundário sobe e desce, porque os fãs o gastam na [loja](/docs/store). A pontuação de evento é independente dos dois: ordena um único [evento](/docs/events) e não altera o nível de um fã nem a posição dele na classificação principal.
## Mudar o nome e o ícone [#renaming-and-re-imaging]
Selecione um recurso e edite. Pode alterar o **nome** e o **ícone**.
O nome é o que os fãs veem em todo o lado: cartões de missão, loja, classificação, notificações. Os parceiros dão ao XP nomes como Pontos de Fã ou o nome do clube mais XP, e à moeda secundária nomes como Créditos, Moedas ou o nome da moeda do próprio clube.
Escolha os dois antes do lançamento. Um fã que ganha Créditos há um mês e abre a aplicação para encontrar Moedas conclui que lhe tiraram algo.
O ícone fica ao lado de cada número na aplicação, em tamanho pequeno, pelo que um logótipo detalhado se torna um borrão. Use uma forma simples de uma só cor.
## Criar um recurso secundário [#creating-a-secondary-resource]
Um recurso secundário leva um nome e um ícone, e é criado por si.
## Boa prática, duas moedas [#best-practice-two-currencies]
Use o XP mais uma moeda gastável e fique por aí. É a configuração para a qual todos os ecrãs da aplicação foram pensados.
Uma terceira moeda gastável é um peso para o suporte. Duplica o número de preços na loja e precisa de regras próprias sobre o que a gera. Se acha que precisa de uma, descreva-nos primeiro a campanha, porque normalmente uma [etiqueta](/docs/quests/tags) ou um [requisito de nível](/docs/levels) faz o mesmo trabalho.
## Redefinir saldos [#reset-balance]
Um botão. Apaga os saldos e os níveis de todos os fãs da comunidade, e não pode ser anulado.
| Apagado | Mantido |
| ---------------------------------------------------------- | ------------------------------------------------------ |
| Saldos dos recursos, primário e secundários | Histórico de conclusão de missões, incluindo os envios |
| Níveis, e a posição de cada fã na classificação | Contas, contas associadas e perfis |
| Progresso do battlepass, que é desbloqueado com o mesmo XP | Objetos colecionáveis e outros objetos já detidos |
Esta é a última etapa antes do lançamento. A sua equipa testou a aplicação, e esses testes geraram saldos reais em contas reais, parados no topo da classificação no primeiro dia, à vista de todos. Redefina os saldos na véspera de convidar os fãs.
Depois do lançamento, trate a redefinição como uma mudança de temporada, e não como uma tarefa de manutenção. As posições passadas não são arquivadas quando redefine os saldos, pelo que tudo o que quiser guardar tem de ser exportado antes: a [exportação de membros](/docs/members#exporting-the-member-list) ou a [Data API](/docs/integrations/data-api). Um histórico de temporadas que sobreviva a uma redefinição está na lista. Veja [Estado das funcionalidades](/docs/status).
# Automatizações (/pt/docs/settings/automations)
A Shopify fica aqui, e o bot do Discord também.
## Shopify [#shopify]
É onde uma loja ligada aparece como ligada. Se fez a instalação e a Shopify não aparece aqui, a instalação não terminou. A causa mais comum é não ter a sessão iniciada no painel de administração, no mesmo navegador, ao clicar no link de instalação.
As regras de recompensa em si são configuradas na secção Shopify, e não aqui. Veja [Shopify](/docs/integrations/shopify).
## O bot do Discord [#the-discord-bot]
O nosso bot publica num canal à sua escolha quando algo acontece na aplicação.
| Gatilho | O que ele publica |
| --------------------- | --------------------------------------------------------------- |
| Nova missão publicada | O título da missão, a descrição e um link para a sua aplicação. |
| Novo evento publicado | O título do evento, o período e um link. |
| Fim de um evento | Que o evento terminou, a apontar para os resultados. |
Vêm a caminho mais gatilhos, incluindo publicações do feed de notícias, alterações na loja e vencedores de eventos. Veja [Estado das funcionalidades](/docs/status).
### Como configurar [#setting-it-up]
Nós instalamos o bot no seu servidor e damos-lhe permissão para publicar. Depois disso, cada gatilho pede duas decisões no painel.
| Campo | O que faz | O que pode correr mal |
| ----------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Canal | Onde a mensagem chega. | Num canal de anúncios sossegado, a mensagem é vista uma vez. Num canal geral movimentado, fica soterrada em quatro minutos. |
| Cargo a mencionar | Opcional. O cargo mencionado juntamente com a mensagem. | Mencionar `@everyone` numa missão diária é a forma mais rápida de ter o seu bot silenciado no servidor inteiro. Crie um cargo a que os fãs escolhem aderir. |
Ative os gatilhos um de cada vez e observe o servidor durante uma semana. Uma comunidade que publica vinte missões no lançamento com o gatilho de nova missão ativado publica vinte mensagens numa hora, e a vigésima primeira já é silenciada.
A configuração completa, incluindo as permissões de que o bot precisa e como funcionam as missões de cargo do Discord, está em [Discord](/docs/integrations/discord).
# Requisitos de acesso (/pt/docs/settings/gating)
Quase tudo o que publica pode ficar atrás de uma condição: missões, prognósticos, as etapas de uma missão em várias etapas, artigos da loja. O elemento continua a aparecer, só não abre para um fã que não cumpre a condição.
O mesmo conjunto aparece em todo o lado onde há requisitos de acesso, por isso basta aprender as condições uma vez. O painel de administração oferece as condições que o elemento que está a editar aceita. As condições acumulam-se, por isso duas condições num mesmo elemento significam que ambas têm de ser verdadeiras.
## As condições [#the-conditions]
| Condição | Abre para | Use quando |
| ------------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------ |
| **Activated users only** (apenas utilizadores ativados) | Fãs que associaram contas e concluem missões regularmente | Qualquer coisa gratuita com um prémio por trás |
| **Membership** (subscrição) | Membros Premium, no plano que escolher | O objetivo é fazer a subscrição valer o preço |
| **Level** (nível) | Fãs que chegaram a um nível definido por si | Quer que seja conquistado, não comprado |
| **Quest** (missão) | Fãs que concluíram uma missão específica | Uma coisa tem de acontecer antes que a seguinte faça sentido |
| **Wearable** (objeto equipável) | Fãs que têm um objeto equipável específico | O público já existe como colecionadores |
| **Discord** | Fãs que têm um cargo no seu servidor | Já atribui esse cargo manualmente |
**Activated users é a condição que a maioria das pessoas usa menos do que devia.** Não significa qualquer pessoa com uma conta. Significa um fã que associou contas e continua a concluir missões, por isso uma conta descartável criada só pela recompensa não se qualifica, e um fã verdadeiro já se qualifica. Uma missão aberta com algo que vale a pena ganhar é exatamente o que atrai essas contas descartáveis, o que faz deste o filtro mais barato que tem e o único que não custa nada a um fã legítimo.
## O que o fã vê [#what-a-fan-sees]
O elemento continua visível, porque um fã que não vê o que está a perder não tem motivo para se qualificar.
O que muda é o que o elemento diz quando ele o tenta abrir. Uma condição que o fã ainda pode cumprir indica como a cumprir: um requisito de subscrição propõe a mudança de plano, um requisito de missão indica a missão a concluir, um requisito de nível indica o nível a alcançar. Uma condição sobre a qual ele não pode agir aparece como bloqueada, sem mais instruções.
# Geral (/pt/docs/settings/general)
Quase tudo o que um fã vê antes de fazer qualquer coisa está neste ecrã. As contas com que um fã pode iniciar sessão e que pode associar estão em [Início de sessão](/docs/settings/sign-in).
## Informações básicas [#basics]
| Campo | O que faz |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Nome | O nome da comunidade no cabeçalho, no separador do navegador e na pré-visualização do link quando alguém partilha a sua aplicação. |
| Descrição | A linha abaixo do nome, e o texto dessa mesma pré-visualização do link. Escreva para alguém que nunca ouviu falar da aplicação. |
## Links importantes [#important-links]
Os links que os fãs veem na sua aplicação: **Website**, **X**, **Discord**, **YouTube**, **Twitch**, **Instagram** e **TikTok**. Preencha os que realmente mantém e deixe os outros vazios. Um campo vazio oculta o ícone em vez de mostrar um que não leva a lado nenhum.
Estes são links de apresentação. Anunciar missões no Discord fica em [Automatizações](/docs/settings/automations), e a verificação de um cargo do Discord numa missão exige [a integração com o Discord](/docs/integrations/discord).
## Personalização visual [#visual-customisation]
| Definição | O que faz | O que pode correr mal |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Cor de destaque | A cor única da marca presente em toda a aplicação: botões, barras de progresso, estados ativos, destaques. | Uma cor de destaque clara sobre um fundo escuro faz os botões parecerem desativados. Verifique num botão, não numa amostra de cor. |
| Logótipo | 240x240 recomendado, 5 MB no máximo. Fica no cabeçalho e no ecrã de início de sessão. | Qualquer logótipo com margem incorporada parece pequeno ao lado de outras aplicações. Recorte-o rente. |
| Imagem de capa | 1920x1080 recomendado, 5 MB no máximo. O banner no topo da aplicação. | Os detalhes perto do centro são cortados num telemóvel. Mantenha rostos e texto longe das margens. |
| Fundos de página | Um fundo separado por secção: missões, eventos, loja, classificação, feed de notícias, battlepass, perfil, definições. | Uma imagem carregada atrás de um quadro de missões deixa o texto dos cartões ilegível. Teste com o quadro cheio, não vazio. |
| Tipos de letra | Um tipo de letra principal e um alternativo para os títulos. | Um tipo de letra sem negrito achata todos os títulos da aplicação. |
| Arredondamento dos cantos | Base, grande, compacto ou nenhum, aplicado a todos os cartões e botões. | |
| Escala de espaçamento | Base, grande ou compacta. A compacta coloca mais conteúdo no ecrã, a grande é mais tranquila de ler num telemóvel. | |
As alterações são guardadas de imediato e aparecem aos fãs no carregamento de página seguinte. Não há etapa de publicação aqui, por isso mude a identidade visual quando ninguém estiver a meio de uma missão.
## Tema [#theme]
| Opção | O que os fãs recebem |
| -------------- | -------------------------------------------------------------- |
| Dark (escuro) | A predefinição, e o que a maioria das comunidades usa. |
| Light (claro) | Apenas claro. |
| Both (os dois) | Uma opção para alternar na aplicação, memorizada para cada fã. |
Escolha um e mantenha-o, a não ser que tenha um motivo. **Both** duplica o que tem de verificar. Cada imagem de missão, cada fundo, cada logótipo e cada cor personalizada tem de funcionar sobre dois fundos. Se a sua marca assenta numa paleta escura, use o escuro.
## Navegação [#navigation]
A ordem e os rótulos das secções da sua barra de navegação.
* **Reordene** as secções para que a mais importante para si venha primeiro. A maioria das comunidades começa pelas missões.
* **Renomeie** uma secção, para que a loja apareça como «Shop».
* **Oculte** uma secção que não usa. Ocultar remove a secção da navegação, sem apagar o conteúdo que está por trás dela.
* **Adicione um link personalizado** para o seu site principal, a sua bilheteira ou o seu Discord. Fica ao lado das secções nativas.
Uma barra de navegação com nove entradas parece um menu de definições. Seis são mais do que suficientes num telemóvel.
## Rótulos das funcionalidades [#feature-labels]
Renomeie uma funcionalidade inteira em toda a aplicação, e não só na navegação. As missões passam a Desafios, os eventos passam a Torneios, a loja passa a ser o Shop.
O singular e o plural são escolhidos por si, e o rótulo é aplicado em todos os sítios onde a palavra aparece: títulos de página, estados vazios, botões, notificações. Diga ao seu contacto na FanBase as palavras que quer e nós aplicamo-las.
Renomeie antes do lançamento. Mudar a palavra depois de os fãs a terem aprendido custa mais do que aquilo que a palavra melhor traz de ganho.
## Idiomas [#languages]
Inglês, francês, português, italiano e indonésio. Diga-nos quais quer e nós ativamo-los na sua comunidade.
Ativar um idioma não traduz o seu conteúdo. Os títulos das missões, as descrições e os textos dos eventos são escritos por idioma no painel de administração, e uma missão sem tradução aparece no seu idioma predefinido em vez de desaparecer. Se oferece francês, reserve tempo de alguém para escrever cada missão duas vezes.
# Funções e acesso (/pt/docs/settings/roles)
Todas as pessoas que mexem na aplicação precisam de um início de sessão próprio. As contas partilhadas tornam o registo de auditoria inútil e custam uma tarde quando alguém sai.
## Como convidar um administrador [#inviting-an-admin]
**Invite admin**, e depois o endereço de e-mail. A pessoa recebe um convite e cria a sua própria conta.
Convide as pessoas que vão tratar da comunidade no dia a dia.
## Funções [#roles]
| Função | O que alcança |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Admin | Missões, eventos, envios, membros, recompensas, a loja e o feed de notícias. A função normal para um community manager. |
| Content Creator | Apenas publicações e definições. Pensada para um criador ou um gestor de redes sociais que publica no feed de notícias e não deve poder alterar a sua economia. |
Tenha pelo menos duas pessoas com a função Admin, para que umas férias não bloqueiem um lançamento.
As subfunções restringem ainda mais o acesso quando quer um revisor que só trata dos envios ou alguém de marketing que só mexe no feed de notícias. Peça-nos a divisão que quer.
## Ações que executamos a pedido [#actions-we-run-on-request]
Algumas alterações ficam fora destas funções, e nós fazemo-las na sua comunidade quando as pede. Diga ao seu contacto na FanBase aquilo de que precisa e nós executamos. Pergunte o prazo ao pedir a alteração, porque varia consoante a ação.
| Ação | Onde se aplica |
| -------------------------------------------- | ---------------------------------------------- |
| Renomear funcionalidades em toda a aplicação | [Geral](/docs/settings/general#feature-labels) |
| Emitir e revogar chaves de API | [Data API](/docs/integrations/data-api) |
Se um botão que esperava não está lá, esta tabela é o primeiro sítio onde procurar.
## Como encontrar pessoas [#finding-people]
A lista de administradores traz o nome de utilizador de cada pessoa na aplicação, o respetivo nome de utilizador no Discord e a data de entrada. Pesquise por nome de utilizador, ou filtre por data de entrada para encontrar quem foi adicionado durante uma campanha e nunca removido.
Reveja a lista todos os trimestres. As agências mudam de equipa, e uma conta de administrador que ninguém se lembra de ter criado é a que publica um rascunho sem querer.
# Início de sessão (/pt/docs/settings/sign-in)
Duas coisas separadas, configuradas de forma independente.
**O início de sessão** é a forma de um fã obter uma conta. **A associação de conta** é o que ele associa depois para que as missões de jogos e de redes sociais possam ser verificadas.
Os fornecedores são ativados por comunidade, por nós, por isso diga ao seu contacto na FanBase quais quer. O painel mostra o que a sua comunidade tem, e a tabela abaixo mostra o que é possível, não o que está ativado.
## O que cada fornecedor oferece [#what-each-provider-supports]
| Fornecedor | Início de sessão | Associação de conta |
| --------------- | ---------------- | ------------------- |
| Google | Sim | |
| Discord | Sim | Sim |
| X | Sim | Sim |
| Twitch | Sim | Sim |
| Shopify | Sim | |
| Steam | | Sim |
| Riot | | Sim |
| FACEIT | | Sim |
| Battle.net | | Sim |
| Epic | | Sim |
| YouTube | | Sim |
| Spotify | | Sim |
| Carteira EVM | | Sim |
| Carteira Solana | | Sim |
Um fã não pode desassociar a conta com que se registou, porque essa é a conta. Tudo o resto, o fã pode desassociar e voltar a associar, dentro de limites que existem para impedir que uma mesma pessoa acumule recompensas em várias contas.
## Prazo de ativação [#lead-time]
Peça os fornecedores de que precisa durante o [onboarding](/docs/getting-started/onboarding), e não na semana em que planeou a campanha. Alguns exigem um prazo real. A Shopify precisa de uma aplicação personalizada criada para a sua loja, as carteiras ficam atrás de uma flag, e vários fornecedores de jogos têm de dar aprovação do lado deles antes de funcionarem para a sua comunidade.
Uma missão não pode ser concluída se o respetivo fornecedor não estiver ativado para a sua comunidade. Publicar uma missão da Steam com a associação da Steam desativada dá aos fãs um cartão que podem abrir, ler e nunca terminar. Verifique o fornecedor antes de criar a missão.
# Ações na aplicação (/pt/docs/quests/templates/action)
Nenhuma conta para associar e nada para rever. Estes modelos leem um estado que a sua aplicação já guarda, ou aguardam um único toque.
| Modelo | O fã | O que configura |
| ------------------------------------------------------------------------ | --------------------------------------------------- | ------------------------------------------------------- |
| Auto complete (conclusão automática) | Abre a missão e prime para concluir | Nada |
| Visit link (visitar um link) | Abre o seu link e depois prime para concluir | O URL |
| Check level (verificar o nível) | Nada. O modelo lê o nível dele | O nível, e o recurso a partir do qual se leem os níveis |
| Check resource balance (verificar o saldo de um recurso) | Prime «Verificar» | O recurso e a quantidade |
| Complete a quest (concluir uma missão) | Conclui a missão que indicar | Qual a missão |
| Complete a number of quests (concluir um número de missões) | Conclui quaisquer missões até atingir a contagem | Quantas |
| Referral count (número de convites) | Partilha o link de convite e as pessoas registam-se | Quantas pessoas |
| Membership referral count (número de convidados que se tornaram membros) | O mesmo link, contado em membros da comunidade | Quantas pessoas |
| Leaderboard ranking (posição na classificação) | Sobe até uma posição | A posição pretendida |
| Event leaderboard ranking (posição na classificação de um evento) | Sobe até uma posição dentro de um evento | O evento e a posição pretendida |
| Join events (participar em eventos) | Participa em eventos | Quantos |
| Own collectibles (ter objetos colecionáveis) | Tem objetos no inventário | Quantos |
## Auto complete [#auto-complete]
O modelo sem qualquer condição. O fã abre a missão, prime o botão e recebe a recompensa.
Uma missão Auto complete diária, com uma recompensa pequena e um bónus de sequência, é a forma mais barata de levar os fãs a abrir a aplicação amanhã, e demora cerca de dois minutos a configurar. Veja [recorrência e sequências](/docs/quests/templates#recurrence-and-streaks).
Mantenha a recompensa pequena. Não há nada para verificar, por isso a recompensa é o preço de um toque.
## Visit link [#visit-link]
O fã abre o seu URL num novo separador, volta, e o botão de concluir fica ativo.
A plataforma regista o clique, e não o que aconteceu depois dele, por isso não consegue dizer se o fã leu o artigo ou fechou o separador. É para isso que o modelo serve: levar tráfego a um sítio que mede separadamente.
Escreva a descrição como se fosse a instrução. «Visite a nossa loja» rende um clique. «Visite a nossa loja e encontre o código no banner» rende um clique e um motivo para ficar.
## Check level e Check resource balance [#check-level-and-check-resource-balance]
Duas formas de recompensar os fãs por um progresso que já fizeram.
**Check level** é concluído assim que o fã alcança um nível definido por si. Os níveis são determinados por um recurso, geralmente o XP, pelo que escolhe o recurso além do número.
**Check resource balance** é concluído assim que o fã tem uma quantidade de um recurso definida por si. O modelo mostra uma linha de progresso e um botão «Verificar» em vez de se concluir sozinho, pelo que um fã que já ultrapassou a marca ainda tem de abrir a missão uma vez.
As missões de nível são também a base dos patamares do battlepass, e essas ficam ocultas do quadro de missões. Se vir no painel de administração missões de nível que ninguém da sua equipa criou, é isso que são. Veja [Battlepass](/docs/battlepass).
## Complete a quest e Complete a number of quests [#complete-a-quest-and-complete-a-number-of-quests]
**Complete a quest** é concluído assim que o fã conclui a missão que indicar. É uma forma de pagar um bónus por uma missão que quer impulsionar, sem editar a recompensa dessa missão.
**Complete a number of quests** conta qualquer missão, por isso é o marco do quadro inteiro: conclua cinco coisas esta semana e ganhe algo. A contagem começa no momento em que o fã inicia a missão, portanto publique no início de uma campanha, e não no fim.
Para fazer depender uma missão de outra missão, use um requisito de missão. Isso está em [Criar uma missão](/docs/quests/creating).
## Referral count e Membership referral count [#referral-count-and-membership-referral-count]
Ambos se baseiam no link de convite do próprio fã, que o cartão mostra com um botão de copiar. Nenhum deles pede mais nada ao fã.
**Referral count** é concluído quando o número de pessoas que se registaram através do link dele atinge a sua meta. O fã volta à missão para a concluir.
**Membership referral count** conta os convidados que se tornam membros da sua comunidade, e conclui-se sozinho no momento em que a contagem é atingida. Não há botão para o fã premir.
A plataforma aplica proteções aos convites, e uma missão que paga bem atrai quem tente contorná-las, por isso comece com uma recompensa mais baixa do que parece certo e aumente depois.
## Leaderboard ranking e Event leaderboard ranking [#leaderboard-ranking-and-event-leaderboard-ranking]
**Leaderboard ranking** é concluído quando o fã alcança uma posição definida por si na classificação da comunidade. **Event leaderboard ranking** faz o mesmo dentro de um evento à sua escolha.
Ambos são progressivos: o fã inicia a missão e ela é concluída assim que ele atinge a posição.
As missões de posição são os dois modelos desta página que mais merecem uma data de expiração, porque uma posição diz respeito a uma temporada. Veja [Antes de publicar](/docs/quests/templates#before-you-publish).
Escolha uma posição que mais do que um punhado de fãs consiga alcançar. Um top 100 paga a cem pessoas. Um top 3 paga a três. Veja [Classificações](/docs/leaderboards).
## Join events [#join-events]
Conta os eventos em que um fã participou, seja qual for o resultado. Use para encher um evento que acabou de abrir, ou como uma missão para a temporada inteira do tipo «participe em três destes». Veja [Eventos](/docs/events).
## Own collectibles [#own-collectibles]
É concluído assim que o fã tem um certo número de objetos no inventário. Quaisquer objetos, contados em conjunto.
Se quer uma missão que só os fãs com um objeto colecionável específico possam concluir, isso é um requisito de missão, e não este modelo. Veja [Criar uma missão](/docs/quests/creating) e [Objetos colecionáveis e personalização](/docs/rewards/collectibles).
## Os modelos de visita nas páginas de redes sociais [#the-visit-templates-on-the-social-pages]
Outros quatro modelos funcionam exatamente como o Visit link.
| Modelo | Onde está documentado |
| --------------------------------------------------------- | ----------------------------------------------------------------- |
| Visit a Facebook page (visitar uma página do Facebook) | [Facebook, Instagram, TikTok](/docs/quests/templates/social/meta) |
| Visit an Instagram page (visitar uma página do Instagram) | [Facebook, Instagram, TikTok](/docs/quests/templates/social/meta) |
| View an Instagram post (ver uma publicação do Instagram) | [Facebook, Instagram, TikTok](/docs/quests/templates/social/meta) |
| View a TikTok post (ver uma publicação do TikTok) | [Facebook, Instagram, TikTok](/docs/quests/templates/social/meta) |
# Modelos de missão (/pt/docs/quests/templates)
Um modelo define o que a plataforma observa, o que conta como prova e que campos tem de preencher antes de poder publicar.
Tudo o resto numa missão é igual, seja qual for o modelo escolhido: o título, a descrição, a imagem, a recompensa, o agendamento, os requisitos de acesso. Tudo isso está em [Criar uma missão](/docs/quests/creating).
O modelo de uma missão e a respetiva recompensa não podem ser editados depois de a missão existir, em rascunho ou publicada. Tudo o resto continua editável. Se escolheu o modelo errado, duplique a missão e comece de novo. Veja [Gerir missões](/docs/quests/managing).
## As famílias [#the-families]
Mais de 150 modelos. O seletor agrupa-os em Actions, Answers, Social e Gaming, e acrescenta modelos on-chain para as comunidades que ativaram a associação de carteira.
Visitar um link, alcançar um nível, ter um saldo, convidar um amigo, participar num evento.
Quiz, sondagem, prognóstico, texto livre, envio de imagem, e-mail, carteira.
Verificações de saldo de tokens e de NFTs em redes EVM e na Solana.
### Social [#social]
| Página | Modelos | O que pode pedir |
| ----------------------------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| [X](/docs/quests/templates/social/x) | 9 | Seguir, gostar, republicar, citar, publicar com uma hashtag ou um link, e três verificações no perfil do próprio fã. |
| [Discord](/docs/quests/templates/social/discord) | 2 | Entrar no seu servidor, ou ter um cargo nele. |
| [YouTube](/docs/quests/templates/social/youtube) | 2 | Visitar um canal, ver um vídeo. A subscrição e o gosto foram retirados. |
| [Twitch](/docs/quests/templates/social/twitch) | 3 | Seguir, subscrever, ver uma transmissão em direto durante um número de horas. |
| [Facebook, Instagram, TikTok](/docs/quests/templates/social/meta) | 4 | Visitar uma página, ver uma publicação no Instagram ou no TikTok. |
| [Spotify](/docs/quests/templates/social/spotify) | 3 | Seguir um artista ou uma playlist, ou estar entre os ouvintes regulares de um artista. |
### Gaming [#gaming]
| Página | Modelos | O que pode pedir |
| -------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------- |
| [Steam](/docs/quests/templates/gaming/steam) | 3 | Horas jogadas, horas num jogo específico, adicionar um jogo à lista de desejos. |
| [Counter-Strike 2](/docs/quests/templates/gaming/cs2) | 19 | Partidas, vitórias, taxa de vitórias, eliminações, tiros na cabeça, MVPs, bombas, dano, dinheiro. |
| [Dota 2](/docs/quests/templates/gaming/dota-2) | 11 | Last hits, denies, dano a torres, eliminações, assistências, posição no ranking, vitórias com um herói. |
| [FACEIT](/docs/quests/templates/gaming/faceit) | 9 | ELO, nível de habilidade, participação num hub e posição nele, e cinco estatísticas de CS2. |
| [Riot Games](/docs/quests/templates/gaming/riot-games) | Página geral | Associação de contas, regiões e reinícios de temporada que se aplicam aos três jogos da Riot. |
| [League of Legends](/docs/quests/templates/gaming/league-of-legends) | 23 | ARAM, classificativas, objetivos de lane, eliminações, torres, wards, monstros épicos. |
| [Valorant](/docs/quests/templates/gaming/valorant) | 18 | Eliminações por zona atingida, Spikes plantadas e desarmadas, utilizações de habilidades, tempo de jogo. |
| [Teamfight Tactics](/docs/quests/templates/gaming/teamfight-tactics) | 4 | Vitórias, taxa de vitórias, atingir uma posição no ranking, subir no ranking. |
| [World of Warcraft](/docs/quests/templates/gaming/world-of-warcraft) | 16 | PVP, dungeons, raids, nível da personagem, Renown, achievements. |
## Os quatro formatos [#the-four-shapes]
O formato que publica muda o aspeto do cartão e o tempo que a missão demora a ser concluída.
| Formato | O fã | Modelos que funcionam assim |
| ----------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Um único toque | Abre a missão, faz o que foi pedido e prime para concluir | Visitas a links, a maioria dos modelos sociais, verificações de nível e de saldo, verificações de posição no ranking e de conquistas em jogos, saldos on-chain |
| Começar e voltar depois | Prime para começar, joga ou vê, e volta quando o contador enche | Modelos de gaming que contam partidas, vitórias ou horas, ver uma transmissão em direto na Twitch, adquirir tokens, modelos de classificação e de evento |
| Enviar algo | Escreve, escolhe ou envia um valor | Quiz, sondagem, resposta, texto, imagem, e-mail, carteira, prognóstico |
| Nada | A missão conclui-se sozinha | Auto complete, Membership referral count |
Nada conta antes de o fã premir para começar. Uma missão do segundo formato ignora tudo o que aconteceu antes, pelo que um fã que jogou dez partidas, viu duas horas ou comprou os tokens antes de a abrir começa do zero, e a descrição é o único sítio onde o pode avisar.
## Modelos que exigem uma conta associada [#templates-that-need-a-linked-account]
Associar uma conta é diferente de iniciar sessão. O fã inicia sessão uma vez, depois associa as contas de que as suas missões precisam, e o cartão da missão mostra a etapa de associação numa linha própria até ficar verde.
| Conta | Necessária para | Modelos |
| --------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- |
| X | Todos os modelos do X | [X](/docs/quests/templates/social/x) |
| Discord | Os dois modelos do Discord | [Discord](/docs/quests/templates/social/discord) |
| Twitch | Seguir, subscrever e ver uma transmissão em direto | [Twitch](/docs/quests/templates/social/twitch) |
| Spotify | Os três modelos do 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 | Os nove modelos da FACEIT | [FACEIT](/docs/quests/templates/gaming/faceit) |
| Carteira EVM | Saldos de ERC-20, de ERC-20 em staking, de ERC-721 e de token nativo | [On-chain](/docs/quests/templates/on-chain) |
| Carteira Solana | Saldos de NFTs da Solana | [On-chain](/docs/quests/templates/on-chain) |
Nada em Actions ou Answers exige associação. Os modelos de Facebook, Instagram, TikTok e YouTube também não, porque registam o clique em vez de ler uma conta.
Há três coisas que correm mal aqui com frequência suficiente para justificar algum planeamento.
A conta tem de estar ativada para a sua comunidade. As contas que um fã pode associar são uma definição de cada comunidade, e uma missão cuja conta está desativada não pode ser concluída por ninguém. Veja [Início de sessão](/docs/settings/sign-in).
Riot e Battle.net também precisam de uma região. O fã escolhe um servidor ao associar a conta. Enquanto não escolher, a missão pede-lhe que selecione uma região em vez de começar.
As associações expiram. Quando uma conta associada expira, o cartão pede ao fã que volte a associá-la, e qualquer missão em curso fica a aguardar. Nada se perde, mas um fã que não volta a associar a conta parece, do seu lado, um fã que abandonou a missão.
## Verificação [#verification]
A maioria dos modelos verifica-se sozinha. A plataforma lê a conta associada, a carteira ou o estado da sua própria aplicação, e decide.
A verificação é executada uma vez, quando o fã conclui a missão, e nada volta a ser verificado depois. Um fã que deixa de seguir, sai do seu servidor ou vende o token na semana seguinte fica com o que ganhou. Ponha a missão em recorrência semanal se precisar de que isso seja uma condição contínua, e não algo pontual.
O texto de apresentação nunca é verificado. O nome do artista, o nome de utilizador do canal, o nome do jogo, o símbolo do token, o nome do servidor e o nome do cargo que escreve são o que os fãs leem no cartão, e nada os compara com a conta, o contrato ou o canal que está a ser verificado. Uma gralha aí é visível para todos os fãs e invisível para a verificação.
Dois modelos são revistos por uma pessoa: **envios de texto** e **envios de imagem**. O fã envia, o cartão mostra «Enviada, em revisão», e nada é pago até alguém aprovar. Ambos têm uma opção de aprovação automática que salta a fila e paga no momento do envio. A fila, a exportação em massa e o fluxo de aprovação estão em [Rever envios](/docs/quests/submissions).
Os modelos de visita registam o clique, e não o que aconteceu depois dele. Use quando o clique é o objetivo, e escreva a descrição de modo que o fã saiba o que pretendia.
## Antes de publicar [#before-you-publish]
Leia a linha de objetivo na pré-visualização da missão. É essa a frase que o fã lê, e é a forma mais rápida de detetar um modelo que não é o que queria. Vários modelos ficam lado a lado no seletor e só diferem nessa linha: atingir uma posição no ranking ou subir no ranking, uma taxa com número mínimo de partidas ou a mesma taxa sem mínimo.
Defina uma expiração para tudo o que for sazonal. Uma missão ligada a uma temporada classificativa, a uma classificação, a um evento ou a um patrocinador deve ser despublicada, e não ficar ali a pedir algo que já acabou. Indique o prazo também na descrição, porque a data de expiração remove a missão sem se explicar, e só a descrição pode dizer ao fã quanto tempo tem.
## Missões em várias etapas [#multi-step-quests]
Uma missão em várias etapas reúne várias etapas num único cartão, com uma só recompensa no final, e o fã vê todas as etapas desde o início. É construída no formulário de missão, e não pela escolha de um modelo, pelo que funciona com qualquer modelo que tenha escolhido. Veja [Criar uma missão](/docs/quests/creating) para conhecer os campos e [Missões em várias etapas](/docs/quests/creating#multi-step-quests) para saber quando usar uma.
Os requisitos são outro controlo. Definem se um fã pode ou não concluir a missão, e são tratados em [Criar uma missão](/docs/quests/creating#set-the-advanced-properties).
## Recorrência e sequências [#recurrence-and-streaks]
Por predefinição, uma missão decorre uma só vez. Configure a renovação diária ou semanal e ela regressa a esse ritmo. Um fã que a conclui em renovações consecutivas ganha um bónus de sequência que aumenta a recompensa até um teto que define, e falhar uma renovação faz a sequência voltar a zero. A recorrência funciona com todos os modelos destas páginas, pelo que uma missão Auto complete diária e uma missão semanal de Counter-Strike 2 são ambas normais. Os campos, e o que acontece quando o teto é mal definido, estão em [Criar uma missão](/docs/quests/creating).
## Como pedir um modelo ou um jogo [#asking-for-a-template-or-a-game]
Há três pedidos de modelos em fila de espera. Tudo o resto fica sem data até um parceiro o pedir.
| Pedido | Estado | O que ganharia |
| ------------------------------------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Verificação de gostar e seguir no Instagram | Planeado | Missões do Instagram que verificam a ação em vez da visita. Veja [Facebook, Instagram, TikTok](/docs/quests/templates/social/meta). |
| Mais modelos do Discord | Planeado | Para além de entrar num servidor e ter um cargo. Reações e atividade de mensagens são os dois que os parceiros pedem. |
| Mais modelos da Twitch | Planeado | Para além de seguir, subscrever e tempo de visualização. |
### Novos jogos [#new-games]
As integrações de jogos são desenvolvidas quando um parceiro precisa de uma. Todos os jogos que estão hoje na biblioteca chegaram assim, e os mais recentes vieram de parceiros com uma data de lançamento.
Peça ao seu contacto na FanBase o jogo que pretende. É isso que reordena a lista. Um jogo com API pública e um parceiro por trás é uma questão de semanas. Um jogo sem API pública não pode ser integrado.
O mesmo se aplica a um modelo dentro de um jogo que já tem. Se falta no Counter-Strike 2 a estatística de que a sua campanha precisa, esse é um trabalho muito mais pequeno do que um jogo novo.
### Integrações específicas de um parceiro [#partner-specific-integrations]
Alguns modelos existem para uma única comunidade. Apeiron é o exemplo atual: três modelos, ativados para a comunidade que os pediu e invisíveis em todos os outros sítios. Se tem um jogo próprio, ou o jogo de um parceiro, é essa a forma que o trabalho assume.
# On-chain (/pt/docs/quests/templates/on-chain)
Todos os modelos desta página leem um saldo e nada mais. O fã associa uma carteira, a plataforma vê o que esse endereço tem, e a missão passa ou não passa.
Os objetos ficam guardados na sua comunidade, e não numa blockchain. Os modelos desta página e a própria associação de carteira não são afetados. Veja [Estado das funcionalidades](/docs/status#retired).
## Os modelos [#the-templates]
| Modelo | Passa quando o fã | O que configura |
| ------------------ | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------- |
| Hold ERC-20 | Tem pelo menos a quantidade que definir | A rede, o contrato do token, a quantidade, e o nome e o símbolo do token apresentados aos fãs |
| Hold staked ERC-20 | Tem pelo menos essa quantidade em staking | O mesmo, mais o contrato de staking |
| Acquire ERC-20 | Adiciona a quantidade depois de iniciar a missão | A rede, o contrato do token e a quantidade a adquirir |
| Hold ERC-721 | Tem pelo menos o número que definir de uma coleção | A rede, o endereço da coleção, o número e o nome da coleção |
| Hold native token | Tem pelo menos a quantidade definida da moeda nativa da rede | A rede e a quantidade |
| Hold a Solana NFT | Tem pelo menos o número que definir de uma coleção | A coleção e o número |
### Ter e adquirir [#hold-and-acquire]
Cinco dos seis são um instantâneo. O fã abre a missão, a plataforma lê o saldo dele, e se o saldo atingir o seu número, a missão é concluída. Um fã que já se qualifica conclui com um único toque.
**Acquire ERC-20** é a exceção. O modelo regista um instantâneo do saldo do fã quando ele prime para começar, e é concluído assim que ele adiciona a quantidade definida por cima disso. Um fã com mil tokens que inicia uma missão de aquisição de cem precisa de mil e cem para a concluir, e um fã que compra antes do instantâneo não comprou nada que a missão consiga ver. Diga isso na descrição.
## Contas que o fã associa [#accounts-the-fan-links]
Nas redes EVM, o fã associa uma carteira e assina uma mensagem para provar que controla o endereço. Sem transação e sem taxa de gas. O ecrã de consentimento diz o que a aplicação pode fazer, que é ler dados públicos da rede. A Solana funciona da mesma forma, só de leitura, através da Phantom, da Solflare ou da Backpack.
A associação de carteira EVM e a de carteira Solana são definições separadas e ambas vêm desativadas por predefinição, pelo que ativar uma não ativa a outra. Veja [Início de sessão](/docs/settings/sign-in).
## Como acertar na configuração [#getting-the-configuration-right]
A rede e o contrato são a verificação inteira. Um endereço de contrato da rede errada parece correto e não corresponde a nada. Cole o endereço a partir de um explorador de blocos da rede que quer usar, e não de um resultado de pesquisa.
O nome e o símbolo do token não são lidos do contrato. Tem de os escrever, e são [texto de apresentação](/docs/quests/templates#verification), tal como o nome da coleção nos modelos de NFT.
As quantidades são as que um fã reconheceria. Indique o número tal como aparece numa carteira, e não na unidade mais pequena do token.
As testnets são uma definição separada. As comunidades que precisam de ensaiar numa rede de teste podem pedir a ativação. Fale com o seu contacto na FanBase em vez de apontar uma missão em produção para um contrato de teste.
# Respostas e envios (/pt/docs/quests/templates/submission)
Oito modelos que pedem ao fã que envie algo de volta, em vez de observarem algo que ele fez. Seis concluem-se sozinhos e dois vão para uma fila de revisão.
| Modelo | O fã | O que configura | Revisão |
| ------------------------ | -------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------ |
| Quiz | Escolhe uma opção de uma lista | As opções, e qual delas é a correta | Não |
| Poll (sondagem) | Escolhe uma opção de uma lista | As opções, e se os resultados ficam privados | Não |
| Answer (resposta) | Escreve uma resposta | A resposta correta, a distinção entre maiúsculas e minúsculas, a correspondência exata | Não |
| Text (texto) | Escreve um texto livre | A aprovação automática, ativada ou não | Sim, exceto com aprovação automática |
| Image (imagem) | Envia uma imagem | A aprovação automática, ativada ou não | Sim, exceto com aprovação automática |
| Email (e-mail) | Escreve um endereço de e-mail | A orientação, na descrição | Não |
| Wallet (carteira) | Cola um endereço de carteira | A orientação, na descrição | Não |
| Prediction (prognóstico) | Escolhe um resultado antes do bloqueio | As opções e a hora de bloqueio | Não, o resultado é definido por si |
## Quiz [#quiz]
Uma pergunta com uma lista de opções e exatamente uma resposta certa. O fã escolhe uma e envia.
A correção é feita no servidor, por isso a resposta correta nunca é enviada para o dispositivo do fã e não pode ser extraída da aplicação. Uma resposta errada faz a tentativa falhar. O limite de tentativas da missão define se o fã pode tentar de novo, e um quiz com uma única tentativa e uma pergunta difícil vai gerar mensagens para o suporte.
Só uma opção pode ser a correta. Se a sua pergunta tem duas respostas defensáveis, use uma sondagem ou um envio de resposta.
## Poll [#poll]
A mesma lista de opções, sem resposta certa. Todos os fãs que votam concluem a missão.
Os resultados aparecem em percentagem e em número de votos depois de o fã enviar. Ative **private** (privado) e os resultados ficam ocultos para os fãs. Use quando pergunta algo para agir com base na resposta, e não para publicar.
## Answer [#answer]
Uma adivinha, ou um código lido em voz alta numa transmissão em direto. O fã escreve e a plataforma compara com a resposta que guardou.
Duas opções mudam o rigor da comparação.
| Definição | Desativada | Ativada |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| Case sensitive (distinguir maiúsculas de minúsculas) | Fanbase, FANBASE e fanbase passam | Só passa a grafia de maiúsculas e minúsculas que escreveu |
| Match exactly (correspondência exata) | Uma resposta que contém o seu texto passa, pelo que o fã pode responder com uma frase | O envio inteiro tem de ser igual à sua resposta, carácter a carácter |
As duas desativadas formam a combinação tolerante e a predefinição certa para tudo o que o fã escreve de memória. As duas ativadas servem para um código, e vão rejeitar um fã que cola o código com um espaço no fim, por isso diga na descrição que o código é exato.
## Text [#text]
Escrita livre. Um comentário, uma opinião polémica, uma legenda, cem palavras sobre a razão por que a camisola deveria ficar com ele.
O fã envia pelo menos três caracteres. Por predefinição, o envio vai para a fila de revisão e nada é pago até alguém da sua equipa aprovar. Ative **auto approve** (aprovação automática) e o fã recebe no momento em que prime enviar.
A aprovação automática numa missão de texto paga por qualquer coisa, incluindo três caracteres sem sentido. Use quando a recompensa é pequena e o objetivo é a participação. Deixe desativada quando a recompensa é suficientemente boa para atrair abusos, e reserve o tempo de revisão antes de publicar.
## Image [#image]
Um carregamento. Uma fan art, uma foto do dia de jogo, uma captura de ecrã de um resultado, um comprovativo de compra.
Uma imagem por envio, arrastada ou selecionada. O cartão mostra «Enviada, em revisão» até alguém decidir, e o fã recebe uma notificação nos dois casos. **Auto approve** também está disponível aqui e traz o mesmo aviso do texto, e uma missão de imagem costuma pagar mais.
As rejeições podem incluir uma nota para o fã, a dizer o que corrigir. A fila e a exportação em massa estão em [Rever envios](/docs/quests/submissions).
## Email [#email]
Um único campo de e-mail, validado como endereço de e-mail antes de ser aceite.
Não há nada para configurar. Tudo o que o fã precisa de saber vai na descrição, incluindo para que vai usar o endereço. Os envios saem do painel de administração juntamente com todos os outros.
## Wallet [#wallet]
Um único campo de texto que aceita um endereço EVM: 40 caracteres hexadecimais, com ou sem o `0x` inicial. Qualquer outra coisa é rejeitada na aplicação.
Este modelo serve para whitelists e listas de airdrop. Não associa uma carteira à conta do fã nem verifica nenhum saldo, pelo que um fã pode escrever um endereço que não é dele. Se precisa de uma carteira verificada pela plataforma, isso é a associação de carteira e os [modelos on-chain](/docs/quests/templates/on-chain).
## Prognósticos [#predictions]
Um prognóstico tem um prazo e uma resposta certa, o que nenhuma outra família aqui tem, e por isso tem [a sua própria página](/docs/predictions).
# Counter-Strike 2 (/pt/docs/quests/templates/gaming/cs2)
Todos os modelos desta página leem as estatísticas do modo Competitivo, e esses mesmos números podem ser farmados contra bots. É por isso que a FACEIT existe como alternativa.
Todos os modelos exigem que o fã [associe a conta da Steam](/docs/quests/templates#templates-that-need-a-linked-account).
A API de estatísticas é fiável no modo Competitivo. Os outros modos comunicam dados de forma inconsistente, por isso um fã que joga sem parar em Casual pode fazer tudo o que pediu e não ver nada a mexer-se. Escreva «em Competitivo» na descrição.
As eliminações de bots contam. Entram nos mesmos totais, o que significa que um fã que queira farmar uma missão de número de eliminações consegue fazê-lo. Parta do princípio de que os números mais altos do seu quadro vão ser alcançados assim.
A FACEIT evita os dois problemas. O mesmo tipo de missão feito pela [FACEIT](/docs/quests/templates/gaming/faceit) é jogado numa fila competitiva a sério, sem qualquer bot. Use a FACEIT para qualquer missão com uma recompensa que valha a pena farmar.
## Desempenho nas rondas [#round-performance]
| Modelo | O que o fã vê | O que define |
| -------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------- |
| Games played | Jogar um número de partidas | Partidas |
| Games won | Vencer um número de partidas | Partidas |
| Win rate | Uma meta de taxa de vitórias | Meta de taxa de vitórias |
| Win rate per games | Jogar pelo menos um número de partidas e manter uma taxa de vitórias acima da sua meta | Mínimo de partidas, meta de taxa de vitórias |
| Pistol rounds | Vencer um número de rondas de pistolas | Rondas de pistolas |
| MVP titles | Conquistar um número de títulos de MVP | Títulos de MVP |
| MVP titles per games | Conquistar um número de títulos de MVP | Títulos de MVP |
| Total MVPs | Um total de MVPs | Total de MVPs |
## Objetivos da ronda [#round-objectives]
| Modelo | O que o fã vê | O que define |
| ------------- | -------------------------------------- | ------------ |
| Bombs planted | Plantar um número de bombas | Bombas |
| Damage dealt | Causar uma quantidade de dano | Dano |
| Money earned | Ganhar uma quantia de dinheiro no jogo | Dinheiro |
Os modelos de objetivo são os que recompensam jogar bem a ronda em vez de andar só atrás de eliminações, por isso combinam com uma comunidade que joga em conjunto. Um fã só pode plantar quando está do lado T, por isso defina o número a pensar numa sessão real, e não numa contagem de rondas.
## Desempenho em eliminações [#kill-performance]
| Modelo | O que o fã vê | O que define |
| --------------------- | --------------------------------------------------------------------------------------------- | -------------------------------- |
| Kill count | Conseguir um número total de eliminações | Eliminações |
| Kill count per games | Eliminar um número de inimigos | Eliminações |
| K/D ratio | Jogar pelo menos um número de partidas e manter um K/D acima da sua meta | Mínimo de partidas, meta de K/D |
| Kills to deaths ratio | Manter um K/D acima da sua meta | Meta de K/D |
| Headshot kills | Conseguir um número de eliminações com tiro na cabeça | Eliminações com tiro na cabeça |
| Headshot rate | Jogar pelo menos um número de partidas e manter uma taxa de tiros na cabeça acima da sua meta | Mínimo de partidas, meta da taxa |
| Enemy weapon kills | Conseguir eliminações com armas apanhadas aos inimigos | Eliminações |
| Knife kills | Conseguir um número de eliminações com faca | Eliminações com faca |
As eliminações com faca e com armas inimigas são lentas, por isso pague bem por elas.
## Os modelos em par [#the-paired-templates]
Quatro estatísticas aparecem duas vezes no seletor: eliminações, títulos de MVP, taxa de vitórias e K/D. Os pares leem a mesma estatística de base e diferem no que pode definir. Um modelo de cada par aceita um **número mínimo de partidas** além da meta, e é isso que impede um fã de concluir uma missão de K/D à custa de uma única ronda de sorte.
Quando existir um par, escolha o modelo que permite definir um número mínimo de partidas e depois [leia a linha de objetivo na pré-visualização](/docs/quests/templates#before-you-publish) para confirmar que escolheu esse.
## Como montar um quadro de Counter-Strike [#writing-a-counter-strike-board]
As missões de taxa precisam de um mínimo. Uma meta de taxa de vitórias ou de K/D sem mínimo de partidas é uma moeda ao ar, e um fã vai concluir a missão por acaso. Dez partidas é um mínimo razoável para qualquer missão que pague com algo de valor real.
Os totais combinam com missões diárias, as taxas com missões semanais. «Consiga 30 eliminações» é uma sessão. «Mantenha um K/D de 1,2 em 20 partidas» é uma semana.
Todos os modelos desta página são progressivos, por isso [nada conta antes do início](/docs/quests/templates#the-four-shapes).
Uma missão ligada a um evento ou a um patrocinador não deve durar mais do que ele. Veja [Antes de publicar](/docs/quests/templates#before-you-publish).
# Dota 2 (/pt/docs/quests/templates/gaming/dota-2)
Onze modelos na mesma associação à Steam que o Counter-Strike 2 usa.
Ranked All-pick é o modo que estes modelos leem de forma fiável. Um fã que joga Turbo ou um modo de evento pode fazer tudo o que a missão pede e não ver nada a mexer-se, por isso ponha o modo na descrição.
## Objetivos [#objectives]
| Modelo | O que o fã vê | O que define |
| ------------------ | -------------------------------------------------------------------------------------- | -------------------------------------------- |
| Tower damage | Causar uma quantidade de dano às torres inimigas | Dano |
| Sentry wards | Comprar um número de sentry wards | Sentry wards |
| Win rate per games | Jogar pelo menos um número de partidas e manter uma taxa de vitórias acima da sua meta | Mínimo de partidas, meta de taxa de vitórias |
## Desempenho na lane [#lane-performance]
| Modelo | O que o fã vê | O que define |
| ------------------- | -------------------------------------------------------------- | -------------------------------------- |
| Last hits | Conseguir um número de last hits | Last hits |
| Last hits per games | Ter uma média de last hits em pelo menos um número de partidas | Média de last hits, mínimo de partidas |
| Denies | Conseguir um número de denies | Denies |
Last hits per games é o melhor dos dois modelos de last hits para qualquer missão por que esteja a pagar, porque um total recompensa jogar muito e uma média recompensa jogar bem.
## Desempenho em eliminações [#kill-performance]
| Modelo | O que o fã vê | O que define |
| --------- | ------------------------------------------------------------------------ | ------------------------------- |
| Kills | Eliminar um número de inimigos | Eliminações |
| Assists | Conseguir um número de assistências | Assistências |
| K/D ratio | Jogar pelo menos um número de partidas e manter um K/D acima da sua meta | Mínimo de partidas, meta de K/D |
Num jogo em que os supports fazem a maior parte do trabalho e não aparecem em nenhuma contagem de eliminações, uma missão de assistências é a que os seus jogadores de support conseguem ganhar.
## Ranking e heróis [#rank-and-heroes]
| Modelo | O que o fã vê | O que define |
| --------------- | ------------------------------------------------------------ | ------------------------------- |
| Rank | Alcançar uma posição no ranking | A posição pretendida no ranking |
| Win with a hero | Vencer um número de partidas a jogar com um herói específico | Herói, vitórias |
**Rank** verifica onde o fã está, por isso um fã que já está na sua meta conclui a missão assim que a inicia. Use este modelo para identificar um escalão da sua comunidade, e não para fazer alguém subir.
**Win with a hero** pede vitórias com um herói à sua escolha: vencer três partidas com o herói pelo qual o seu jogador é conhecido, vencer três com o que foi banido na última série. É o modelo a usar com um patrocinador, porque nomeia uma coisa em vez de um número.
Escolha o herói a pensar na fila do fã. Um herói banido na maioria das partidas com MMR elevado resulta numa missão que os seus melhores jogadores não conseguem concluir.
## Como montar um quadro de Dota [#writing-a-dota-board]
Todos os modelos de contagem desta página são [progressivos](/docs/quests/templates#the-four-shapes). Rank é a exceção, e lê onde o fã já está.
As partidas são longas. Uma missão que pede dez vitórias ocupa as noites de uma semana inteira a alguém, e deve pagar em conformidade.
As missões de taxa precisam de um mínimo. Defina um número mínimo de partidas em qualquer modelo com meta de média ou de rácio, ou uma única partida boa conclui a missão.
Sentry wards é o modelo de wards da biblioteca. Não estão planeados outros modelos de wards ou de gemas.
# FACEIT (/pt/docs/quests/templates/gaming/faceit)
A alternativa competitiva a ler as estatísticas de Counter-Strike 2 através da Steam. As partidas da FACEIT são jogadas numa fila a sério, sem qualquer bot.
Todos os modelos exigem que o fã [associe a conta da FACEIT](/docs/quests/templates#templates-that-need-a-linked-account).
## Missões de hub [#hub-quests]
| Modelo | Passa quando o fã | O que define |
| ----------------------- | --------------------------------------------- | --------------------------------------- |
| ELO | Alcança uma pontuação de ELO | Meta de ELO |
| Skill level | Alcança um nível de habilidade | Meta de nível de habilidade, de 1 a 10 |
| Hub membership | É membro do seu hub | ID do hub |
| Hub leaderboard ranking | Alcança uma posição numa classificação do hub | ID da classificação, posição pretendida |
**Hub membership** é o modelo a publicar primeiro se gerir um hub. É uma verificação única.
**ELO e Skill level** leem onde o fã já está. Um fã acima da sua meta conclui estas missões de imediato. Use estes modelos para dividir a sua comunidade em escalões.
**Hub leaderboard ranking** precisa de um ID de classificação, que obtém no URL da classificação depois de a configurar na FACEIT. Não há forma de consultar esse ID no painel de administração, por isso configure primeiro a classificação.
As classificações funcionam por temporadas e as missões não, por isso [defina uma data de expiração](/docs/quests/templates#before-you-publish) em qualquer missão de classificação e ponha na descrição as datas da classificação e o prazo para reivindicar. Um fã que alcança a posição e volta para reivindicar depois de a missão ter expirado tem uma queixa que não há forma de resolver.
## Counter-Strike 2 na FACEIT [#counter-strike-2-on-faceit]
| Modelo | O que o fã vê | O que define |
| -------------- | -------------------------------------- | --------------- |
| Kill count | Eliminar um número de inimigos | Eliminações |
| MVP count | Conseguir um número de MVPs | MVPs |
| Headshot count | Conseguir um número de tiros na cabeça | Tiros na cabeça |
| Assists | Conseguir um número de assistências | Assistências |
| Matches won | Vencer um número de partidas | Partidas |
Cinco estatísticas contra as dezanove de [Counter-Strike 2](/docs/quests/templates/gaming/cs2), e a troca compensa sempre que a recompensa valha a pena farmar.
Os cinco são [progressivos](/docs/quests/templates#the-four-shapes).
## Como escolher entre FACEIT e Steam [#choosing-between-faceit-and-steam]
| O que pretende | Use |
| ------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Um prémio grande, um patrocinador, qualquer coisa competitiva | FACEIT |
| Uma estatística que a FACEIT não cobre, como eliminações com faca ou bombas plantadas | [Counter-Strike 2](/docs/quests/templates/gaming/cs2) |
| Chegar a fãs que jogam Counter-Strike, mas não na FACEIT | Counter-Strike 2 |
| Montar um quadro de missões em torno do seu próprio hub | FACEIT |
Usar os dois é normal. O formato habitual é um quadro da Steam amplo e barato para toda a gente, com duas ou três missões da FACEIT com recompensas a sério por cima.
## Associação, e de onde vêm os IDs [#linking-and-where-the-ids-come-from]
A associação da FACEIT vem desativada por predefinição. Peça ao seu contacto na FanBase que a ative. Veja [Início de sessão](/docs/settings/sign-in).
Os IDs de hub e os IDs de classificação vêm dos URLs da FACEIT. Copie-os da barra de endereço em vez de os voltar a escrever. Um ID errado falha para todos os fãs, incluindo os que já estão no hub.
# League of Legends (/pt/docs/quests/templates/gaming/league-of-legends)
Vinte e três modelos, a maior biblioteca de jogo da plataforma.
Todos os modelos exigem uma conta da Riot associada com uma região selecionada. Leia primeiro [Riot Games](/docs/quests/templates/gaming/riot-games) para saber mais sobre associação, reinícios de temporada e limites de pedidos.
## ARAM [#aram]
| Modelo | O que o fã vê | O que define |
| ------------------- | ------------------------------------------------------- | ------------- |
| High damage in ARAM | Ser quem causa mais dano num número de partidas de ARAM | Partidas |
| Dodge skillshots | Desviar-se de um número de skillshots em ARAM | Skillshots |
| Pentakill in ARAM | Conseguir um número de pentakills em ARAM | Pentakills |
| S grade in ARAM | Receber nota S ou superior um número de vezes em ARAM | Vezes |
| Snowballs | Acertar com um número de bolas de neve em campeões | Bolas de neve |
Comece por aqui. O ARAM é uma só fila, vinte minutos, sem a pressão das classificativas e sem a tensão das séries de promoção, o que faz destas as missões que a parte mais ampla da sua comunidade vai concluir.
## Desempenho geral [#general-performance]
| Modelo | O que o fã vê | O que define |
| --------------- | ------------------------------------------------------------------------------ | -------------------------------------------- |
| Wins | Vencer um número de partidas classificativas | Vitórias |
| Win rate | Jogar mais de um número de partidas com uma taxa de vitórias acima da sua meta | Mínimo de partidas, meta de taxa de vitórias |
| Ranked duo wins | Vencer um número de partidas classificativas em duo | Vitórias em duo |
| Reach a rank | Alcançar um tier e uma divisão nesta temporada | Tier, divisão |
| Improve rank | Subir até um tier e uma divisão | Tier, divisão |
| S minus grade | Receber nota S menos um número de vezes em Summoner's Rift | Vezes |
**Reach a rank** fica concluído para um fã que já lá está. **Improve rank** pede que ele suba até lá. Os dois são quase idênticos no seletor e são missões muito diferentes, por isso [leia a linha de objetivo na pré-visualização](/docs/quests/templates#before-you-publish).
**Ranked duo wins** pede que os fãs encontrem alguém com quem jogar.
## Desempenho na lane [#lane-performance]
| Modelo | O que o fã vê | O que define |
| -------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------- |
| Turrets before plates fall | Destruir um número de torres antes de as plates caírem | Torres |
| Early takedowns | Conseguir um número de participações em eliminações no início da partida | Participações em eliminações no início da partida |
| Invade the enemy jungle | Eliminar um número de monstros na jungle inimiga | Monstros |
| Turret takedowns | Destruir um número de torres | Torres |
| Ward takedowns | Destruir um número de wards | Wards |
Ward takedowns é a missão dos supports e dos junglers. Turrets before plates fall é uma missão de lane com um teto de habilidade real, e merece uma recompensa a sério.
## Desempenho em eliminações [#kill-performance]
| Modelo | O que o fã vê | O que define |
| ------------------- | ------------------------------------------------------------------------ | ------------------ |
| Kills | Eliminar um número de campeões inimigos | Eliminações |
| Assists | Conseguir um número de assistências | Assistências |
| Solo kills | Conseguir um número de eliminações a solo | Eliminações a solo |
| First blood | Conseguir o first blood da partida um número de vezes | First bloods |
| Pentakill | Conseguir um número de pentakills | Pentakills |
| Epic monster kills | Eliminar um número de monstros épicos até 30 segundos depois de surgirem | Monstros épicos |
| Steal epic monsters | Roubar um número de monstros épicos | Monstros épicos |
Pentakill e Steal epic monsters são os dois modelos que devem levar as suas maiores recompensas de League. Nenhum dos dois pode ser farmado.
Assists é o modelo a combinar com eles, porque um quadro em que todas as recompensas estão nas missões de eliminações diz a metade da sua comunidade que as missões não são para ela.
## Alterações no jogo [#game-changes]
Alguns destes modelos dependem de mecânicas que a Riot alterou ao longo dos anos, e a Riot muda o jogo a cada temporada. Trabalhe a partir dos modelos que o seletor do painel de administração oferece, e não de uma lista escrita para um patch anterior.
## Como montar um quadro de League [#writing-a-league-board]
Os reinícios de temporada são o maior risco. Veja [Riot Games](/docs/quests/templates/gaming/riot-games#season-resets).
Todos os modelos de contagem desta página são [progressivos](/docs/quests/templates#the-four-shapes). Reach a rank é a exceção, e lê onde o fã já está.
Divida o quadro por fila. Missões de ARAM para toda a gente, missões classificativas para os jogadores que já jogam nessa fila de qualquer forma. Um quadro só de classificativas exclui a maior parte de uma comunidade; um quadro só de ARAM não tem nada para os seus melhores jogadores.
# Riot Games (/pt/docs/quests/templates/gaming/riot-games)
League of Legends, Teamfight Tactics e Valorant estão todos por trás de uma única associação à Riot.
23 modelos. ARAM, classificativas, fase de lanes, eliminações, torres, wards, monstros épicos.
18 modelos. Eliminações por zona atingida, objetivos da Spike, utilizações de habilidades, tempo de jogo.
4 modelos. Vitórias, taxa de vitórias, alcançar uma posição no ranking, subir no ranking.
## Associação, e a região [#linking-and-the-region]
O fã associa a conta da Riot e depois escolhe uma região. Os dois passos são obrigatórios. Um fã que associa a conta sem escolher um servidor vê a missão pedir uma região antes de poder começar.
A associação da Riot vem desativada por predefinição. Veja [Início de sessão](/docs/settings/sign-in).
O acesso à API da Riot é aprovado por comunidade, e não para a plataforma no seu todo, e a aprovação leva tempo. Se as missões da Riot fazem parte do seu plano de lançamento, fale com o seu contacto na FanBase no início do onboarding, e não na semana anterior ao lançamento.
## Reinícios de temporada [#season-resets]
As estatísticas dos jogadores voltam a zero quando começa uma temporada classificativa. Uma missão publicada antes de um reinício pede um progresso que está prestes a ser apagado, e um fã que vai a meio perde a metade que já tinha feito.
Qualquer missão da Riot que se refira ao progresso nas classificativas precisa de uma data de expiração. Veja [Antes de publicar](/docs/quests/templates#before-you-publish).
As missões de ranking são o caso mais crítico, já que a posição de um fã no ranking volta a uma posição provisória, e não a zero, mas os totais de vitórias e as taxas de vitórias também são afetados.
## Limites de pedidos [#rate-limits]
A API da Riot tem um limite de pedidos, e a quota é atribuída por comunidade, e não partilhada por toda a plataforma. Para a maioria das comunidades, isto nunca chega a ser um problema.
Torna-se um problema quando uma comunidade grande tem muitas missões da Riot a decorrer ao mesmo tempo, porque cada missão ativa consulta o histórico de partidas de cada fã que a iniciou. O sintoma é um progresso que se atualiza devagar.
Se vai lançar um quadro carregado de missões da Riot para um público grande, planeie-o antes com o seu contacto na FanBase. Publique as missões da Riot por vagas, e não vinte de uma vez, e prefira um número pequeno de missões com recompensas a sério a uma parede delas.
# Steam (/pt/docs/quests/templates/gaming/steam)
Três modelos usam diretamente a associação à Steam, e todos os modelos de Counter-Strike 2 e Dota 2 também a usam.
| Modelo | O fã | O que configura |
| -------------------- | ------------------------------------------------------- | ----------------------------------- |
| Play any Steam game | Joga qualquer coisa na Steam durante um número de horas | Horas jogadas |
| Play a specific game | Joga um jogo específico durante um número de horas | App ID, nome do jogo, horas jogadas |
| Wishlist a game | Adiciona o jogo à sua lista de desejos na Steam | App ID, nome do jogo |
Os dois modelos de tempo de jogo são [progressivos](/docs/quests/templates#the-four-shapes), e esse é o motivo mais comum para um fã lhe dizer que uma missão da Steam não funciona: jogou primeiro e só depois iniciou a missão. Ponha isto na descrição.
O perfil da Steam do fã tem de ser público, e os detalhes dos jogos também. Um perfil privado é associado sem erro e depois não comunica nada, por isso a missão fica a zero para sempre, sem explicação no cartão. A aplicação mostra um aviso sobre isto. Repita o aviso na sua descrição.
## Como encontrar o App ID [#finding-the-app-id]
Abra a página do jogo na loja da Steam e leia o URL.
```
https://store.steampowered.com/app/730/CounterStrike_2/
```
`730` é o App ID. O nome do jogo que vem a seguir é o que também deve escrever na missão, para que os fãs vejam um nome em vez de um número. Esse nome é [texto de apresentação](/docs/quests/templates#verification); o App ID é o que a verificação lê.
Se errar o App ID, a missão acompanha outro jogo, em silêncio e sem erro. Um fã que joga o jogo que pretendia não faz nenhum progresso. Confirme-o na página da loja antes de publicar.
## Lista de desejos [#wishlisting]
Uma missão de um só toque, e não progressiva. O fã toca para abrir a página da loja, adiciona o jogo, volta e conclui.
Este é o modelo que patrocinadores e editoras pedem pelo nome, porque as listas de desejos antes de um lançamento são o número pelo qual a equipa de marketing deles é avaliada. É também o modelo que mais vale a pena combinar com um prazo, já que uma adição à lista de desejos na semana do lançamento vale mais do que uma feita seis meses antes.
## Tempo de jogo [#playtime]
**Play any Steam game** conta tudo o que está na biblioteca do fã. É a versão com menos atrito, útil como missão semanal para uma comunidade de gaming em que não lhe importa muito o que as pessoas jogam.
**Play a specific game** conta um único App ID. Este é o modelo de patrocínio: uma editora quer horas no jogo dela, basta definir o App ID e as horas, e a recompensa vem dela.
Defina as horas num número que um fã consiga alcançar durante a vida da missão. Dez horas numa recorrência semanal é um compromisso sério; duas é um sábado.
## As bibliotecas de jogos [#the-game-libraries]
Dois jogos têm modelos de estatísticas próprios assentes na associação à Steam.
| Jogo | Modelos | Página |
| ---------------- | ------- | ----------------------------------------------------- |
| Counter-Strike 2 | 19 | [Counter-Strike 2](/docs/quests/templates/gaming/cs2) |
| Dota 2 | 11 | [Dota 2](/docs/quests/templates/gaming/dota-2) |
As missões de Counter-Strike também podem passar pela FACEIT em vez da Steam, o que muda o que é verificável e o que pode ser farmado. Veja [FACEIT](/docs/quests/templates/gaming/faceit).
## Associação e atraso das estatísticas [#linking-and-stat-lag]
A associação da Steam vem desativada por predefinição. Peça ao seu contacto na FanBase que a ative antes de publicar o que quer que seja desta página. Veja [Início de sessão](/docs/settings/sign-in).
As estatísticas da Steam chegam com atraso. São lidas da Steam, e não acompanhadas em tempo real, por isso um fã que termina uma sessão e abre a missão logo a seguir pode ver o progresso um pouco atrasado. Depois atualiza-se.
# Teamfight Tactics (/pt/docs/quests/templates/gaming/teamfight-tactics)
Quatro modelos, e as únicas missões de ranking da Riot fora do League of Legends.
Todos os modelos exigem uma conta da Riot associada com uma região selecionada. Leia primeiro [Riot Games](/docs/quests/templates/gaming/riot-games).
| Modelo | O que o fã vê | O que define |
| ------------ | -------------------------------------------------------------------------------------- | -------------------------------------------- |
| Wins | Vencer um número de partidas classificativas | Vitórias |
| Win rate | Jogar pelo menos um número de partidas e manter uma taxa de vitórias acima da sua meta | Mínimo de partidas, meta de taxa de vitórias |
| Reach a rank | Alcançar um tier e uma divisão nesta temporada | Tier, divisão |
| Improve rank | Subir até um tier e uma divisão | Tier, divisão |
## Reach a rank versus Improve rank [#reach-a-rank-against-improve-rank]
Os dois estão lado a lado no seletor e são missões diferentes.
**Reach a rank** é uma verificação. Um fã que já está na sua meta ou acima dela conclui a missão assim que a inicia, por isso o modelo identifica um escalão da sua comunidade em vez de pôr alguém a jogar.
**Improve rank** pede que o fã suba. Inicia a missão a partir de onde está e conclui-a quando chega à sua meta, o que para um fã dois tiers abaixo significa semanas de jogo.
[A linha de objetivo na pré-visualização](/docs/quests/templates#before-you-publish) é o que distingue os dois depois de a missão estar em rascunho.
## Vencer no Teamfight Tactics [#winning-in-teamfight-tactics]
Entram oito jogadores e as posições finais contam mais do que um resultado binário, por isso «vencer um número de partidas classificativas» é um pedido mais pesado do que o mesmo número seria num jogo de cinco contra cinco. Defina uma meta baixa.
**Win rate** precisa do mínimo de partidas definido, ou um único lobby bom conclui a missão.
Os reinícios de temporada atingem esta página mais do que qualquer outra, porque todos os modelos aqui tratam de ranking. Veja [Riot Games](/docs/quests/templates/gaming/riot-games#season-resets).
# Valorant (/pt/docs/quests/templates/gaming/valorant)
Quase todos os modelos são contadores com um número definido por si, o que faz do número toda a decisão de conceção desta página.
Todos os modelos exigem uma conta da Riot associada com uma região selecionada. Leia primeiro [Riot Games](/docs/quests/templates/gaming/riot-games) para saber mais sobre associação, reinícios de temporada e limites de pedidos.
## Combate [#combat]
| Modelo | O que o fã vê | O que define |
| -------------- | ----------------------------------------------------- | ------------------------------ |
| Total kills | Conseguir um número total de eliminações | Eliminações |
| Headshot kills | Conseguir um número de eliminações com tiro na cabeça | Eliminações com tiro na cabeça |
| Bodyshot kills | Conseguir um número de eliminações com tiro no corpo | Eliminações com tiro no corpo |
| Legshot kills | Conseguir um número de eliminações com tiro na perna | Eliminações com tiro na perna |
| Total deaths | Um total de mortes | Mortes |
| Assists | Conseguir um número de assistências | Assistências |
| Damage dealt | Causar uma quantidade total de dano | Dano |
Legshot kills é o modelo leve que os fãs adoram e que ninguém consegue farmar de propósito.
## Objetivos da Spike e da ronda [#spike-and-round-objectives]
| Modelo | O que o fã vê | O que define |
| ---------------- | ----------------------------------- | ----------------- |
| Plant the spike | Plantar a Spike um número de vezes | Spikes plantadas |
| Defuse the spike | Desarmar a Spike um número de vezes | Spikes desarmadas |
| Team rounds won | Vencer um número de rondas no total | Rondas |
| Team wins | Vencer um número de partidas | Partidas |
| Rounds played | Jogar um número de rondas no total | Rondas |
Plantar e desarmar são os dois modelos que recompensam jogar o objetivo em vez do combate.
## Habilidades [#abilities]
| Modelo | O que o fã vê | O que define |
| ------------------- | ------------------------------------------------- | ------------ |
| Total ability casts | Um número total de utilizações de habilidades | Utilizações |
| Ultimate casts | Usar uma ultimate um número de vezes | Ultimates |
| Grenade casts | Usar uma habilidade de granada um número de vezes | Utilizações |
As missões de habilidades não dependem do agente, por isso um fã pode concluí-las com o agente que mais joga. São também os números mais fáceis de alcançar desta página, por isso mantenha as recompensas pequenas e use estas missões para preencher o dia a dia.
## Atividade [#activity]
| Modelo | O que o fã vê | O que define |
| -------------- | ------------------------------------------- | ------------ |
| Matches played | Jogar um número de partidas | Partidas |
| Playtime | Jogar durante um número de minutos no total | Minutos |
| Total score | Atingir uma pontuação total | Pontuação |
Playtime define-se em minutos, não em horas. Uma missão semanal é um número de três algarismos, e escrever as horas por engano cria uma missão que um fã conclui numa partida.
Não existe modelo de ranking para Valorant. Se quer uma missão de ranking para um jogo da Riot, use [League of Legends](/docs/quests/templates/gaming/league-of-legends) ou [Teamfight Tactics](/docs/quests/templates/gaming/teamfight-tactics).
## Como montar um quadro de Valorant [#writing-a-valorant-board]
Todos os modelos desta página são progressivos, por isso [nada conta antes do início](/docs/quests/templates#the-four-shapes).
É aqui que os limites de pedidos mais pesam. Os modelos de Valorant leem o histórico de partidas, e uma comunidade grande com muitos deles a decorrer ao mesmo tempo é onde a quota por comunidade da Riot se manifesta como progresso lento. Publique por vagas. Veja [Riot Games](/docs/quests/templates/gaming/riot-games#rate-limits).
Os contadores precisam de noção de escala. Calcule quanto tempo dura uma partida classificativa para a sua comunidade e defina a recompensa com base nisso: vinte eliminações é uma noite e duzentas são duas semanas.
# World of Warcraft (/pt/docs/quests/templates/gaming/world-of-warcraft)
Apenas Retail, numa associação à Battle.net que também exige uma região. Cinco dos dezasseis usam uma dungeon, uma raid, um boss, uma expansão ou um achievement específico, e são essas as missões mais fortes da página.
Estes modelos foram criados primeiro para um único parceiro, por isso peça ao seu contacto na FanBase que confirme que estão ativados na sua comunidade antes de planear uma campanha com eles.
## PVP [#pvp]
| Modelo | O que o fã vê | O que define |
| --------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------- |
| Matches played | Jogar um número de partidas PVP | Partidas |
| Matches won | Vencer um número de partidas PVP | Partidas |
| Win rate | Jogar pelo menos um número de partidas PVP e manter uma taxa de vitórias acima da sua meta | Mínimo de partidas, meta de taxa de vitórias |
| Honorable kills | Conseguir um número de honorable kills | Honorable kills |
| Honor level | Alcançar um nível de Honor | Nível de Honor |
Honor level lê onde o fã já está, por isso um fã acima do seu número conclui com um só toque.
## Dungeons e raids [#dungeons-and-raids]
| Modelo | O que o fã vê | O que define |
| ------------------------ | ------------------------------------------------------------------- | ----------------------- |
| Dungeon completion | Concluir uma dungeon específica numa dificuldade | Dungeon, dificuldade |
| Dungeon boss kills | Derrotar um número de bosses de dungeon | Bosses derrotados |
| Raid completion | Concluir uma raid específica numa dificuldade | Raid, dificuldade |
| Raid boss kills | Derrotar um número de bosses de raid | Bosses derrotados |
| Defeat a raid boss | Derrotar um boss específico numa raid específica e numa dificuldade | Boss, raid, dificuldade |
| Any raid in an expansion | Concluir qualquer raid de uma expansão | Expansão |
As dungeons e as raids são aquilo em torno do qual uma comunidade de World of Warcraft se organiza, e quatro dos seis modelos aqui aceitam um nome.
A dificuldade faz parte da verificação. Normal, Heroic e Mythic são missões diferentes com públicos diferentes, e uma missão em Mythic é para uma fração da sua comunidade. Indique a dificuldade no título, não só na configuração, ou os fãs vão presumir que é a mais fácil.
**Any raid in an expansion** é a versão ampla, e a indicada para uma campanha dirigida a jogadores que regressam. Pede uma conclusão de qualquer raid, o que a maior parte de uma comunidade consegue fazer.
## Progressão [#progression]
| Modelo | O que o fã vê | O que define |
| ---------------------- | ------------------------------------------- | --------------- |
| Character level | Alcançar um nível | Nível |
| Renown level | Alcançar um nível de Renown | Nível de Renown |
| Achievements | Concluir um número de achievements | Achievements |
| Achievement points | Acumular um número de pontos de achievement | Pontos |
| A specific achievement | Concluir um achievement específico | O achievement |
**Character level** e **Renown level** são os dois modelos a usar perto de uma nova expansão ou de um novo patch, porque é o que todos os jogadores já estão a fazer de qualquer forma nas duas primeiras semanas.
**A specific achievement** é o equivalente em World of Warcraft da missão de boss específico, e aplica-se o mesmo conselho.
**Achievement points** é um total que o fã já acumulou ao longo de anos de jogo, por isso a maior parte da sua comunidade conclui a missão no momento em que a inicia, a menos que defina um número alto. Trate este modelo como uma forma de encontrar jogadores de longa data.
## Como montar um quadro de World of Warcraft [#writing-a-world-of-warcraft-board]
Todos os modelos de contagem desta página são [progressivos](/docs/quests/templates#the-four-shapes). Os modelos de verificação (nível, Renown, nível de Honor e pontos de achievement) leem o que o fã já tem.
Dê nome às coisas sempre que puder. Uma dungeon, uma raid ou um boss específico diz ao fã exatamente o que tem de ir fazer.
A associação da Battle.net vem desativada por predefinição e funciona da mesma forma que nos jogos da Riot. Veja [Início de sessão](/docs/settings/sign-in).
# Discord (/pt/docs/quests/templates/social/discord)
Os dois modelos exigem que o fã [associe a conta do Discord](/docs/quests/templates#templates-that-need-a-linked-account). Ambos precisam também de IDs do seu próprio servidor.
| Modelo | Passa quando o fã | O que configura |
| -------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------- |
| Join server (entrar no servidor) | É membro do seu servidor | Nome de utilizador apresentado, ID da guilda, convite da guilda |
| Get a role (obter um cargo) | Tem um cargo no seu servidor | Nome de utilizador apresentado, ID da guilda, convite da guilda, ID do cargo, nome do cargo |
## Como encontrar os IDs [#finding-the-ids]
O Discord esconde os dois IDs atrás de uma definição para programadores. Ative-a uma vez e fica ativada.
### Ativar o modo de programador [#turn-on-developer-mode]
No Discord, abra **User Settings** (definições de utilizador), depois **Advanced** (avançadas), e ative **Developer Mode** (modo de programador). Nada muda na sua conta, exceto que passam a aparecer opções de cópia nos menus do botão direito do rato.
### Copiar o ID do servidor [#copy-the-server-id]
Clique com o botão direito do rato no ícone do seu servidor, na barra lateral esquerda, e escolha **Copy Server ID** (copiar ID do servidor). Este é o ID da guilda.
### Copiar o ID do cargo [#copy-the-role-id]
Abra **Server Settings** (definições do servidor), depois **Roles** (cargos). Clique com o botão direito do rato no cargo pretendido. Escolha **Copy Role ID** (copiar ID do cargo). Só o modelo Get a role precisa deste ID.
### Obter o convite [#get-the-invite]
Clique com o botão direito do rato no ícone do servidor e escolha **Invite People** (convidar pessoas), depois copie o link. Use um convite que não expire e não tenha limite de utilizações, ou a missão deixa de funcionar.
## Os campos [#the-fields]
| Campo | O que é | O que pode correr mal |
| ------------------------------ | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Nome de utilizador apresentado | O nome do servidor que os fãs veem no cartão | [Texto de apresentação](/docs/quests/templates#verification), por isso um erro aqui é apenas cosmético e não dará por ele |
| ID da guilda | O servidor em que a adesão é verificada | Um ID errado falha para todos os fãs, incluindo os que já estão no servidor |
| Convite da guilda | Para onde o botão envia o fã | Um convite expirado ou de utilização única leva os fãs a uma página morta |
| ID do cargo | O cargo que a verificação lê | Um ID errado falha para toda a gente, tal como um ID da guilda errado |
| Nome do cargo | O nome do cargo que os fãs veem no cartão | Mudar o nome do cargo no Discord não atualiza a missão. Edite também a missão |
## Comportamento das missões de cargo [#role-quest-behaviour]
O fã associa o Discord, entra no servidor se ainda não estiver nele, e a missão fica concluída assim que tiver o cargo. Nada na missão atribui o cargo. O que dá o cargo aos fãs, um bot ou um moderador, tem de existir já no seu servidor, e a missão limita-se a ler o resultado.
As missões de cargo funcionam melhor como recompensa por algo que já acontece no Discord. Um fã que chega a uma missão de cargo sem ter como obter o cargo fica num beco sem saída, sem qualquer explicação no cartão.
Dar um cargo do Discord a um fã **como recompensa** por concluir uma missão é o caminho inverso e outra funcionalidade. Está em [Recompensas](/docs/rewards) e exige que a integração com o Discord esteja ligada. Anunciar missões e eventos no seu servidor está em [Discord](/docs/integrations/discord).
## Associação, e o que acontece quando um fã sai [#linking-and-what-happens-when-a-fan-leaves]
Um fã que sai do servidor mantém a recompensa, porque nada volta a ser verificado depois de a missão ser concluída. Veja [Verificação](/docs/quests/templates#verification).
A associação do Discord vem ativada por predefinição. Veja [Início de sessão](/docs/settings/sign-in).
# Facebook, Instagram, TikTok (/pt/docs/quests/templates/social/meta)
Nenhum dos quatro verifica se o fã seguiu, gostou ou viu. Os quatro registam o toque que abriu o link.
| Modelo | O fã | O que configura |
| --------------------------------------------------------- | ------------------------------------- | ----------------------------------------------------------------- |
| Visit a Facebook page (visitar uma página do Facebook) | Abre a sua página, volta, conclui | O URL da página, e o nome de utilizador apresentado no cartão |
| Visit an Instagram page (visitar uma página do Instagram) | Abre o seu perfil, volta, conclui | O URL do perfil, e o nome de utilizador apresentado no cartão |
| View an Instagram post (ver uma publicação do Instagram) | Abre uma publicação, volta, conclui | O URL da publicação, e o nome de utilizador apresentado no cartão |
| View a TikTok post (ver uma publicação do TikTok) | Abre a sua publicação, volta, conclui | O URL da publicação, e o nome de utilizador apresentado no cartão |
## A verificação [#the-check]
O fã não tem conta do Facebook, do Instagram ou do TikTok para associar, por isso a plataforma não tem como perguntar a nenhuma destas redes se um determinado fã o segue, viu o vídeo ou sequer carregou a página. Um cartão de missão que diz «Siga-nos no Instagram» e paga a recompensa está a pagar pelo toque que abriu o Instagram. Os quatro são modelos [Visit link](/docs/quests/templates/action#visit-link) com um cartão que tem o aspeto da rede.
Mantenha a recompensa pequena. Estas são as missões mais fáceis de concluir do seu quadro e devem estar entre as que menos rendem. Um fã que descobre que o botão paga mesmo sem seguir vai contá-lo aos outros fãs.
Escreva a descrição como a instrução. A missão não pode exigir que o fã siga, por isso tem de ser o texto a pedi-lo. Os parceiros veem uma parte real dos fãs fazer o que foi pedido mesmo assim, tal como acontece com o [YouTube](/docs/quests/templates/social/youtube), desde que a descrição diga com clareza o que se espera.
O modelo do TikTok tem uma função que os outros três não têm: levar um pico de tráfego a uma publicação nas horas a seguir a ser publicada. Defina a recompensa como a de uma missão de tráfego.
## Verificação no Instagram [#instagram-verification]
Planeado
Verificar que um fã gostou de uma publicação ou seguiu uma conta no Instagram é o modelo que os parceiros mais pedem entre os que ainda não existem. Exigiria a associação de conta do Instagram, ou seja, um fã que associa a conta do Instagram dele à sua aplicação em vez de se limitar a tocar num link.
Até lá, trate tudo nesta página como modelo de tráfego. Pergunte ao seu contacto na FanBase em que ponto está antes de preparar uma campanha que dependa disso, e veja [como pedir um modelo ou um jogo](/docs/quests/templates#asking-for-a-template-or-a-game).
## Associação de conta do TikTok [#tiktok-account-linking]
As verificações de seguir e de gostar exigiriam a associação de conta do TikTok, tal como funcionam no [X](/docs/quests/templates/social/x). Não está em desenvolvimento. A verificação no Instagram está à frente na fila, e o TikTok seguiria o mesmo caminho se os parceiros o pedirem.
## Como acertar nos URLs [#getting-the-urls-right]
O link é toda a configuração, por isso cole-o a partir da barra de endereço, e não de um menu de partilha. Os links de partilha do Instagram trazem parâmetros de rastreio que por vezes levam um fã sem sessão iniciada para um ecrã de início de sessão. Os links partilhados do TikTok passam por um encurtador e de vez em quando vão dar a um aviso para instalar a aplicação, e não à publicação. Nos dois casos, o fã não consegue concluir a missão e não faz ideia porquê.
O nome de utilizador que escreve é [texto de apresentação](/docs/quests/templates#verification).
# Spotify (/pt/docs/quests/templates/social/spotify)
Feita para parceiros da música, e a única família da plataforma que lê o que um fã ouve.
Os três exigem que o fã [associe a conta do Spotify](/docs/quests/templates#templates-that-need-a-linked-account).
| Modelo | Passa quando o fã | O que configura |
| --------------------------------------- | ------------------------------------ | ------------------------------------------------------------- |
| Follow an artist (seguir um artista) | Segue o artista | O link do Spotify, e o nome do artista apresentado no cartão |
| Follow a playlist (seguir uma playlist) | Segue a playlist | O link do Spotify, e o nome da playlist apresentado no cartão |
| Top artist (artista mais ouvido) | Tem o artista entre os que mais ouve | O nome do artista |
## Os dois modelos de seguir [#the-two-follow-templates]
O fã toca para abrir o Spotify, segue, volta, e a verificação é feita na conta associada dele. O link que cola é para onde o botão envia o fã. Copie-o do menu de partilha do próprio Spotify ou da barra de endereço do leitor web.
O nome do artista ou da playlist que escreve é [texto de apresentação](/docs/quests/templates#verification).
Seguir uma playlist costuma ser o melhor pedido dos dois. Seguir um artista é um compromisso maior para um fã que ainda não é ouvinte. Uma playlist que controla está sempre a mudar, o que lhe dá um motivo para repetir a missão no mês seguinte.
## Top artist [#top-artist]
É o modelo que lê o histórico de reprodução. Verifica se o artista que indica aparece entre os artistas mais ouvidos do fã no Spotify, lista que o Spotify calcula a partir do que ele ouve.
Um fã conclui esta missão com meses a ouvir.
Identifica os ouvintes que já tem. Use-o para encontrar e recompensar os fãs que já ouviam. Uma missão Top artist com uma recompensa grande e um público elegível pequeno é uma missão para a qual a maior parte da sua comunidade vai olhar uma vez e nunca mais.
Alinhe as expectativas na descrição. Um fã que falha merece saber porquê, e o cartão não tem como o dizer. Basta uma linha a dizer que esta missão é para quem já ouve em repetição.
## Associação, e a verificação única [#linking-and-the-one-time-check]
A associação do Spotify vem desativada por predefinição. Peça ao seu contacto na FanBase que a ative antes de publicar qualquer um destes modelos. Veja [Início de sessão](/docs/settings/sign-in).
Depois de a missão ser concluída, não se volta a verificar se o fã continua a seguir. Veja [Verificação](/docs/quests/templates#verification).
# Twitch (/pt/docs/quests/templates/social/twitch)
Os três exigem que o fã [associe a conta da Twitch](/docs/quests/templates#templates-that-need-a-linked-account).
| Modelo | O fã | O que configura |
| ------------------------------------------ | ------------------------------------------------------------ | --------------------------------------------------------------------------- |
| Follow (seguir) | Segue o seu canal | O nome de utilizador do canal, e o nome de utilizador apresentado no cartão |
| Subscribe (subscrever) | Subscreve o seu canal | O mesmo |
| Watch stream (ver a transmissão em direto) | Vê as suas transmissões em direto durante um número de horas | Horas, mais uma configuração. Veja abaixo |
## Seguir e subscrever [#follow-and-subscribe]
O cartão envia o fã para `twitch.tv` com o seu nome de utilizador, o fã faz o que foi pedido, e a verificação é feita na conta associada dele quando volta.
O nome de utilizador que escreve é o canal que é verificado, por isso tem de ser o nome de início de sessão que aparece no URL, e não o nome de apresentação da página do canal. Os dois costumam ser iguais, mas nem sempre.
Subscrever custa dinheiro ao fã. É o único modelo social da plataforma em que isso acontece, e uma recompensa definida como se fosse a de seguir pede ao fã que gaste dinheiro por muito pouco. Os parceiros que têm sucesso com missões de subscrição tratam-nas como um agradecimento aos fãs que iam subscrever de qualquer forma.
Nenhum dos dois volta a ser verificado depois de a missão ser concluída. Veja [Verificação](/docs/quests/templates#verification).
## Ver a transmissão em direto [#watch-stream]
Progressivo. O fã inicia a missão, vê a transmissão, e o contador sobe com as horas vistas até chegar à sua meta.
O tempo de visualização exige uma configuração à medida do seu canal antes de poder ser publicado. Pergunte ao seu contacto na FanBase o que isso implica para a sua comunidade antes de planear uma campanha em torno dele.
A missão tem de estar publicada antes de a transmissão em direto começar, porque [nada conta antes de o fã premir para começar](/docs/quests/templates#the-four-shapes).
## Associação, e associações expiradas a meio da missão [#linking-and-expired-links-mid-quest]
A associação da Twitch vem ativada por predefinição. Veja [Início de sessão](/docs/settings/sign-in).
Uma missão de tempo de visualização que um fã iniciou antes de [a associação dele expirar](/docs/quests/templates#templates-that-need-a-linked-account) volta a contar assim que ele associa de novo a conta.
Mais modelos da Twitch são um dos três pedidos em aberto na [fila de modelos](/docs/quests/templates#asking-for-a-template-or-a-game).
# X (/pt/docs/quests/templates/social/x)
Todos os modelos desta página exigem primeiro que o fã [associe a conta do X](/docs/quests/templates#templates-that-need-a-linked-account).
## Interagir com uma publicação ou uma conta [#engaging-with-a-post-or-an-account]
| Modelo | O fã | O que configura |
| ------------------- | ------------------------------------------------ | ---------------------------------------- |
| Follow (seguir) | Segue uma conta | O link da conta, ou o nome de utilizador |
| Like (gostar) | Gosta de uma publicação | O link da publicação |
| Repost (republicar) | Republica uma publicação | O link da publicação |
| Quote (citar) | Cita uma publicação pelas suas próprias palavras | O link da publicação |
O fã toca para abrir o X, faz o que foi pedido, volta e conclui. A verificação é feita nesse momento na conta associada dele.
Indique o link da publicação exata, não o do seu perfil. Uma missão que diz «ponha gosto na nossa última publicação» e leva a uma cronologia vai ser concluída por fãs que puseram gosto na publicação errada. Falha para toda a gente assim que a publicação deixa de ser a mais recente.
## Publicar [#posting]
Dois modelos pedem que o fã faça uma publicação própria e depois verificam se ela contém um elemento específico.
| Modelo | Passa quando a publicação contém | O que configura |
| -------------------------------------------- | -------------------------------- | -------------------------------------------- |
| Post with a hashtag (publicação com hashtag) | A sua hashtag | Um modelo de publicação, e a hashtag |
| Post with a link (publicação com link) | O seu link | Um modelo de publicação, e o prefixo do link |
O **modelo de publicação** é o texto que a aplicação já deixa preenchido para o fã quando ele toca para escrever. O fã pode editá-lo, e o texto pode incluir o nome de utilizador do próprio fã para que a publicação pareça dele.
A **hashtag** e o **prefixo do link** são o que a verificação lê. Um fã que apaga a sua hashtag ao editar não conclui a missão, e um fã que acrescenta um parágrafo seu à volta dela conclui. Mantenha o texto preenchido curto: quanto mais longo for, mais os fãs apagam, e maior a probabilidade de a parte verificada ir atrás.
## Verificar o perfil do próprio fã [#checking-a-fans-own-profile]
Três modelos leem o que o fã pôs no próprio perfil. Use-os numa campanha em que os fãs se identificam como parte de algo: uma tag no nome de apresentação para um torneio, um link na bio para um lançamento.
| Modelo | Lê | O que configura |
| -------------------------------------------------------- | ---------------------------- | -------------------------------------------------------------------------------------- |
| Display name check (verificação do nome de apresentação) | O nome de apresentação do fã | O texto a procurar, a distinção entre maiúsculas e minúsculas, a correspondência exata |
| Bio check (verificação da bio) | A bio do fã | O mesmo |
| Username check (verificação do nome de utilizador) | O nome de utilizador do fã | O mesmo |
Com **Case sensitive** (distinguir maiúsculas de minúsculas) ativado, as maiúsculas e minúsculas têm de coincidir com as suas. Com **Exact match** (correspondência exata) ativado, o campo inteiro tem de ser igual ao seu texto, o que quase nunca é o que pretende para uma bio. Deixe os dois desativados, a menos que esteja a verificar um código.
A verificação do nome de utilizador é a mais rigorosa das três, porque mudar de nome de utilizador é uma decisão a sério para um fã. Defina a recompensa em conformidade.
## Contas privadas e a verificação única [#private-accounts-and-the-one-time-check]
Uma conta privada não passa na verificação. Um fã com publicações protegidas associa a conta sem problemas e depois falha nas verificações de publicação, e nem ele nem a sua equipa recebem outra explicação além de a missão não ficar concluída. Ponha uma linha sobre isto na descrição.
Nada volta a ser verificado depois de a missão ser concluída, o que pesa mais no modelo de seguir e nas verificações de perfil. Veja [Verificação](/docs/quests/templates#verification).
# YouTube (/pt/docs/quests/templates/social/youtube)
Nenhum dos dois modelos disponíveis pede que o fã associe uma conta do YouTube, por isso os dois registam o clique. Os modelos de subscrever e gostar foram retirados e não vão voltar.
| Modelo | Estado | O fã | O que configura |
| ------------------------------- | --------------------------- | -------------------------------- | ------------------------------------------------------------ |
| Visit channel (visitar o canal) | Disponível | Abre o seu canal, volta, conclui | O URL da página e o nome de utilizador apresentado no cartão |
| Watch video (ver o vídeo) | Disponível | Abre o seu vídeo, volta, conclui | O URL da página e o nome de utilizador apresentado no cartão |
| Subscribe (subscrever) | Retirado | | |
| Like (gostar) | Retirado | | |
## Visitar o canal e ver o vídeo [#visit-channel-and-watch-video]
Os dois funcionam como qualquer outro modelo de visita. O fã toca no botão, o link abre num novo separador, e o botão de concluir fica ativo quando ele volta.
Os parceiros usam estes modelos para levar um pico de tráfego a um vídeo nas primeiras horas, a janela que mais pesa na classificação do próprio YouTube.
## Os modelos retirados [#the-withdrawn-templates]
As permissões que o YouTube exige para verificar que um determinado fã subscreveu um canal, ou gostou de um vídeo, são tão amplas que nenhuma recompensa de um quadro de missões as justifica.
Os modelos continuam no catálogo e não podem ser publicados.
## A alternativa [#the-workaround]
Use uma missão **visitar o canal** ou **ver o vídeo** e peça o gosto na descrição.
Os parceiros que usam este padrão constataram que uma parte significativa dos fãs faz o que a descrição pede, mesmo sem nada o verificar. Escreva a descrição como a instrução e seja específico: «Veja o vídeo e deixe um gosto» funciona melhor do que «Espreite o nosso novo vídeo».