Quadros de líderes

Leaderboards permite ao criador de um DApp implantado com o DexAppBuilder adicionar vários sistemas de pontuação para recompensar os usuários do seu DApp sempre que executarem quaisquer das ações predefinidas no sistema.

Para o caso específico deste recurso, criaremos um DApp de demonstração. Será um mercado de NFTs semi-privado. O criador (nós) pode publicar NFTs à venda sem restrições e também pode aceitar listings da comunidade.

Ações predefinidas configuráveis

Entre essas ações predefinidas estão:

• Trocar tokens: Conceder N quantidade de pontos ao usuário que realiza uma operação de troca usando o componente de swap.

• Login no DApp: Dar N número de pontos ao usuário toda vez que ele fizer login com sua carteira no DApp. Isso é controlado por assinaturas digitais.

• Aceitar listing ERC721: Conceder N número de pontos ao usuário que tem seu listing aceito para um token não fungível com características ERC721. Por exemplo, para o nosso marketplace de NFTs semi-privado, quando “Usuário” é um empreendedor que quer vender seus tokens ERC721 lá, podemos aceitar o listing de tokens do “Usuário” e este receberá N número de pontos mediante sua aceitação como criador ou superadmin.

• Aceitar listing ERC1155: Esta regra é semelhante à anterior, mas com tokens ERC1155.

• Aceitar oferta ERC721: Conceder N número de pontos a um usuário quando ele aceita uma oferta por um token ERC721. Em outras palavras, quando o usuário vende o token, ele recebe os pontos por essa ação.

• Aceitar oferta ERC1155: Semelhante à regra anterior, exceto que recompensa usuários pela compra de tokens ERC1155.

• Comprar de coleção Drop: Concede N número de pontos ao usuário que compra um token de uma coleção drop implantada usando contratos inteligentes Thirdweb incluídos no DexAppBuilder.

• Comprar edição Drop: Conceder N quantidade de pontos ao usuário que compra um token de um contrato Edition Drop.

Criando o primeiro Leaderboard

Porque é muito mais fácil explicar um conceito por meio de exemplos, abaixo mostramos como criar seu primeiro leaderboard para seus usuários.

Primeiramente, você deve ter em mente que várias condições se aplicam para que seus leaderboards tenham sucesso e para obter as métricas corretas para seu DApp.

• Você deve ter um DApp criado com DexAppBuilder: é o primeiro passo para poder acessar o sistema. Por sua vez, recomendamos que você crie os leaderboards depois de ter o DApp finalizado para que as pontuações não sejam contaminadas e você possa oferecer uma experiência justa aos seus usuários. Leia aqui sobre como criar seu primeiro DApp.

• Você deve ter implantado os contratos necessários para medir as ações predefinidas: Nos casos de ações que envolvem contratos Thirdweb, é necessário ter os contratos previamente implantados para que as pontuações funcionem.

• Certifique-se de que um dos seus primeiros passos seja importar as coleções e tokens NFT que você deseja aceitar em seu DApp. Isso facilitará muito a configuração de todos os recursos posteriormente. Você pode consultar nesta documentação sobre como importar tokens personalizados em seu DApp e como importar coleções NFT personalizadas também.

• Use uma testnet, para testar: O DexAppBuilder fornece acesso a várias redes de teste para que você possa “cometer erros de graça” 😅 não queremos que você perca dinheiro criando seus produtos, portanto recomendamos usar essas redes a seu favor (Polygon Mumbai, Ethereum Goerli e Sepolia, Blast Sepolia). Você pode obter tokens de teste aqui para Polygon Mumbai, aqui para Ethereum Goerli e aqui para Blast Sepolia (e outras poucas).

• Seja paciente: você está lidando com software em beta que, embora seguro, às vezes pode apresentar falhas na interface gráfica. Se você vir algo estranho, reporte em nosso Discord ou vá para o Canny e nos envie seus pedidos de recurso.

Uma vez dentro, observaremos o painel. Como é a primeira vez, estará vazio.

Vamos adicionar o primeiro leaderboard clicando no botão azul “Add leaderboard”.

No modal que foi aberto procedemos a dar um nome à tabela e uma descrição apropriada. Depois podemos editá-los.

Depois de terminar de preencher ambos os campos, clicamos no botão «Save» e voltamos ao painel. Podemos ver nossa primeira tabela criada na lista. No final da linha podemos ver uma lista de ações, nomeadamente:

• Visualizar leaderboard do app: Veja como as classificações de usuários estão indo nesta tabela específica.

• Editar leaderboard: Este é o primeiro passo para configurar a tabela. Por sua vez, pode ser usado posteriormente para editar os metadados da tabela.

• Exportar leaderboard: para sua conveniência, você pode exportar esses dados para seu dispositivo usando um arquivo csv que permite processar as informações de forma mais flexível.

• Excluir leaderboard do app: Excluir esta tabela e todos os seus dados. Cuidado! Esta ação é irreversível! Nem mesmo o DexKit poderá recuperar estes dados.

Configurando nosso leaderboard

Já criamos nosso primeiro leaderboard e agora precisamos configurá-lo para conter as regras predefinidas que darão várias pontuações aos usuários do seu DApp.

No caso deste exemplo, criamos um leaderboard chamado “Summer Season 2024” no qual colocaremos um conjunto de regras gamificadas (ou ações) que recompensarão os usuários que as cumprirem. A seguir, resumimos as regras que usaremos para esta tabela. Para acessar a configuração da tabela, clique no botão no final da linha.

Uma vez na configuração do leaderboard podemos ver a seguinte tela:

1. Regra 1: Queremos que os usuários que fizerem login (autenticarem-se no DApp) recebam 1 ponto. Essas autenticações durarão exatamente 24 horas, portanto esta regra pode ajudá-lo a saber se um usuário está autenticado diariamente com base em 1 ponto por dia.

1. Regra 2: Ao mesmo tempo, queremos que os usuários que usam a plataforma de troca de tokens recebam 3 pontos sempre que fizerem um swap de tokens. Com isso recompensamos a preferência do usuário de forma equilibrada.

Esta condição particular nos permite personalizar amplamente o que, como e quem recompensar com a pontuação específica. Podemos escolher a rede, o token e a quantidade necessária para satisfazer esta condição. Condições para quantias são gt (maior que), gte (maior ou igual), lt (menor que), lte (menor ou igual) e eq (igual).

1. Regra 3: Como nosso DApp de exemplo é um marketplace de NFTs semi-privado, também podemos conceder pontos aos usuários que sugerem listings para NFTs dos padrões ERC721 e ERC1155 especificamente. Nós, como criadores, aceitaremos o listing específico e com essa ação concederemos 5 pontos ao usuário.

1. Regra 4: Esta regra refere-se a um evento em que uma oferta por um token ERC721 é aceita.

• Pontos: Isso representa os pontos atribuídos a esta ação específica dentro do sistema.

• Filtro: Abaixo dos pontos, há uma seção para definir filtros.

• Escolha a rede: Selecione a rede alvo. Deve ser a mesma da coleção NFT que você está importando.

• Importar: Esta opção pode permitir ao usuário importar dados de suas próprias coleções NFT a partir do endereço do contrato.

• Suas coleções: O usuário pode selecionar entre várias coleções que ele listou no DApp.

• Pesquisar token: Você pode escolher um token específico dentro da coleção.

• Condição de quantidade - Esta é uma condição que será aplicada ao campo de quantidade abaixo.

• Quantidade - Insira aqui uma quantidade para especificar que a regra deve se aplicar apenas quando a quantidade for maior que a cifra especificada (10 tokens MATIC na Testnet Mumbai neste exemplo).

Quando terminarmos de configurar as regras do nosso leaderboard, clicamos no botão «Save» no final da página para registrar todas as regras.

Verificando nosso leaderboard

Depois de termos nosso leaderboard funcionando com as regras escolhidas, você pode ir à opção Leaderboards, procurar o quadro que acabou de criar e clicar no primeiro ícone para uma pré-visualização do leaderboard como abaixo 👇

Exportando os dados do nosso leaderboard

Para baixar todos os dados deste leaderboard você pode clicar no ícone que abrirá um modal com um botão para baixar um arquivo CSV (Comma-Separated Values) 👇

Esta opção é de grande ajuda quando seu DApp tem muitos usuários e você precisa refinar informações rapidamente.

Excluindo nosso leaderboard

Clicando no você excluirá o leaderboard associado.