> 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-pt/tutoriais-e-exemplos/scene-management-feedback/playtest-feedback.md).

# Feedback da cena

Recolhe classificações e comentários dos jogadores durante o jogo ou através de um botão de feedback, quiosque ou área, com resultados CSV no Storage da cena.

<figure><img src="https://2402076176-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>A demonstração convida os jogadores a escolher se querem participar.</p></figcaption></figure>

Descubra o que os jogadores consideram confuso, frustrante ou agradável, mesmo quando não pode observá-los a jogar. Este módulo reutilizável inclui uma cena de caça às moedas que mostra como recolher feedback durante o jogo e quando os jogadores decidem fornecê-lo.

* [Jogar a versão de teste partilhada (Zone)](https://decentraland.zone/jump/?dclenv=zone\&realm=sdk7testscenes.dcl.eth\&position=0,-1)
* [Guia de instalação e utilização](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/README.md)

## Informações do projeto

**Mantido por:** Decentraland

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

**Licença:** Não identificada neste catálogo. Consulte o repositório de origem e o responsável pela manutenção para conhecer os termos aplicáveis antes de reutilizar.

## Adicione-o com um agente de IA

1. Certifique-se de que [Decentraland SDK Skills](https://github.com/decentraland/sdk-skills#updating-skills) estão instaladas e atualizadas.
2. Diga ao seu agente de IA: "Quero recolher feedback dos jogadores nesta cena."

O agente pode usar a skill Scene Feedback para ajudar em duas etapas:

* **Antes de um teste de jogo:** adapte as perguntas, as escalas de classificação e o momento em que são apresentadas ao seu jogo; depois, integre o módulo após rever o plano.
* **Depois de um teste de jogo:** volte a usar a skill com os seus ficheiros CSV para identificar problemas e preferências recorrentes, rever os dados e decidir o que investigar a seguir. Também pode pedir um [relatório HTML legível](#example-ai-generated-feedback-report) com respostas agrupadas e resumos das classificações.

Prefere integrá-lo por conta própria? Siga o [guia de instalação](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/README.md#add-it-to-your-scene).

## Como o módulo se integra na sua cena

É você que escolhe quando convidar os jogadores, que perguntas fazer e quando estas aparecem no seu jogo. A [demonstração de caça às moedas em Zone](https://decentraland.zone/jump/?dclenv=zone\&realm=sdk7testscenes.dcl.eth\&position=0,-1) mostra uma possível configuração:

1. **Recolha a primeira moeda.** Um convite pergunta se o jogador quer dar feedback: "Olá, somos a equipa Coin Hunt!" Se aceitar, é apresentada uma pergunta: "Quão fácil ou difícil foi encontrar as moedas?" O jogador escolhe uma classificação e pode adicionar um comentário.
2. **Termine a primeira ronda (cinco moedas).** Os jogadores que aceitaram participar recebem duas perguntas, uma de cada vez: quão claro é o próximo objetivo e se querem continuar a jogar.
3. **Dê feedback a qualquer momento.** Qualquer visitante pode usar o botão **Deixar feedback** um quiosque clicável ou uma área assinalada para abrir uma mensagem de boas-vindas, seguida de um conjunto de perguntas, mesmo que tenha recusado responder às perguntas durante o jogo.

Escolha como os jogadores participam:

* **Jogadores que aceitam participar:** convide os jogadores através de uma mensagem no ecrã ou permita-lhes abrir um formulário de feedback através de um botão, quiosque ou área assinalada.
* **Testadores selecionados:** use a lógica do seu jogo para escolher os testadores através de uma lista de carteiras ou de outra regra; depois, inscreva-os com `feedback.enroll`. Consulte o [exemplo de testadores selecionados](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/EXAMPLES.md#4-selected-testers-without-an-intro).
* **Ou pergunte a qualquer pessoa:** apresente perguntas aos visitantes durante o jogo, sem convite prévio nem lista de testadores. Os jogadores podem sempre recusar. Consulte as [definições de participação](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>Uma pergunta com uma classificação identificada e um comentário opcional.</p></figcaption></figure>

## Funcionalidades principais

* **Perguntas flexíveis.** Escolha perguntas e escalas de classificação predefinidas, adapte-as ao seu jogo ou crie as suas próprias. Use classificações identificadas, comentários opcionais ou respostas apenas em texto.
* **Recompensas por participação.** Incentive a participação com uma recompensa adequada ao seu jogo. Na demonstração, responder a todas as perguntas de um formulário dá direito a uma placa de identificação Playtest Contributor, visível apenas para si e apenas durante a visita, +5 pontos no resultado de moedas e pontuação a dobrar nas cinco recolhas seguintes, uma vez por visita. Qualquer classificação é contabilizada; os comentários são opcionais.
* **Resultados CSV no Storage da cena.** Um Multiplayer Server guarda cada resposta juntamente com a pergunta e o momento do jogo. Transfira os ficheiros para os analisar numa folha de cálculo.

## Adapte-o à sua cena

Use o [receitas de integração](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/EXAMPLES.md) para associar perguntas aos eventos do seu próprio jogo, incluindo convidar participantes agora e fazer perguntas após jogarem mais tarde. Para planear testes de jogo e encontrar jogadores, consulte [Testes de jogo](https://docs.decentraland.org/creator/scenes-sdk7/designing-the-experience/playtests).

## Exemplo de relatório de feedback gerado por IA

**O relatório é criado por um agente de IA, não pelo módulo Scene Feedback.** Forneça ao seu agente os ficheiros CSV exportados e use a competência do SDK Scene Feedback para os analisar e gerar um relatório HTML.

Este exemplo usa respostas sintéticas de uma cena fictícia. O seu agente pode adaptar a análise e o relatório às perguntas e aos dados dos seus próprios testes de jogo.

<figure><img src="https://2402076176-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>Relatório ilustrativo com respostas sintéticas de uma cena fictícia.</p></figcaption></figure>

{% file src="/files/7833c89b75c9cacd9cbccab6ef91cea6e39087ef" %}
Transfira o relatório de exemplo, extraia o ZIP e abra o ficheiro HTML no seu 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-pt/tutoriais-e-exemplos/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.
