Conquistas

Conquistas sao distintivos de marcos que recompensam clientes por realizacoes especificas. Elas criam momentos memoraveis de reconhecimento e fornecem recompensas adicionais de pontos. Este guia cobre tudo o que voce precisa saber sobre criar e gerenciar conquistas para seu programa de fidelidade.

Entendendo Conquistas

Conquistas sao distintivos permanentes que clientes ganham ao completar marcos especificos. Diferente de desafios, conquistas nao expiram e estao sempre disponiveis para os clientes trabalharem.

Caracteristicas Principais

• Permanente: Uma vez ganha, a conquista permanece no perfil do cliente
• Baseada em Gatilhos: Concedida automaticamente quando condicoes sao atendidas
• Recompensas em Pontos: Cada conquista pode conceder pontos bonus
• Reconhecimento Visual: Exibida como distintivos no aplicativo movel
• Unica ou Repetivel: Pode ser ganha uma vez ou varias vezes

Proposito das Conquistas

1. Celebrar Marcos: Marcar realizacoes significativas do cliente
2. Encorajar Exploracao: Motivar clientes a experimentar novos comportamentos
3. Impulsionar Engajamento: Fornecer metas de colecao/conclusao
4. Recompensar Fidelidade: Dar reconhecimento tangivel pelo uso continuo

---

Tipos de Gatilho de Conquista

Conquistas sao concedidas quando gatilhos especificos sao atingidos. O sistema suporta estes tipos de gatilho:

Total de Viagens (rides_count)

Conceder com base na contagem cumulativa de viagens vitalicia.

Caso de uso: Recompense marcos de uso geral.

Distancia Percorrida (distance_km)

Conceder com base em quilometros percorridos cumulativos.

Caso de uso: Recompense marcos baseados em distancia.

Dias de Sequencia (streak_days)

Conceder por manter dias consecutivos de viagem.

Caso de uso: Encoraje habitos de uso diario.

Primeira Viagem (first_ride)

Conceder por completar a primeirissima viagem.

Caso de uso: Celebre a integracao de novos clientes.

Finais em Zona de Estacionamento (parking_zone)

Conceder por terminar viagens em zonas de estacionamento designadas.

Caso de uso: Encoraje comportamento adequado de estacionamento.

Viagens de Fim de Semana (weekend_rides)

Conceder por viagens feitas nos fins de semana (sabado/domingo).

Caso de uso: Impulsione o uso nos fins de semana.

Pontos Ganhos (points_earned)

Conceder com base em pontos de fidelidade cumulativos ganhos.

Caso de uso: Recompense engajamento geral no programa.

Distancia Eco (eco_distance)

Conceder com base em economia estimada de CO2 das viagens.

Calculo de CO2: O sistema estima a economia de CO2 usando a formula:

CO2 Economizado (kg) = Distancia (km) x 0,12

Isso assume que substituir uma viagem de carro por uma viagem de veiculo eletrico economiza aproximadamente 120 gramas de CO2 por quilometro.

Caso de uso: Promova consciencia ambiental.

Hora do Dia (time_of_day)

Conceder por viagens concluidas durante horas especificas.

Caso de uso: Reconheca usuarios fora do pico ou comportamentos especificos por horario.

Nivel Alcancado (tier_reached)

Conceder quando um cliente atinge um nivel de fidelidade especifico.

Caso de uso: Celebre marcos de nivel com reconhecimento adicional.

Viagens Mensais (monthly_rides)

Conceder por completar um certo numero de viagens dentro de um mes calendario.

Caso de uso: Encoraje uso mensal consistente.

Indicacoes (referrals)

Conceder com base na contagem de indicacoes bem-sucedidas.

Caso de uso: Reconheca os principais indicadores.

---

Criando Conquistas

Guia Passo a Passo

1. Acesse a Pagina de Conquistas

   • Navegue ate Painel > Fidelidade > Conquistas
   • Ou va diretamente para /dashboard/loyalty/achievements/

2. Clique em "Nova Conquista"

   • Abre o modal de criacao de conquista

3. Preencha Informacoes Basicas

   • Nome: Nome da conquista voltado ao cliente (ex: "Primeira Viagem")
   • Descricao: Como ganhar esta conquista (ex: "Complete sua primeira viagem")

4. Configure o Gatilho

   • Tipo de Gatilho: Selecione entre os tipos disponiveis
   • Valor Alvo: Defina o limite para ganhar

5. Defina a Recompensa

   • Recompensa em Pontos: Pontos bonus concedidos quando ganha

6. Configure a Aparencia

   • Cor do Distintivo: Selecione uma cor hex para o distintivo

7. Configuracoes Opcionais

   • Repetivel: Permitir ganhar varias vezes
   • Dias de Intervalo: Dias minimos entre ganhos repetidos
   • Secreto: Ocultar ate ganhar

8. Salvar Conquista

---

Configurando Definicoes de Conquista

Campos do Formulario Explicados

Informacoes Basicas

Configuracao de Gatilho

Configuracao de Recompensa

Aparencia

Configuracoes de Comportamento

Exemplo de Configuracao

Conquista Clube do Centenario:

Nome: Clube do Centenario
Descricao: Complete 100 viagens e junte-se a um grupo de elite de passageiros
Tipo de Gatilho: Total de Viagens (rides_count)
Valor Alvo: 100
Recompensa em Pontos: 1000
Cor do Distintivo: #F59E0B (Ouro)
Repetivel: Nao
Secreto: Nao

---

Conquistas Repetiveis

Algumas conquistas podem ser ganhas varias vezes. Isso e util para recompensas continuas:

Como Funcionam Conquistas Repetiveis

1. Cliente ganha a conquista pela primeira vez
2. Contador reinicia (se intervalo definido, deve aguardar)
3. Cliente pode trabalhar para ganhar novamente
4. Cada ganho concede os pontos de recompensa novamente

Periodo de Intervalo

Defina um tempo minimo entre ganhos para evitar exploracao:

Exemplo: Guerreiro Semanal

Nome: Guerreiro Semanal
Descricao: Complete 5 viagens em uma semana
Tipo de Gatilho: Total de Viagens (rides_count)
Valor Alvo: 5 (contagem semanal)
Recompensa em Pontos: 50
Repetivel: Sim
Dias de Intervalo: 7

---

Conquistas Secretas

Conquistas secretas adicionam um elemento de surpresa e descoberta:

Caracteristicas

• Nao mostradas na lista de conquistas ate serem ganhas
• Criam momentos de "surpresa e deleite"
• Encorajam compartilhamento e boca a boca
• Otimo para realizacoes especiais ou raras

Quando Usar Conquistas Secretas

Exemplo: Conquista Secreta

Nome: Coruja Noturna
Descricao: Complete uma viagem apos meia-noite
Tipo de Gatilho: Hora do Dia (time_of_day)
Valor Alvo: 0 (meia-noite)
Recompensa em Pontos: 100
Secreto: Sim

---

Gerenciando Conquistas

Visualizando Todas as Conquistas

A pagina de conquistas mostra:

• Cartoes de Estatisticas:

  • Total de Conquistas (contagem ativa)
  • Total Ganhas (soma de todos os ganhos de clientes)
  • Mais Popular (conquista mais ganha)

• Cartoes de Conquista:

  • Nome e descricao
  • Tipo e valor do gatilho
  • Recompensa em pontos
  • Contagem de vezes ganha
  • Distintivos de Repetivel/Inativo

Editando uma Conquista

1. Encontre o cartao da conquista
2. Clique no icone de lapis (Editar)
3. Modifique as configuracoes
4. Clique em "Atualizar"

Desativando uma Conquista

1. Encontre o cartao da conquista
2. Clique no icone de lixeira (Excluir)
3. Confirme a desativacao

O que acontece:

• Conquista e marcada como inativa
• Nao mais mostrada para novos clientes
• Registros de ganhos existentes sao preservados
• Pode ser reativada editando

Visualizando Estatisticas de Ganhos

Cada cartao de conquista mostra:

• Vezes Ganha: Numero total de vezes ganha por todos os clientes
• Ajuda a identificar metas populares vs. raramente alcancadas

---

Experiencia no Aplicativo Movel

Exibicao de Conquistas

O aplicativo movel mostra conquistas em uma galeria de rolagem horizontal:

Conquistas Ganhas:

• Icone de distintivo em cores completas
• Nome da conquista
• Pontos ganhos exibidos

Conquistas Bloqueadas:

• Icone de distintivo acinzentado
• Sobreposicao de cadeado
• Nome da conquista (a menos que secreto)
• Pontos disponiveis

Resumo de Conquistas

O cabecalho do app mostra:

Conquistas: 8/15 ganhas

Onde:

• 8 = Conquistas ganhas pelo cliente
• 15 = Total de conquistas disponiveis (nao secretas)

Notificacao de Ganho

Quando um cliente ganha uma conquista:

1. Conquista desbloqueia visualmente
2. Pontos sao adicionados ao saldo
3. Conquista aparece na atividade recente

---

Melhores Praticas

Design de Conquistas

1. Crie uma Progressao

   • Projete conquistas que constroem umas sobre as outras
   • Exemplo: 10 viagens -> 25 viagens -> 50 viagens -> 100 viagens

2. Equilibre a Dificuldade

   • Mix de conquistas faceis, medias e dificeis
   • Maioria dos clientes deve ganhar 3-5 no primeiro mes
   • Algumas devem ser verdadeiramente aspiracionais

3. Recompense Proporcionalmente

   • Facil: 50-100 pontos
   • Media: 100-500 pontos
   • Dificil: 500-2000 pontos
   • Lendaria: 2000+ pontos

Conjunto Inicial Recomendado

Dicas para Sucesso

1. Lance com 8-12 conquistas - Variedade suficiente sem sobrecarregar
2. Adicione 1-2 novas conquistas mensalmente - Mantenha fresco
3. Use conquistas secretas com moderacao - 2-3 e suficiente
4. Acompanhe taxas de ganho - Ajuste dificuldade se muito facil ou dificil
5. Promova conquistas dificeis - Destaque clientes que ganham distintivos raros

---

Perguntas Frequentes

Questoes Gerais

P: Clientes podem perder conquistas que ganharam? R: Nao, uma vez ganha, conquistas sao permanentes.

P: Conquistas sao especificas por conta? R: Sim, cada conta/frota pode ter suas proprias conquistas.

P: Posso criar a mesma conquista para varias subcontas? R: Sim, voce precisara cria-la separadamente para cada subconta.

Questoes de Gatilho

P: Quando as conquistas sao verificadas? R: Apos cada conclusao de viagem, o sistema verifica todos os gatilhos aplicaveis.

P: E se um cliente atender criterios de varias conquistas de uma vez? R: Todas as conquistas aplicaveis sao concedidas simultaneamente.

P: Posso usar logica de gatilho personalizada? R: Nao atualmente. Contate o suporte para requisitos de gatilho complexos.

Questoes de Recompensa

P: Pontos de conquista contam para qualificacao de nivel? R: Nao, apenas gastos em viagens contam para progressao de nivel. Pontos de conquista sao bonus.

P: Posso conceder algo alem de pontos? R: Atualmente, conquistas so concedem pontos. Creditos de carteira podem ser feitos atraves de desafios.

P: Ha limite de pontos que posso conceder? R: Tecnicamente nao, mas recomendamos manter conquistas individuais abaixo de 10.000 pontos.

Questoes Tecnicas

P: O que acontece com conquistas se eu excluir? R: Sao desativadas, mas registros de ganhos dos clientes sao preservados.

P: Posso editar o gatilho de uma conquista apos criacao? R: Sim, mas nao concedera ou revogara retroativamente de clientes.

P: Como disponibilizo conquistas para todas as subcontas? R: Crie-as para cada subconta individualmente, ou contate o suporte para criacao em massa.

---

Referencia Tecnica

Mapeamento de Tipos de Gatilho

Esquema do Banco de Dados

tabela achievements:

tabela customer_achievements:

Endpoints da API

---