O que Mapsake envia quando você envia feedback

Seu feedback deve ser compreensível antes de você enviá-lo.

Bons relatórios de bugs tornam o Mapsake melhor, mas um relatório útil não deve exigir a entrega de um conjunto misterioso de dados pessoais. A tela de feedback no Mapsake mostra controles separados para diferentes tipos de diagnósticos para que você possa decidir o que incluir em sua mensagem.

O novo formulário de feedback do site é a rota mais simples: escolha uma categoria, escreva uma mensagem e, opcionalmente, inclua um endereço de e-mail para uma resposta. Não aceita anexos nem coleta dados de diagnóstico do aplicativo, pois um navegador não pode inspecionar seu banco de dados Mapsake privado.

O formulário dentro do aplicativo pode incluir mais contexto, mas apenas por meio das opções descritas abaixo.

Os campos de mensagem e contato

Cada relatório inclui a categoria e o texto que você insere. As informações de contato são opcionais. Se você não fornecer um endereço de e-mail, o relatório ainda pode ser lido e considerado, mas pode não haver como fazer uma pergunta de acompanhamento.

Evite incluir senhas, chaves de API, links completos de gerenciamento de compartilhamento público ou registros pessoais irrelevantes na mensagem. Se um bug puder ser demonstrado com um nome de local genérico ou uma data aproximada, use o exemplo menos sensível que ainda explique o problema.

Registros e informações de desempenho

O interruptor de diagnóstico principal dentro do aplicativo está habilitado por padrão porque, muitas vezes, fornece o contexto necessário para distinguir um problema de exibição de um problema de dados ou sincronização. Ele pode incluir:

• registros de diagnóstico recentes do Mapsake;
• medições de desempenho em tempo real da sessão atual;
• estatísticas resumidas sobre o banco de dados de imagens do explorador de fotos local;
• Estado de diagnóstico do Maplight.

Os registros descrevem o que o aplicativo estava fazendo, quais operações falharam e contagens ou tempos aproximados. Eles não devem incluir dados de imagem de fotos. As medições de desempenho podem mostrar tarefas lentas, comportamento de quadros e condições de recursos que são difíceis de reproduzir apenas com uma descrição escrita.

Você pode desativar esta opção antes de enviar.

diagnóstico do iCloud e sincronização

Os problemas de sincronização são incomumente difíceis de entender em um dispositivo porque o evento importante pode ter ocorrido em outro local. A opção de diagnóstico do iCloud separada pode incluir informações técnicas mais detalhadas: identificadores do CloudKit e de registro local, contexto do dispositivo e da rede, eventos e erros de sincronização e os registros de sincronização locais necessários para diagnosticar a convergência.

É por isso que é uma caixa de seleção separada e explícita. O pacote pode ser detalhado, mas é projetado para não incluir suas fotos, senhas, tokens de API, chaves de assinatura ou segredos de administração brutos.

Use-o quando o problema se refere a alterações ausentes, duplicatas, um dispositivo que não sincroniza ou um estado do iCloud que se comporta de maneira diferente em seus dispositivos Apple. Não o use para problemas visuais ou de texto não relacionados.

Diagnóstico de importação de países e fotos

Se um país ou região estiver faltando, presente inesperadamente ou recebendo evidências fotográficas incorretas, as informações de diagnóstico do país podem incluir informações sobre as fotos que contribuíram para aquele local: metadados de localização e data, dispositivo de origem e os motivos pelos quais um filtro incluiu ou excluiu a evidência.

Os pixels reais da imagem não estão incluídos com essa caixa de seleção. O objetivo é explicar a decisão de correspondência sem copiar a biblioteca de fotos para um relatório de suporte.

Esta opção é mais útil quando você pode nomear o país afetado e descrever o resultado esperado. Se o problema envolver apenas uma ou duas fotos, uma captura de tela cuidadosamente selecionada pode comunicar mais claramente do que um conjunto de diagnóstico grande.

Amigos e diagnóstico de compartilhamento

Problemas com amigos e mapas públicos podem envolver vários estados: um código de compartilhamento, se um registro é acessível e quais nomes de lugares estavam presentes em um instantâneo generalizado. O diagnóstico de amigos pode incluir esse estado de compartilhamento para que a falha possa ser localizada.

Não adiciona as fotos de seus amigos. Ao relatar um link público, não cole nenhuma credencial de gerenciamento privado na mensagem. O slug público comum ou o código de compartilhamento geralmente é suficiente.

Capturas de tela e gravações de tela.

O aplicativo permite que você anexe até cinco capturas de tela ou vídeos. Esses arquivos são diferentes das caixas de seleção de diagnóstico: você escolhe cada um deles e pode revisá-los antes de enviá-los.

Verifique a imagem inteira em busca de notificações, endereços de e-mail, rostos, localizações no mapa ou outro conteúdo não necessário para o relatório. Recorte ou censure quando possível. Uma gravação curta que começa imediatamente antes do problema é frequentemente mais útil e menos reveladora do que uma gravação longa de toda a sessão.

O formulário do site é exclusivamente textual. Essa limitação reduz o spam e evita a criação de um segundo sistema de upload público para arquivos confidenciais.

O que o site usa para desencorajar o spam.

O formulário público usa o Cloudflare Turnstile para distinguir envios normais de abusos automatizados. O Turnstile recebe as informações de navegador e rede necessárias para avaliar o desafio no serviço da Cloudflare. O Mapsake verifica no servidor o resultado de curta duração antes de armazenar um envio.

O formulário também usa um campo "honeypot" oculto, limites de tamanho de solicitação, verificações de origem e uma limitação de taxa temporária por endereço. A Mapsake não armazena o endereço IP do remetente com o registro de feedback.

Se o serviço anti-spam estiver indisponível ou não estiver configurado, o formulário falha em vez de aceitar um ataque de spam não verificado. O e-mail de suporte permanece disponível.

O que acontece após a submissão?

Os relatórios do site e do aplicativo entram na mesma fila de revisão administrativa privada, com sua origem claramente identificada. O feedback do site armazena sua categoria, mensagem, endereço de contato opcional e horário de envio. Os relatórios do aplicativo podem incluir o texto de diagnóstico e os anexos que você selecionou.

Os relatórios são usados para responder a solicitações de suporte, reproduzir bugs, priorizar melhorias e entender onde a documentação não está clara. Eles não são publicados como depoimentos ou adicionados a uma lista de marketing ao enviar o formulário.

Um relatório útil em cinco linhas.

Os relatórios mais eficazes geralmente incluem:

1. o que você estava tentando fazer;
2. a ação exata imediatamente anterior ao problema;
3. o que você esperava;
4. o que realmente aconteceu;
5. se acontece sempre.

Adicione a versão do Mapsake e o dispositivo, se possível. Para uma solicitação de recurso, explique a tarefa subjacente em vez de apenas a interface que você imagina. "Preciso distinguir as conexões de aeroportos dos destinos" fornece mais contexto de design do que "adicione outro botão."

Os controles existem para que detalhes úteis e consentimento informado possam coexistir. Envie o pacote mais pequeno que possa explicar o problema e use os interruptores de diagnóstico individuais quando o contexto adicional for realmente relevante.