Clasificaciones

Los tablones de clasificación permiten al creador de una DApp desplegada con DexAppBuilder añadir varios sistemas de puntuación para recompensar a los usuarios de su DApp cada vez que ejecutan cualquiera de las acciones predefinidas en el sistema.

Para el caso específico de esta función crearemos una DApp de demostración. Será un mercado de NFT semi-privado. El creador (nosotros) puede publicar NFTs a la venta sin restricciones y también puede aceptar listados de la comunidad.

Acciones predefinidas configurables

Entre esas acciones predefinidas están:

• Intercambiar tokens: Otorgar N cantidad de puntos al usuario que realice una operación de intercambio usando el componente de swap.

• Inicio de sesión en la DApp: Dar N número de puntos al usuario cada vez que inicie sesión con su wallet en la DApp. Esto se controla mediante firmas digitales.

• Aceptar listado ERC721: Conceder N número de puntos al usuario que sea aceptado para listar un token no fungible con características ERC721. Por ejemplo, para nuestro mercado de NFT semi-privado, cuando “Usuario” es un emprendedor que quiere vender sus tokens ERC721 allí, podemos aceptar el listado de tokens de “Usuario” y este recibirá N número de puntos al ser aceptado por ti como creador o superadmin.

• Aceptar listado ERC1155: Esta regla es similar a la anterior pero con tokens ERC1155.

• Aceptar oferta ERC721: Otorgar N número de puntos a un usuario cuando acepta una oferta por un token ERC721. En otras palabras, cuando el usuario compra el token obtiene los puntos por esta acción.

• Aceptar oferta ERC1155: Similar a la regla anterior, excepto que recompensa a los usuarios por comprar tokens ERC1155.

• Comprar colección Drop: Premia con N número de puntos al usuario que compre un token de una colección drop desplegada usando contratos inteligentes Thirdweb incluidos en DexAppBuilder.

• Comprar edición Drop: Otorgar N cantidad de puntos al usuario que compra un token de un contrato Edition Drop.

Creando el primer tablón de clasificación

Dado que es mucho más fácil explicar un concepto mediante ejemplos, a continuación te mostramos cómo crear tu primer tablón de clasificación para tus usuarios.

Antes que nada, debes tener en cuenta que se aplican varias condiciones para que tus tablones de clasificación tengan éxito y tomen las métricas correctas para tu DApp.

• Debes tener una DApp creada con DexAppBuilder: es el primer paso para poder acceder al sistema. A su vez, recomendamos que crees los tablones de clasificación una vez que tengas la DApp terminada para que las puntuaciones no se contaminen y puedas ofrecer una experiencia justa a tus usuarios. Lee aquí sobre cómo crear tu primera DApp.

• Debes haber desplegado los contratos que necesitas para medir las acciones predefinidas: En los casos de acciones que implican contratos Thirdweb, es necesario tener los contratos desplegados previamente para que las puntuaciones funcionen.

• Asegúrate de que uno de tus primeros pasos sea importar las colecciones y tokens NFT que quieras aceptar en tu DApp. Esto hará todo más fácil a la hora de configurar todas las funciones más adelante. Puedes consultar en esta documentación sobre cómo importar tokens personalizados en tu DApp y cómo importar colecciones NFT personalizadas también.

• Usa una testnet, para probar: DexAppBuilder proporciona acceso a varias redes de prueba para que puedas “cometer errores gratis” 😅 no queremos que pierdas dinero creando tus productos, así que recomendamos usar estas redes a tu favor (Polygon Mumbai, Ethereum Goerli y Sepolia, Blast Sepolia). Puedes conseguir tokens de prueba aquí para Polygon Mumbai, aquí para Ethereum Goerli y aquí para Blast Sepolia (y algunas otras).

• Ten paciencia: estás tratando con software en beta que, si bien es seguro, a veces puede presentar fallos en la interfaz gráfica. Si ves algo extraño, repórtalo en nuestro Discord o ve a Canny y envíanos tus solicitudes de funciones.

Una vez dentro observaremos el panel. Al ser la primera vez estará vacío.

Vamos a agregar el primer tablón de clasificación haciendo clic en el botón azul “Agregar tablón” (Add leaderboard).

En el modal que se ha abierto procedemos a darle a la tabla un nombre y una descripción adecuada. Más adelante podremos editarlos.

Una vez terminemos de llenar ambos campos, hacemos clic en el botón «Guardar» y volvemos al panel. Podemos ver nuestra primera tabla creada en la lista. Al final de la fila podemos ver una lista de acciones, a saber:

• Vista previa del tablón en la app: Echa un vistazo a cómo van las clasificaciones de usuarios en esta tabla específica.

• Editar tablón: Este es el primer paso para configurar la tabla. A su vez, puede usarse más adelante para editar los metadatos de la tabla.

• Exportar tablón: para tu comodidad, puedes exportar estos datos a tu dispositivo usando un archivo csv que te permite procesar la información con mayor flexibilidad.

• Eliminar tablón de la app: Eliminar esta tabla y todos sus datos. ¡Ten cuidado! ¡Esta acción es irreversible! Ni siquiera DexKit podrá recuperar estos datos.

Configurando nuestro tablón de clasificación

Ya hemos creado nuestro primer tablón de clasificación y ahora necesitamos configurarlo para que contenga las reglas predefinidas que otorgarán diversas puntuaciones a los usuarios de tu DApp.

En el caso de este ejemplo, creamos un tablón llamado “Summer Season 2024” en el que colocaremos un conjunto de reglas gamificadas (o acciones) que recompensarán a los usuarios que las cumplan. A continuación, resumamos las reglas que usaremos para esta tabla. Para acceder a la configuración de la tabla haz clic en el botón al final de la fila.

Una vez que estamos en la configuración del tablón podemos ver la siguiente pantalla:

1. Regla 1: Queremos que los usuarios que inicien sesión (autentiquen en la DApp) reciban 1 punto. Estas autenticaciones durarán exactamente 24 horas, por lo que esta regla puede ayudarte a saber si un usuario se autentica diariamente basándote en 1 punto por día.

1. Regla 2: Al mismo tiempo, queremos que los usuarios que usen la plataforma de intercambio de tokens reciban 3 puntos cada vez que realicen un swap de tokens. Con esto recompensamos la preferencia del usuario de forma equilibrada.

Esta condición en particular nos permite personalizar ampliamente qué, cómo y a quién recompensar con la puntuación específica. Podemos elegir la red, el token y la cantidad necesaria para satisfacer esta condición. Condiciones para cantidades son gt (mayor que), gte (mayor o igual), lt (menor que), lte (menor o igual) y eq (igual).

1. Regla 3: Dado que nuestra DApp de ejemplo es un mercado de NFT semi-privado, también podemos otorgar puntos a los usuarios que sugieran listados para NFTs con estándares ERC721 y ERC1155 específicamente. Nosotros como creadores aceptaremos el listado específico y con esa acción otorgaremos 5 puntos al usuario.

1. Regla 4: Esta regla se refiere a un evento donde se acepta una oferta por un token ERC721.

• Puntos: Esto representa los puntos asignados a esta acción en particular dentro del sistema.

• Filtro: Debajo de los puntos, hay una sección para configurar filtros.

• Elige red: Selecciona la red objetivo. Debe ser la misma que la de la colección NFT que estás importando.

• Importar: Esta opción puede permitir al usuario importar datos de sus propias colecciones NFT a partir de la dirección del contrato.

• Tus colecciones: El usuario puede seleccionar entre varias colecciones que haya listado en la DApp.

• Buscar token: Puedes elegir un token específico dentro de la colección.

• Condición de cantidad - Esta es una condición que se aplicará al campo de cantidad que aparece debajo.

• Cantidad - Ingresa una cantidad aquí para especificar que la regla solo debe aplicarse cuando la cantidad sea mayor que la cifra especificada (10 tokens MATIC en Mumbai Testnet en este ejemplo).

Una vez que terminemos de configurar las reglas de nuestro tablón, hacemos clic en el botón «Guardar» al final de la página para registrar todas las reglas.

Comprobando nuestro tablón de clasificación

Una vez que tengamos nuestro tablón funcionando con las reglas que elegiste, puedes ir a la opción Leaderboards, buscar el tablero que acabas de crear y hacer clic en el primer ícono para una vista previa del tablón como abajo 👇

Exportando los datos de nuestro tablón

Para descargar todos los datos de este tablón puedes hacer clic en el ícono que abrirá un modal con un botón para descargar un archivo CSV (Valores Separados por Comas) 👇

Esta opción es de gran ayuda cuando tu DApp tiene muchos usuarios y necesitas refinar información rápidamente.

Eliminando nuestro tablón

Al hacer clic en el eliminarás el tablón asociado.