Países e idiomas

Duas perguntas parecem ser uma só, mas não são. "Onde estão os meus leitores?" é respondida por uma consulta de IP e é confiável no nível do país. "Que idioma eles querem?" não é respondida em nenhum lugar deste produto, e esta página tem o cuidado de deixar isso claro — o que é medido, em vez disso, é em qual tradução da sua documentação os leitores acabaram, o que é um dado de oferta, não de demanda.

O relatório útil é a combinação: um país que envia leitores para você e não coloca nenhum deles em uma página traduzida é um mercado que você já atrai e perde na barreira linguística.

O que você obtém#

Três indicadores, em dois lugares:

A leitura desses dados não consome nada do saldo do seu projeto. As abas Países e Idiomas estão disponíveis em todos os planos; a página por idioma e o mapa de visitantes com zoom são pagos.

Como o país é determinado#

Na borda, a partir do IP, no lado do servidor. A rede que atende à sua documentação resolve o IP da solicitação para um código de país e o anexa à visualização de página antes que ela seja armazenada, juntamente com a região, a cidade e a coordenada que foram determinadas. Nada é solicitado ao navegador, e nenhuma permissão de localização é solicitada.

Quando a consulta não produz nenhum resultado, o campo é completamente omitido, em vez de ser gravado como vazio. Essa distinção é fundamental: um campo explicitamente vazio é interpretado pela camada de consulta como presente, mas em branco, o que tornaria indistinguível "não sabemos" de um valor real. Uma visualização de página sem país ainda é uma visualização de página e continua sendo contabilizada em todos os outros lugares.

As coordenadas são gravadas todas ou nenhuma — uma latitude sem a longitude correspondente colocaria um leitor no Golfo da Guiné — e passam por uma verificação de intervalo antes de serem armazenadas.

A região, a cidade e a coordenada são capturadas, mas usadas por uma única interface: o mapa de visitantes com zoom. Os indicadores de países usam o código do país e nada mais detalhado.

Como o idioma é determinado#

Do prefixo de localidade da URL em que o leitor chegou. Essa é a única fonte. O Docsbook é compatível com 15 códigos de idioma; quando o primeiro segmento do caminho é um deles e é um idioma que você habilitou, esse é o idioma da visita. Quando não há prefixo, a visita não tem idioma e é contabilizada como uma leitura do seu original.

O que não é:

• Não é Accept-Language. O Docsbook nunca lê esse cabeçalho, em lugar algum.
• Não é navigator.language.
• Não é uma preferência de leitor armazenada.

O Docsbook também não redireciona os leitores por idioma nem os direciona por geolocalização, portanto um leitor chega a uma tradução escolhendo-a — no seletor de idioma, por meio de um link ou de um resultado de busca. É isso que torna o número honesto e também o limita: ele mede qual tradução foi lida, não qual era desejada. Um leitor que teria preferido alemão, nunca encontrou a versão em alemão e leu a versão em inglês é contabilizado como leitor de inglês.

Os dois indicadores de leitura por idioma diferem em um aspecto importante:

• O painel Traduções mostra na lista de idiomas apenas o tráfego de traduções — seu próprio idioma padrão é excluído, porque o idioma do próprio site não é uma tradução.
• A aba Análises → Público → Idiomas inclui tudo e classifica as visitas sem prefixo de localidade como Desconhecido.

Como os relatórios são criados#

A aba Países (Analytics → Audience)#

Um país por visita — o primeiro país não vazio nos eventos dessa visita — o que torna a dimensão de valor único, portanto as contagens de visitantes particionam a janela e somam o total. As visitas são encerradas após um período de 30 minutos de inatividade. Bots e sua própria equipe são excluídos, assim como em toda essa página. A lista contém os 15 primeiros, classificados no servidor por visitantes, de modo que a alteração da métrica reordena uma lista em vez de buscar uma lista diferente. As linhas sem país identificado aparecem como Desconhecido; não há uma categoria “Outros”, e as linhas além do limite simplesmente não são retornadas.

Não há supressão por amostra mínima nessas linhas: um país com um leitor é exibido como um país com um leitor. A resposta é marcada como uma estimativa, pois um visitante é um IP com hash.

A lista de países e o mapa de leitores (traduções)#

Os 30 principais países, classificados pelo número de leitores distintos, cada um exibindo tanto sua contagem de visitantes quanto sua contagem de visualizações de página. Ao lado de cada um está a proporção dos leitores desse país que acessaram uma página traduzida, limitada para nunca exceder 100% — um leitor que consultou dois idiomas conta uma vez por idioma nos números brutos e, portanto, não deve aparecer como 150% atendido.

Um cuidado ao comparar as telas. A porcentagem exibida nesta lista é uma proporção do subtotal dos 30 principais, enquanto as proporções nos cartões de detalhamento do Analytics correspondem à janela inteira. Dois números corretos sobre o mesmo país podem diferir somente por esse motivo.

Cada país é um marcador no mapa — sua bandeira em um anel, dimensionada de acordo com quantos leitores enviou — e o anel apresenta a comparação:

Seu próprio idioma nunca é relatado como uma tradução ausente, e uma janela não medida aparece em cinza em vez de vermelho; assim, uma lacuna na medição nunca pode parecer uma lacuna na cobertura.

O mapa de visitantes com zoom#

Três níveis, escolhidos pelo zoom: países, depois regiões e, por fim, leitores individuais. O local onde um marcador é desenhado depende do que o evento realmente continha:

• Uma linha que nomeia uma região ou cidade e tem uma coordenada é desenhada nessa coordenada.
• Todo o restante é desenhado no centroide do país, a partir de uma tabela estática de 125 códigos de países, e é rotulado como aproximado.
• Uma linha referente a todo um país não recebe a localização exata mesmo quando tem uma coordenada, porque a coordenada média de um país inteiro é um ponto no meio dele — para os Estados Unidos, um campo no Kansas.
• Um país que a tabela não conhece é contabilizado, mas não desenhado, e o mapa informa quantos leitores desse tipo existem, em vez de simplesmente ignorá-los. Um código desconhecido nunca é resolvido para 0, 0: "não sabemos onde fica" e "eles estão no oceano" precisam ser respostas diferentes.

Por que esta é a maneira correta#

Limites e questões em aberto#

• A indicação de idioma representa oferta, não demanda. Ela responde a "em qual tradução os leitores acabaram", e não pode responder a "qual tradução os leitores querem". Qualquer superfície do produto que descreva esta lista como preferência do navegador está descrevendo algo que o Docsbook não coleta.
• Um país é uma rede, não uma pessoa. Uma VPN corporativa coloca todos os funcionários onde o túnel termina; uma rede móvel pode estar a cem quilómetros de distância; um IP com hash reúne todos os que estão atrás de um NAT em um único leitor. Leia as linhas de países como uma classificação, nunca como uma contagem de pessoas.
• A geografia dentro de um país é limitada. A maioria das visualizações de página armazenadas não carrega coordenada alguma, portanto o mapa de visitantes é composto principalmente por centroides de países, com uma minoria de localizações precisas. Isso é declarado no mapa, em vez de ser suavizado.
• Não é aplicado um mínimo de amostra a estas linhas. Um país com três leitores é exibido ao lado de um com três mil, e a percentagem ao lado do menor varia em pontos inteiros por leitor.
• A escala de cores precisa de pelo menos um idioma de tradução ativado para dizer algo útil. Sem nenhum ativado, todos os países ficam cinzentos, corretamente.
• Trinta dias constituem todo o histórico. Não há uma leitura sazonal ou interanual de um mercado a partir destes dados.
• Em questão: "mercado não atendido" é uma hipótese, não uma conclusão. O que é verificável é que leitores do país X chegaram e não acessaram uma página traduzida. O que não é verificável é o motivo — não existia tradução, existia uma e não era encontrável, ou esses leitores preferem ler em inglês. A escala de cores distingue os dois primeiros casos pelo facto de o idioma estar ativado ou não; ela não pode distinguir o terceiro de nenhum dos outros dois. Trate um país vermelho como uma questão a ser testada com uma tradução, não como uma perda medida.

Como abri-los#

• Abas Países e idiomas — Float Widget → Análises → o cartão Público, depois selecione a aba.
• Lista de países e mapa de leitores — Float Widget → Traduções. Passe o cursor sobre um marcador para ver os leitores desse país, a participação em uma tradução e o principal idioma em que leem; passar o cursor sobre uma linha da lista destaca o mesmo país no mapa. Arraste para deslocar; os controles no canto ampliam e redefinem a visualização para os países onde você realmente tem leitores.
• Um idioma por vez — abra Traduções e selecione um idioma na barra lateral para ver quanto do próprio público ele alcança e quanto isso custou.

Relacionados#

• Como funciona a medição — identidade do visitante, filtragem de bots e por que toda contagem aqui é uma estimativa
• Visão geral da análise — o cartão Audiência onde estas abas ficam e como filtrar o painel por país
• Configurações de tradução — ativação de um idioma para uma região que este relatório sinaliza em vermelho
• Como funcionam as traduções por IA — o que uma execução de tradução faz e quanto custa
• Eventos rastreados — docs.language_switch, o único evento que registra um leitor alterando o idioma deliberadamente