Manual do Utilizador

Bem-vindo à documentação oficial da plataforma Roleta da Sorte. Este guia ajudá-lo-á a configurar, gerir e otimizar as suas campanhas de gamificação (v1.1.89+).

Novidade (v1.1.89): A nova secção AI Studio permite gerar textos de marketing automaticamente utilizando a tecnologia Google Gemini.

Primeiros Passos

O Backoffice é o centro de controlo da sua campanha. A partir daqui, pode configurar prémios, personalizar o aspeto visual e analisar os resultados.

  • Aceder ao Backoffice: Visite /admin no seu navegador.
  • Autenticação: Introduza as suas credenciais de administrador.
  • Dashboard: Ao entrar, verá o painel principal com estatísticas em tempo real sobre jogadas e prémios atribuídos.
  • Ver Jogo: Use o botão "🎮 Ver Jogo" no topo (ou visite /game.html) para testar a experiência do utilizador final.

🤖 AI Studio

O AI Studio é a nova funcionalidade que traz inteligência artificial para a sua campanha. Permite gerar títulos criativos, descrições e CTAs automaticamente.

Como Configurar

  1. Aceda ao separador AI Studio no menu lateral.
  2. Ative o interruptor "Ativar Funcionalidades AI".
  3. Introduza a sua API Key do Google Gemini (se ainda não tiver uma, clique no link "Obter chave aqui").
  4. Clique em Guardar Configuração.
  5. O estado passará a verde ✅ ("Chave Configurada").

Funcionalidades Disponíveis

  • Geração de Texto: Em qualquer campo de texto de marketing (Título, Subtítulo), procure o botão . Clique para gerar sugestões automáticas.
  • Seleção de Modelo: Pode escolher entre modelos mais rápidos (Flash) ou mais criativos (Pro) no menu do AI Studio. Utilize o botão 🔄 para atualizar a lista de modelos disponíveis.
Nota: A sua chave API é encriptada antes de ser guardada na base de dados, garantindo a máxima segurança do seu projeto.

Gestão de Jogo

Configure a mecânica do jogo para se adaptar ao seu stock e orçamento.

Prémios e Stock

Na secção Prémios, pode:

  • Adicionar/Editar Prémios: Defina o nome, ícone e cor.
  • Controlar Stock: Defina a quantidade máxima de cada prémio. Quando o stock atinge 0, a probabilidade desse prémio passa automaticamente a 0%.
  • Probabilidade: Ajuste a percentagem de saída de cada fatia. A soma deve idealmente ser 100%, mas o sistema normaliza automaticamente se necessário.

Personalização da Marca

Torne o jogo seu. Na secção Imagem da Marca, pode alterar:

  • Logótipo: Carregue o seu logótipo (PNG transparente recomendado).
  • Cores: Defina a cor Primária (botões, destaques) e Secundária (fundo).
  • Textos de Marketing: Altere as mensagens da página inicial e do ecrã de vitória.
  • Password de Acesso: Proteja o jogo com uma palavra-passe simples para ativações privadas.

Relatórios e Logs

Acompanhe o sucesso da sua campanha com dados detalhados.

  • Vencedores: Lista completa de quem ganhou o quê e quando.
  • Erros & Logs: Ferramenta técnica para diagnosticar problemas (ex: falhas de rede).

FAQ & Suporte

P: O jogo funciona offline?
R: Não, é necessária uma ligação ativa à internet para sincronizar stock e vencedores.

P: Posso usar num iPad?
R: Sim, a plataforma é 100% responsiva e funciona em tablets, telemóveis e desktop.