> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-es/tutoriales-y-ejemplos/scene-management-feedback/playtest-feedback.md).

# Feedback de la escena

Recopila valoraciones y comentarios de los jugadores durante el juego o mediante un botón de feedback, un kiosco o un área, con resultados CSV en el Storage de la escena.

<figure><img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-69f5277fafd637eb48de789770caff45f1000a6c%2Fscene-feedback-invitation.webp?alt=media" alt="Coin Hunt participation invitation with Skip and Give feedback buttons" width="400"><figcaption><p>La demo invita a los jugadores a elegir si quieren participar.</p></figcaption></figure>

Descubre qué les resulta confuso, frustrante o divertido a los jugadores, incluso cuando no puedes verlos jugar. Este módulo reutilizable incluye una escena de búsqueda de monedas que muestra cómo recopilar comentarios durante la partida y cuando los jugadores deciden compartirlos.

* [Jugar a la versión de prueba compartida (Zone)](https://decentraland.zone/jump/?dclenv=zone\&realm=sdk7testscenes.dcl.eth\&position=0,-1)
* [Guía de instalación y uso](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/README.md)

## Información del proyecto

**Mantenido por:** Decentraland

[Ver código fuente](https://github.com/decentraland/sdk7-test-scenes/tree/main/scenes/0,-1-scene-feedback)

**Licencia:** No se identifica en este catálogo. Consulta el repositorio original y al responsable de mantenimiento para conocer los términos aplicables antes de reutilizarlo.

## Añádelo con un agente de IA

1. Asegúrate de que [Decentraland SDK Skills](https://github.com/decentraland/sdk-skills#updating-skills) estén instaladas y actualizadas.
2. Dile a tu agente de IA: «Quiero recopilar comentarios de los jugadores en esta escena».

El agente puede usar la skill Scene Feedback para ayudarte en dos etapas:

* **Antes de una prueba de juego:** adapta las preguntas, las escalas de valoración y los tiempos a tu juego; después, integra el módulo cuando hayas revisado el plan.
* **Después de una prueba de juego:** vuelve a usar la skill con tus archivos CSV para identificar problemas y preferencias recurrentes; revisa la evidencia y decide qué investigar a continuación. También puedes solicitar un [informe HTML legible](#example-ai-generated-feedback-report) con respuestas agrupadas y resúmenes de las valoraciones.

¿Prefieres integrarlo por tu cuenta? Sigue la [guía de instalación](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/README.md#add-it-to-your-scene).

## Cómo se integra el módulo en tu escena

Tú decides cuándo invitar a los jugadores, qué preguntas hacer y cuándo aparecen en tu juego. La [demo de búsqueda de monedas en Zone](https://decentraland.zone/jump/?dclenv=zone\&realm=sdk7testscenes.dcl.eth\&position=0,-1) muestra una posible configuración:

1. **Recoge la primera moneda.** Aparece una invitación para preguntar si el jugador quiere compartir sus comentarios: «¡Hola! Somos el equipo de Coin Hunt». Si acepta, se le hace una pregunta: «¿Qué tan fácil o difícil te resultó encontrar las monedas?». El jugador elige una valoración y puede añadir un comentario.
2. **Completa la primera ronda (cinco monedas).** Los jugadores que aceptaron participar reciben dos preguntas, una después de otra: qué tan claro les parece el siguiente objetivo y si quieren seguir jugando.
3. **Comparte comentarios en cualquier momento.** Cualquier visitante puede usar el botón **Dejar comentarios** un quiosco interactivo o una zona señalizada para abrir un mensaje de bienvenida seguido de un conjunto de preguntas, incluso después de rechazar las preguntas durante la partida.

Elige cómo participan los jugadores:

* **Jugadores que aceptan participar:** invita a los jugadores con un mensaje en pantalla o permite que abran un formulario de comentarios mediante un botón, un quiosco o una zona señalizada.
* **Evaluadores seleccionados:** usa la lógica del juego para elegir evaluadores según una lista de Wallets u otra regla y, luego, inscríbelos con `feedback.enroll`. Consulta el [ejemplo de evaluadores seleccionados](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/EXAMPLES.md#4-selected-testers-without-an-intro).
* **O pregunta a cualquiera:** muestra preguntas a los visitantes durante la partida sin invitación previa ni lista de evaluadores. Los jugadores aún pueden rechazarlas. Consulta la [configuración de participación](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/README.md#asking-participants-during-play-dynamic-approach).

<figure><img src="https://raw.githubusercontent.com/decentraland/sdk7-test-scenes/main/scenes/0%2C-1-scene-feedback/assets/images/feedback-panel.png" alt="Example feedback form with five rating choices and an optional comment field" width="400"><figcaption><p>Una pregunta con una valoración etiquetada y un comentario opcional.</p></figcaption></figure>

## Características principales

* **Preguntas flexibles.** Elige preguntas y escalas de valoración listas para usar, adáptalas a tu juego o crea las tuyas. Usa valoraciones etiquetadas, comentarios opcionales o respuestas solo de texto.
* **Recompensas por participar.** Incentiva la participación con una recompensa que encaje con tu juego. En la demo, responder a todas las preguntas de un formulario otorga una placa con el nombre Playtest Contributor, visible para ti y solo durante esa visita, +5 puntos de monedas y el doble de puntos por las cinco recolecciones siguientes, una vez por visita. Se acepta cualquier valoración; los comentarios son opcionales.
* **Resultados CSV en Storage de la escena.** Un Multiplayer Server guarda cada respuesta junto con su pregunta y el momento de la partida en que se dio. Descarga los archivos para revisarlos en una hoja de cálculo.

## Adáptalo a tu escena

Usa el [recetas de integración](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/EXAMPLES.md) para conectar preguntas con los eventos de tu juego, como invitar a participantes en el momento y hacerles preguntas después de jugar. Para planificar playtests y encontrar jugadores, consulta [Playtests](https://docs.decentraland.org/creator/scenes-sdk7/designing-the-experience/playtests).

## Ejemplo de informe de comentarios generado por IA

**El informe lo crea un agente de IA, no el módulo Scene Feedback.** Proporciona a tu agente los archivos CSV exportados y usa la habilidad del SDK de Scene Feedback para analizarlos y generar un informe HTML.

Este ejemplo usa respuestas sintéticas de una escena ficticia. Tu agente puede adaptar el análisis y el informe a las preguntas y los datos de tus propios playtests.

<figure><img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-9b424161af41d71ba3d5280c1f523c0793992083%2Fscene-feedback-example-report.webp?alt=media" alt="Synthetic racing-scene report showing a main finding, response counts and a rating distribution" width="600"><figcaption><p>Informe ilustrativo basado en respuestas sintéticas de una escena ficticia.</p></figcaption></figure>

{% file src="/files/a2bb546348442bad9755ae1cae68bb5370f10351" %}
Descarga el informe de ejemplo, extrae el ZIP y abre el archivo HTML en tu navegador.
{% endfile %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-es/tutoriales-y-ejemplos/scene-management-feedback/playtest-feedback.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
