Desafios
Desafios sao eventos com tempo limitado que impulsionam o engajamento do cliente e encorajam comportamentos especificos. Diferente de conquistas permanentes, desafios tem datas de inicio e fim definidas, criando urgencia e entusiasmo. Este guia cobre tudo o que voce precisa saber sobre criar e gerenciar desafios para seu programa de fidelidade.
Entendendo Desafios
Desafios sao eventos promocionais com duracao definida que encorajam clientes a completar metas especificas. Eles diferem de conquistas de maneiras-chave:
| Caracteristica | Conquistas | Desafios |
|---|---|---|
| Duracao | Permanente | Tempo limitado |
| Disponibilidade | Sempre ativa | Inicio/fim agendado |
| Participacao | Automatica | Opt-in (participar) |
| Progresso | Cumulativo vitalicio | Reinicia por desafio |
| Urgencia | Baixa | Alta |
Por Que Usar Desafios?
- Impulsionar Comportamentos Especificos: Encoraje estacionamento em zonas preferidas, viagens de fim de semana, etc.
- Criar Urgencia: Eventos por tempo limitado motivam acao
- Aumentar Engajamento: Conteudo fresco mantem clientes voltando
- Promocoes Sazonais: Alinhe com feriados, eventos ou periodos de baixa demanda
- Construcao de Comunidade: Todos trabalhando em direcao ao mesmo objetivo
Tipos de Desafio
Desafios suportam multiplos tipos de meta para impulsionar diferentes comportamentos:
Completar Viagens (rides_count)
Meta: Completar um numero especifico de viagens.
| Exemplo | Alvo | Duracao |
|---|---|---|
| Passageiro Semanal | 5 viagens | 7 dias |
| Semana Intensa | 10 viagens | 7 dias |
| Maratona Mensal | 20 viagens | 30 dias |
Caso de uso: Aumentar o volume geral de viagens.
Distancia Percorrida (distance_km)
Meta: Acumular distancia percorrida.
| Exemplo | Alvo | Duracao |
|---|---|---|
| 10K Rapido | 10 km | 7 dias |
| Desafio Explorador | 50 km | 14 dias |
| Desafio Centenario | 100 km | 30 dias |
Caso de uso: Encorajar viagens mais longas ou frequentes.
Manter Sequencia (streak_days)
Meta: Viajar em dias consecutivos.
| Exemplo | Alvo | Duracao |
|---|---|---|
| Sequencia de 3 Dias | 3 dias | 7 dias |
| Sequencia Semanal | 7 dias | 14 dias |
| Guerreiro de Duas Semanas | 14 dias | 21 dias |
Caso de uso: Construir habitos de viagem.
Dias Consecutivos (consecutive_days)
Meta: Viajar em um numero especifico de dias consecutivos do calendario.
| Exemplo | Alvo | Duracao |
|---|---|---|
| Desafio Compromisso | 5 dias consecutivos | 7 dias |
| Construtor de Habitos | 7 dias consecutivos | 10 dias |
Caso de uso: Impulsionar engajamento diario.
Estacionamento Preferido (parking_zone)
Meta: Terminar viagens em zonas de estacionamento designadas.
| Exemplo | Alvo | Duracao |
|---|---|---|
| Bom Estacionador | 3 finais em zona | 7 dias |
| Pro do Estacionamento | 10 finais em zona | 14 dias |
| Mestre das Zonas | 25 finais em zona | 30 dias |
Caso de uso: Melhorar distribuicao da frota e conformidade de estacionamento.
Guerreiro de Fim de Semana (weekend_warrior)
Meta: Completar viagens nos fins de semana.
| Exemplo | Alvo | Duracao |
|---|---|---|
| Iniciante de Fim de Semana | 2 viagens de fim de semana | 7 dias |
| Campeao de Fim de Semana | 6 viagens de fim de semana | 14 dias |
Caso de uso: Aumentar viagens de fim de semana.
Madrugador (early_bird)
Meta: Completar viagens pela manha (antes das 8h).
| Exemplo | Alvo | Duracao |
|---|---|---|
| Quem Cedo Madruga | 3 viagens matinais | 7 dias |
| Passageiro do Amanhecer | 10 viagens matinais | 30 dias |
Definicao de Horario
Uma viagem e considerada "madrugador" se iniciar antes das 8:00 no fuso horario da conta.
Caso de uso: Distribuir demanda para horarios fora do pico.
Coruja Noturna (night_owl)
Meta: Completar viagens a noite (20h ou mais tarde).
| Exemplo | Alvo | Duracao |
|---|---|---|
| Piloto Noturno | 3 viagens noturnas | 7 dias |
| Apos o Anoitecer | 10 viagens noturnas | 30 dias |
Definicao de Horario
Uma viagem e considerada "coruja noturna" se iniciar as 20:00 ou mais tarde no fuso horario da conta.
Caso de uso: Encorajar viagens noturnas.
Campeao Eco (eco_champion)
Meta: Acumular economia de CO2.
| Exemplo | Alvo | Duracao |
|---|---|---|
| Comeco Verde | 5 kg economizado | 7 dias |
| Guerreiro Eco | 25 kg economizado | 14 dias |
| Salvador do Planeta | 100 kg economizado | 30 dias |
Caso de uso: Promover consciencia ambiental.
Criando um Desafio
Guia Passo a Passo
-
Acesse a Pagina de Desafios
- Navegue ate Painel > Fidelidade > Desafios
- Ou va diretamente para
/dashboard/loyalty/challenges/
-
Clique em "Novo Desafio"
- Abre o modal de criacao de desafio
-
Preencha Informacoes Basicas
- Nome: Nome atraente do desafio (ex: "Guerreiro de Fim de Semana")
- Descricao: O que os clientes precisam fazer
-
Configure o Tipo de Desafio
- Tipo de Desafio: Selecione entre os tipos disponiveis
- Alvo: Defina a meta a alcancar
-
Defina a Duracao
- Data de Inicio: Quando o desafio comeca
- Data de Fim: Quando o desafio termina
-
Configure as Recompensas
- Recompensa em Pontos: Pontos base por conclusao
- Tipo de Recompensa Bonus: Recompensa adicional opcional
- Valor da Recompensa Bonus: Quantidade da recompensa bonus
-
Configure a Aparencia
- Cor do Distintivo: Selecione a cor de destaque
-
Configuracoes Opcionais
- Maximo de Participantes: Limitar participacao
- Em Destaque: Destacar no aplicativo movel
-
Salvar Desafio
Opcoes de Configuracao de Desafio
Campos Obrigatorios
| Campo | Descricao | Validacao |
|---|---|---|
| Nome | Nome de exibicao | Max 100 caracteres |
| Tipo de Desafio | Tipo de meta | Deve ser tipo valido |
| Alvo | Meta numerica | Deve ser > 0 |
| Data de Inicio | Hora de inicio | Deve ser datetime valido |
| Data de Fim | Hora de termino | Deve ser apos data de inicio |
Campos Opcionais
| Campo | Padrao | Descricao |
|---|---|---|
| Descricao | Nenhum | Instrucoes para clientes |
| Recompensa em Pontos | 0 | Pontos concedidos na conclusao |
| Tipo de Recompensa Bonus | Nenhum | Tipo de recompensa adicional |
| Valor da Recompensa Bonus | Nenhum | Quantidade de bonus |
| Maximo de Participantes | Ilimitado | Limite de participacao |
| Em Destaque | Nao | Destacar no aplicativo movel |
| Cor do Distintivo | #10B981 | Cor de destaque |
Exemplo de Configuracao
Desafio Guerreiro de Fim de Semana:
Nome: Guerreiro de Fim de Semana
Descricao: Complete 5 viagens no sabado ou domingo este mes
Tipo de Desafio: Guerreiro de Fim de Semana
Alvo: 5 viagens
Data de Inicio: 1 de dezembro de 2024 00:00
Data de Fim: 31 de dezembro de 2024 23:59
Recompensa em Pontos: 500
Tipo de Recompensa Bonus: Credito na Carteira
Valor da Recompensa Bonus: 250 centavos (R$2,50)
Maximo de Participantes: Ilimitado
Em Destaque: Sim
Cor do Distintivo: #F59E0B
Ciclo de Vida do Desafio
Estados do Desafio
Desafios passam por estados distintos:
PROXIMO → ATIVO → ENCERRADO
| Estado | Descricao | Cliente Pode Participar? | Progresso Rastreado? |
|---|---|---|---|
| Proximo | Antes da data de inicio | Sim | Nao |
| Ativo | Entre inicio e fim | Sim | Sim |
| Encerrado | Apos data de fim | Nao | Nao |
Linha do Tempo do Ciclo de Vida
Dia 1 Dia 7 Dia 14 Dia 21 Dia 28
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
Criado Ativo Ativo Ativo Encerrado
(Proximo) Inicia Progresso Conclusao Resultados
────────────────────────────────────────>
O Que Acontece em Cada Etapa
Proximo:
- Desafio visivel no app com distintivo "Em Breve"
- Clientes podem pre-participar
- Progresso ainda nao rastreado
Ativo:
- Desafio aparece com cronometro regressivo
- Novos clientes podem participar
- Toda atividade e rastreada para a meta
- Conclusoes acionam recompensas
Encerrado:
- Novas participacoes nao permitidas
- Progresso congelado
- Participantes incompletos sao marcados como nao concluidos
- Desafio move para filtro "Encerrados"
Recompensas Bonus
Alem de pontos, desafios podem conceder recompensas bonus:
Credito na Carteira (wallet_credit)
Credito direto adicionado a carteira do cliente.
| Configuracao | Resultado |
|---|---|
| Valor: 500 centavos | R$5,00 adicionados a carteira |
| Valor: 250 centavos | R$2,50 adicionados a carteira |
Caso de uso: Fornecer valor imediato e tangivel.
Como funciona:
- Cliente completa o desafio
- Pontos sao concedidos (se configurado)
- Credito na carteira e adicionado ao saldo
- Cliente recebe notificacao
Desbloqueios Gratuitos (free_unlock)
Desbloqueios de veiculo de cortesia.
| Configuracao | Resultado |
|---|---|
| Valor: 1 | 1 desbloqueio gratuito |
| Valor: 3 | 3 desbloqueios gratuitos |
Caso de uso: Encorajar viagens adicionais.
Como funciona:
- Cliente completa o desafio
- Desbloqueios gratuitos adicionados ao saldo
- Usados automaticamente nas proximas viagens
- Nao expiram (diferente de desbloqueios de nivel)
Boost de Nivel (tier_boost)
Temporariamente aumenta os beneficios de nivel do cliente.
| Configuracao | Resultado |
|---|---|
| Valor: 1 | Boost de 1 nivel |
| Valor: 2 | Boost de 2 niveis |
Caso de uso: Dar aos clientes uma "amostra" dos beneficios de nivel superior.
Como funciona:
- Cliente completa o desafio
- Boost de nivel aplicado temporariamente
- Cliente aproveita beneficios de nivel superior
- Boost expira apos periodo definido
Recurso Avancado
Boost de nivel eleva temporariamente o nivel efetivo do cliente.
Escolhendo Tipos de Bonus
| Objetivo | Bonus Recomendado |
|---|---|
| Aumentar viagens | Desbloqueios Gratuitos |
| Aumentar gastos | Credito na Carteira |
| Ativacao de novo cliente | Credito na Carteira |
| Retencao | Desbloqueios Gratuitos |
| Promocao de nivel | Boost de Nivel |
Desafios em Destaque
Desafios em destaque ganham posicionamento proeminente no aplicativo movel:
O Que Significa Destaque
- Posicao Superior: Aparece primeiro na lista de desafios
- Destaque Visual: Distintivo especial "Destaque"
- Elegibilidade para Push: Pode ser incluido em notificacoes push
- Visibilidade no Painel: Aparece em estatisticas rapidas
Quando Destacar
- Promocoes Importantes: Eventos sazonais, feriados
- Metas Importantes: Conformidade de estacionamento, viagens fora do pico
- Tempo Limitado: Recompensas de alto valor com curta duracao
Limite de Destaque
Recomende apenas 1-2 desafios em destaque por vez. Muitos dilui o efeito.
Gerenciando Desafios
Visao Geral do Painel
A pagina de desafios exibe:
Cartoes de Estatisticas:
- Desafios Ativos: Em execucao atualmente
- Total de Participantes: Soma de todos os ativos
- Taxa de Conclusao: Concluidos / Participantes em percentual
- Desafio Principal: Desafio ativo mais popular
Abas de Filtro:
- Ativos: Desafios em execucao atualmente
- Proximos: Agendados para o futuro
- Encerrados: Desafios passados
- Todos: Lista completa
Cartoes de Desafio
Cada cartao de desafio mostra:
- Nome e descricao
- Distintivo de status (Ativo/Proximo/Encerrado)
- Distintivo de destaque (se aplicavel)
- Tipo de meta e alvo
- Recompensa em pontos
- Datas de inicio e fim
- Estatisticas de participacao (X/Y concluiram)
- Barra de progresso
Editando um Desafio
- Encontre o desafio
- Clique no icone de lapis (Editar)
- Modifique configuracoes
- Clique em "Atualizar"
Importante
Alterar alvo ou datas pode afetar a experiencia do cliente. Comunique mudancas.
Excluindo um Desafio
- Encontre o desafio
- Clique no icone de lixeira (Excluir)
- Confirme a exclusao
O que acontece:
- Desafio e marcado como inativo
- Removido da visualizacao do cliente
- Registros de progresso preservados
- Recompensas ja ganhas sao mantidas
Experiencia no Aplicativo Movel
Descoberta
Clientes encontram desafios na secao de Fidelidade:
Secao de Desafios Ativos:
┌─────────────────────────────────┐
│ Desafios Ativos │
│ 2/3 participando │
├─────────────────────────────────┤
│ Guerreiro de Fim de Semana │
│ Complete 5 viagens no fim │
│ de semana │
│ [████████░░░░░] 4/5 │
│ +500 pts Termina em 2 dias │
├─────────────────────────────────┤
│ Especial Madrugador │
│ [Participar do Desafio] │
│ +300 pts Termina em 5 dias │
└─────────────────────────────────┘
Participando de um Desafio
- Cliente visualiza detalhes do desafio
- Toca no botao "Participar do Desafio"
- Rastreamento de progresso comeca imediatamente
- Desafio aparece em "Meus Desafios"
Acompanhamento de Progresso
Desafios em que participou mostram:
- Barra de progresso com atual/alvo
- Percentual concluido
- Tempo restante
- Status de conclusao
Conclusao
Quando a meta e atingida:
- Desafio marcado como concluido
- Pontos creditados ao saldo
- Recompensas bonus aplicadas (se houver)
- Mostrado no feed de atividades
Melhores Praticas
Design de Desafio
-
Metas Claras
- Alvos especificos e mensuraveis
- Requisitos faceis de entender
- Alcancaveis dentro do prazo
-
Duracao Apropriada
- 7 dias: Impulso rapido de engajamento
- 14 dias: Desafio equilibrado
- 30 dias: Metas de retencao mensal
-
Recompensas Atraentes
- Proporcionais a dificuldade
- Mix de pontos e recompensas bonus
- Considere segmentacao por publico
Diretrizes de Duracao
| Duracao | Melhor Para | Exemplo |
|---|---|---|
| 3-5 dias | Promocoes relampago | "Blitz de Fim de Semana" |
| 7 dias | Engajamento semanal | "Passageiro Semanal" |
| 14 dias | Formacao de habito | "Sequencia de Duas Semanas" |
| 30 dias | Metas mensais | "Explorador Mensal" |
Diretrizes de Recompensa
| Dificuldade | Pontos | Sugestao de Bonus |
|---|---|---|
| Facil (3-5 viagens) | 200-300 | 1 desbloqueio gratuito |
| Media (10-15 viagens) | 400-600 | R$2-3 de credito |
| Dificil (20+ viagens) | 800-1200 | R$5+ de credito |
| Extremo (50+ viagens) | 1500-2500 | R$10+ de credito |
Estrategias de Timing
| Cenario | Timing |
|---|---|
| Fins de semana lentos | Lanca sexta, termina domingo |
| Engajamento mensal | 1o ao 30/31 |
| Periodos de feriado | Semana antes ate dia seguinte |
| Baixa de verao | Desafios de 2 semanas |
| Lancamento de novo mercado | 30 dias introdutorios |
Calendario Recomendado
Rotacao Mensal:
| Semana | Tipo de Desafio | Meta |
|---|---|---|
| Semana 1 | Contagem de viagens | Complete X viagens |
| Semana 2 | Zona de estacionamento | Termine em zona X vezes |
| Semana 3 | Distancia | Viaje X km |
| Semana 4 | Especial/Sazonal | Varia |
Perguntas Frequentes
Participacao
P: Clientes podem participar de um desafio encerrado? R: Nao, uma vez que um desafio termina, novos participantes nao podem entrar.
P: Um cliente pode sair de um desafio apos participar? R: Atualmente nao. Uma vez participando, esta comprometido ate terminar.
P: O que acontece se um cliente nao completar um desafio? R: Nenhuma recompensa e dada. O progresso e preservado nos registros.
Progresso
P: Progresso de antes de participar conta? R: Nao, apenas atividade apos participar conta para a meta.
P: O que acontece com o progresso se eu editar o alvo do desafio? R: O progresso existente e comparado com o novo alvo.
P: Clientes podem ver o progresso uns dos outros? R: Atualmente nao, desafios sao apenas progresso individual.
Recompensas
P: Quando as recompensas sao creditadas? R: Imediatamente apos conclusao da meta do desafio.
P: E se o desafio terminar enquanto um cliente esta no meio do progresso? R: Eles nao recebem recompensas. Apenas conclusao antes do termino conta.
P: Recompensas podem ser revogadas? R: Nao automaticamente. Ajustes manuais sao necessarios por um admin.
Tecnico
P: Qual fuso horario e usado para horarios de inicio/fim? R: O fuso horario configurado da conta.
P: Com que frequencia o progresso e atualizado? R: Apos cada conclusao de viagem, o progresso do desafio e recalculado.
P: Ha limite de desafios simultaneos? R: Sem limite tecnico, mas 3-5 ativos e recomendado para UX.
Referencia Tecnica
Mapeamento de Tipos de Desafio
| Nome na UI | Valor da API | Descricao |
|---|---|---|
| Completar Viagens | rides_count | Total de viagens no periodo |
| Distancia Percorrida | distance_km | Km cumulativo |
| Manter Sequencia | streak_days | Dias consecutivos |
| Dias Consecutivos | consecutive_days | Sequencia de dias do calendario |
| Estacionamento Preferido | parking_zone | Contagem de finais em zona |
| Guerreiro de Fim de Semana | weekend_warrior | Viagens de sab/dom |
| Madrugador | early_bird | Viagens antes das 9h |
| Coruja Noturna | night_owl | Viagens apos 20h |
| Campeao Eco | eco_champion | CO2 economizado |
Esquema do Banco de Dados
tabela challenges:
| Coluna | Tipo | Descricao |
|---|---|---|
| id | uuid | Chave primaria |
| account_id | uuid | Conta pai |
| name | text | Nome de exibicao |
| description | text | Como completar |
| challenge_type | text | Tipo de meta |
| target_value | int | Meta numerica |
| target_metadata | jsonb | Config adicional |
| points_reward | int | Pontos na conclusao |
| bonus_reward_type | text | Tipo de recompensa extra |
| bonus_reward_value | int | Quantidade de recompensa extra |
| badge_icon_url | text | Icone personalizado |
| badge_color | text | Cor hex |
| starts_at | timestamp | Hora de inicio |
| ends_at | timestamp | Hora de termino |
| max_participants | int | Limite de participacao |
| is_featured | boolean | Flag de destaque |
| is_active | boolean | Status habilitado |
| created_at | timestamp | Data de criacao |
| updated_at | timestamp | Ultima atualizacao |
tabela customer_challenge_progress:
| Coluna | Tipo | Descricao |
|---|---|---|
| id | uuid | Chave primaria |
| customer_id | uuid | Participante |
| challenge_id | uuid | Referencia do desafio |
| account_id | uuid | Conta pai |
| current_progress | int | Progresso em direcao a meta |
| joined_at | timestamp | Hora de participacao |
| completed_at | timestamp | Hora de conclusao (null se nao) |
| rewards_granted | boolean | Flag de recompensas dadas |
Endpoints da API
| Endpoint | Metodo | Descricao |
|---|---|---|
/api/loyalty/challenges | GET | Listar desafios |
/api/loyalty/challenges | POST | Criar desafio |
/api/loyalty/challenges/[id] | GET | Obter desafio |
/api/loyalty/challenges/[id] | PUT | Atualizar desafio |
/api/loyalty/challenges/[id] | DELETE | Excluir desafio |
/api/mobile/loyalty | POST | Participar do desafio (action=join_challenge) |
Precisa de Ajuda?
Para assistencia na configuracao de desafios, contate support@levyelectric.com.