Pesquisar artigos na Base de Dados de Conhecimento

Guia de configuração de desafios – Diletec Gamification para Wordpress

Este guia explica, em linguagem simples, como você mesmo pode criar desafios, conquistas e recompensas no seu site.

Você não precisa mexer em código: tudo é feito pelo painel do WordPress, no menu Gamification.

1. Conceitos básicos

Antes de criar qualquer coisa, é importante entender 3 palavras que vão aparecer na tela:

1.1. Evento (ou Conquista)

É o desafio principal que o usuário pode cumprir.

Exemplos de eventos:

  • “Primeiro comentário em produto”

  • “Comente em 5 produtos”

  • “Primeira compra”

  • “Login diário”

  • “Indique 3 amigos”

É o evento que aparece:

  • na tela Desafios ativos

  • na tela de Conquistas do usuário

1.2. Passos (Steps)

São as regras internas que dizem o que precisa acontecer para o evento ser concluído.

Exemplos de passos:

  • “Fazer 1 comentário em produto”

  • “Fazer 5 comentários em produto”

  • “Concluir 1 compra”

  • “Fazer login 1 vez no dia”

Um evento pode ter 1 ou vários passos (tipo Duolingo, que às vezes pede 3 coisas diferentes para liberar uma conquista).

1.3. Recompensas (Benefícios)

É o que o usuário ganha quando termina o evento.

Hoje o plugin suporta:

  • Pontos – que sobem o nível, aparecem no ranking, etc.

  • Outros tipos de benefício (cupom, frete grátis, acesso especial) – que dependem de como seu site está configurado / do desenvolvedor que instalou o plugin.

2. Passo a passo: como criar um novo desafio

2.1. Passo 1 – Cadastrar o Evento

No painel do WordPress:

  1. Acesse Gamification → Eventos.

  2. Clique em “Adicionar novo” (ou “+ Novo Evento”).

  3. Preencha os campos principais:

  • Título
     Nome do desafio, por exemplo:

    • “Comente em 5 produtos”

    • “Primeira compra”

  • Descrição
     Texto explicando o que a pessoa precisa fazer:

    • “Deixe 5 comentários em produtos da loja.”

    • “Conclua sua primeira compra no site.”

  • Tipo (opcional, só informativo)
     Serve para organização interna. Sugestões:

    • comment (comentários)

    • purchase (compras)

    • login (login)

    • referral (indicações)

  • Pontos ao completar
     Quantos pontos a pessoa vai ganhar quando terminar esse desafio.

    • Ex.: 10, 20, 100 pontos.

  • Máx. por usuário
     Quantas vezes o mesmo usuário pode ganhar essa conquista.

    • 1 → só uma vez na vida (ex.: “Primeira compra”)

    • 999 → pode repetir várias vezes (ex.: “Compra do mês”)

  • Período (Início e Fim)
     Se deixar em branco, o desafio vale “para sempre”.
     Se preencher:

    • Início – data a partir da qual o desafio começa a contar

    • Fim – data limite (útil para campanhas específicas)

  1. Marque o Status como Ativo.

  2. Clique em Salvar.

Até aqui, você só criou o “título” do desafio.
 O que faz ele funcionar de verdade são os Passos, que vêm agora.

2.2. Passo 2 – Cadastrar os Passos (regras)

  1. Acesse Gamification → Passos.

  2. Clique em “Adicionar novo passo”.

  3. Preencha os campos:

  • Evento
     Escolha o evento que você acabou de criar (ex.: “Comente em 5 produtos”).

  • Ordem
     Serve para organizar se o evento tiver vários passos.
     Para um evento simples, pode deixar 1.

  • Título do passo
     Ex.: “Comente em produtos”, “Conclua uma compra”, etc.

  • Meta / Quantidade (Target)
     Quantas ações são necessárias para completar este passo.

    • Ex.:

      • Evento “Comente em 5 produtos” → Meta = 5

      • Evento “Primeira compra” → Meta = 1

  • Métrica (metric key)
     É o tipo de contagem que esse passo vai usar.
     Você só precisa copiar exatamente o texto indicado na tabela de hooks (próxima seção).
     Exemplos:

    • product_comments (comentários em produtos)

    • orders (compras)

    • logins (logins)

    • referrals (indicações)

  • Hook
     É o “nome técnico” da ação que dispara esse passo.
     Você não precisa entender o código, só precisa usar o nome correto da tabela de hooks.
     Exemplos:

    • dgm_product_comment

    • dgm_purchase

    • dgm_login

    • dgm_referral

  1. Clique em Salvar.

A partir desse momento, sempre que a ação acontecer (login, compra, comentário etc.), o plugin aumenta automaticamente o progresso do usuário nesse passo.

2.3. Passo 3 – Configurar recompensas (opcional)

  1. Vá em Gamification → Recompensas.

  2. Adicione uma nova recompensa ligada ao seu evento.

  3. Defina:

  • Tipo – por exemplo: points, coupon, access, etc.

  • Valor – depende do tipo (por exemplo, a quantidade de pontos ou o código do cupom).

Por padrão, a parte de pontos já funciona sozinha.
 Outros benefícios (como cupom automático, frete grátis ou acesso a uma área premium) dependem de como o seu site foi configurado pelo desenvolvedor.

3. Hooks prontos que o plugin já entende

Você não precisa programar nada.
 Para criar desafios, basta usar os nomes de Hook e Métrica abaixo nos seus Passos.

3.1. Ações nativas

Ação do usuário

Hook (campo “Hook” do passo)

Métrica (campo “Métrica”)

Quando é disparado?

Fazer login no site

dgm_login

logins

Sempre que o usuário faz login no WordPress.

Concluir uma compra (WooCommerce)

dgm_purchase

orders

Quando um pedido do WooCommerce entra em processando ou concluído.

Comentar em um produto (review)

dgm_product_comment

product_comments

Quando um comentário em um produto é aprovado e o autor está logado.

Indicar um amigo (plugin de indicação)

dgm_referral

referrals

Quando o módulo de indicação dispara a ação interna do plugin (feito pelo dev).

Importante:

  • Para login, compra e comentário em produto, o plugin já está pronto e plugado no WordPress/WooCommerce.

  • Para indicação, é preciso que o seu plugin de afiliados/indicações seja integrado pelo desenvolvedor (ele vai usar o hook interno dgm_gamification_referral).

3.2. Hook genérico (para integrações personalizadas)

Existe também um hook mais avançado, usado por desenvolvedores:

  • Hook interno: dgm_gamification_trigger

Ele permite que qualquer outro plugin/sistema diga algo do tipo:
 “o usuário X acabou de completar a ação Y” e isso virar um passo na gamificação.

Para o usuário final, basta saber que:

  • se o desenvolvedor criou uma integração personalizada, ele vai te dizer:

    • qual Hook e qual Métrica você deve usar nos Passos;

    • a partir daí, você configura tudo pelo painel, como qualquer outro evento.

4. Exemplos práticos

4.1. Exemplo 1 – Desafio: “Comente em 5 produtos”

Objetivo:
 Incentivar avaliações e comentários nos produtos.

  1. Criar o evento

    • Acesse: Gamification → Eventos → Adicionar novo

    • Título: Comente em 5 produtos

    • Descrição: Deixe 5 comentários em produtos da loja.

    • Tipo: comment

    • Pontos ao completar: 12 (por exemplo)

    • Máx. por usuário: 1

    • Início/Fim: deixe em branco (vale para sempre) ou defina um período

    • Status: Ativo

    • Salvar.

  2. Criar o passo

    • Acesse: Gamification → Passos → Adicionar novo

    • Evento: Comente em 5 produtos

    • Ordem: 1

    • Título do passo: Comente em produtos

    • Métrica: product_comments

    • Meta / Quantidade: 5

    • Hook: dgm_product_comment

    • Salvar.

Resultado:
 cada vez que o usuário logado deixar um comentário aprovado em um produto, o sistema soma 1.
 Quando chegar em 5, ele completa o evento e ganha 12 pontos.

4.2. Exemplo 2 – Desafio: “Primeira compra”

Objetivo:
 Recompensar quem faz a primeira compra na loja.

  1. Evento

    • Gamification → Eventos → Adicionar novo

    • Título: Primeira compra

    • Descrição: Conclua sua primeira compra na loja.

    • Tipo: purchase

    • Pontos ao completar: 5

    • Máx. por usuário: 1

    • Status: Ativo

    • Salvar.

  2. Passo

    • Gamification → Passos → Adicionar novo

    • Evento: Primeira compra

    • Ordem: 1

    • Título do passo: Conclua uma compra

    • Métrica: orders

    • Meta / Quantidade: 1

    • Hook: dgm_purchase

    • Salvar.

Resultado:
 quando o pedido do WooCommerce desse usuário passar para processando ou concluído pela primeira vez, ele completa o desafio e ganha 5 pontos.

4.3. Exemplo 3 – Desafio com benefício extra (cupom de desconto)

Objetivo:
 Dar pontos e um cupom de desconto para quem fizer uma ação específica (por exemplo, “Comente em 5 produtos”).

Observação importante:
 a parte de pontos funciona direto.
 A parte de “cupom automático” depende de como o seu desenvolvedor configurou a integração com WooCommerce.
 Caso você não veja essa funcionalidade funcionando, converse com quem instalou o plugin.

  1. Crie o evento normalmente (como nos exemplos anteriores).

  2. Crie o passo normalmente (ex.: dgm_product_comment / product_comments / meta 5).

  3. Depois vá em Gamification → Recompensas e:

    • Adicione uma recompensa do tipo points (por exemplo, +12 pontos).

    • Adicione uma recompensa adicional, por exemplo:

      • Tipo: coupon

      • Valor: SEU-CUPOM-10 (ou o código que você já criou no WooCommerce)

Resultado esperado:
 quando o usuário completar o evento, além dos pontos, o sistema registra que ele ganhou o cupom.
 A forma como o cupom é entregue/validado (por e-mail, automaticamente no carrinho, etc.) depende da integração feita no seu site.

5. Checklist para testar se está tudo funcionando

Depois de criar um novo desafio, siga esses passos:

  1. Entre com um usuário de teste (não use só o administrador).

  2. Acesse /gamificacao/eventos e veja se o desafio aparece em Desafios ativos.

  3. Faça a ação esperada:

    • comentar em produto,

    • fazer uma compra,

    • fazer login, etc.

  4. Volte em /gamificacao/eventos:

    • verifique se o Progresso mudou (ex.: de 0/5 para 1/5, 2/5…)

  5. Vá em /gamificacao/nivel:

    • veja se os pontos subiram quando você completou um evento.

  6. Se tiver cupom / outros benefícios:

    • confirme com o desenvolvedor como eles são entregues (e-mail, tela do usuário, aplicação automática etc.).

Se tudo isso estiver acontecendo, o seu desafio está configurado corretamente ✅

Você achou esse artigo útil?