HandyCafe Docs
owner

Campanhas

Campanhas são ofertas promocionais que agrupam um ou mais pacotes sob um único tema ou promoção por tempo limitado. Elas permitem que proprietários de lan houses e centros de jogos criem ofertas estruturadas (como "Especial de Verão" ou "Pacote Gaming de Fim de Semana") que membros podem visualizar e comprar pelo Painel do Membro no cliente ou no balcão do caixa.

Estrutura da Campanha

Cada campanha é definida pelos seguintes campos:

Campo Descrição
name O nome de exibição da campanha, mostrado a membros e equipe.
description Uma descrição de texto explicando o propósito, termos ou benefícios da campanha.
active Um botão que controla se a campanha está atualmente disponível para compra.
expires_at Uma data de expiração opcional. Após esta data, a campanha não está mais disponível para novas compras, embora compras existentes permaneçam válidas conforme seus próprios termos.
deleted Uma flag de exclusão suave. Campanhas excluídas ficam ocultas da lista ativa mas seus dados são preservados para relatórios.

Estados da Campanha

Uma campanha pode estar em um dos seguintes estados:

  • Ativa: A campanha está visível e disponível para compra. A flag active está em 1 e a campanha não foi excluída de forma suave.
  • Inativa: A campanha existe mas está temporariamente desabilitada. A flag active está em 0. Pode ser reativada a qualquer momento.
  • Expirada: A data atual ultrapassou a data expires_at da campanha. A campanha não está mais disponível para novas compras.
  • Excluída: A campanha foi excluída de forma suave. Não aparece em nenhuma lista ativa e não pode ser comprada, mas todos os dados associados (compras, lotes, registros de consumo) são preservados.

Vinculando Pacotes a Campanhas

Uma campanha sozinha não define o que o membro recebe. Esse é o papel dos pacotes. Cada campanha contém um ou mais pacotes que definem a parcela específica (minutos, crédito de carteira ou ambos) e o preço de compra.

Por exemplo, uma campanha "Volta às Aulas" pode incluir três pacotes:

  • Básico: 60 minutos por um preço fixo.
  • Padrão: 120 minutos + 30 minutos de bônus por um preço mais alto.
  • Premium: 500 unidades de crédito de carteira + 60 minutos de bônus pelo preço mais alto.

Consulte a página Pacotes para detalhes completos sobre como os pacotes são configurados.

Fluxo de Compra do Membro

Quando um membro compra um pacote de campanha, a seguinte sequência ocorre:

  1. Navegar: O membro visualiza as campanhas disponíveis no Painel do Membro no PC cliente (na aba Campanhas) ou um operador busca campanhas na interface do servidor.
  2. Selecionar: O membro escolhe um pacote específico dentro de uma campanha.
  3. Pagamento: O preço de compra é coletado. Pode ser dinheiro no caixa, pagamento com cartão ou dedução do saldo existente da carteira do membro.
  4. Cumprimento: O sistema cria os créditos de carteira e/ou créditos de tempo apropriados com base na definição do pacote:
    • Para pacotes de dinheiro: créditos de carteira são criados com a parcela monetária.
    • Para pacotes de minutos: créditos de tempo são criados com a parcela de minutos.
    • Parcelas de bônus criam créditos adicionais marcados como "bônus".
  5. Registro: Um registro de compra é criado vinculando o membro, campanha, pacote e todos os créditos associados. Este registro rastreia parcela concedida vs. consumo no nível da compra.

Ativação e Desativação de Campanhas

Proprietários podem alternar o estado ativo de uma campanha a qualquer momento:

  • Ativar uma campanha a torna imediatamente disponível para compra por membros e operadores.
  • Desativar uma campanha a remove da lista de compras mas não afeta compras existentes. Membros que já compraram pacotes da campanha mantêm seus créditos de carteira e créditos de tempo.

Isso é útil para promoções sazonais. Crie a campanha com antecedência, ative-a quando a promoção começar e desative-a quando terminar, tudo sem perder nenhum dado.

Criando uma Campanha

Para criar uma nova campanha:

  1. Navegue até a seção de Campanhas na barra lateral (ou área dedicada de gestão de campanhas).
  2. Clique em Adicionar Campanha.
  3. Informe um nome e uma descrição para a campanha.
  4. Opcionalmente defina uma data de expiração se a campanha deve parar de aceitar novas compras após uma data específica.
  5. Salve a campanha.
  6. Adicione um ou mais pacotes à campanha (consulte Pacotes para detalhes).

Gerenciando Campanhas

Na lista de campanhas, você pode:

  • Editar o nome, descrição ou data de expiração de uma campanha.
  • Alternar o status ativo para habilitar ou desabilitar a campanha.
  • Excluir uma campanha (exclusão suave) para removê-la permanentemente da lista ativa preservando os dados.
  • Visualizar compras para ver quais membros compraram pacotes desta campanha e o status das suas parcelas.