Um livro de códigos é a lista de categorias que um pesquisador usa para transformar respostas abertas de pesquisa em algo que dá para contar. Pergunte a mil pessoas "o que poderíamos melhorar?" e você vai ter mil frases diferentes. Aplique um livro de códigos e você tem uma tabela: 34% mencionou preço, 19% mencionou velocidade de entrega, 11% mencionou uma funcionalidade específica. O livro de códigos é o que torna esse segundo passo possível.

Parece um detalhe de infraestrutura, e é uma das poucas coisas na pesquisa de mercado onde uma decisão ruim no início sai cara de corrigir depois — cada onda, cada relatório, cada tabulação cruzada construída em cima herda o que o livro de códigos tinha de errado.

O que é exatamente

Estruturalmente, um livro de códigos é uma lista — plana ou hierárquica — de categorias, cada uma com uma definição curta do que entra ali, aplicada a uma pergunta aberta. "Preço", "Atendimento", "Qualidade do produto", "Embalagem", "Outros" é um livro de códigos para uma pergunta de satisfação. Cada categoria da lista é um código; codificar uma resposta é atribuir a ela um ou mais desses códigos.

Em inglês, o documento completo costuma ser chamado de codebook, e a lista de categorias em si, de codeframe — uma distinção que em português quase ninguém faz: aqui "livro de códigos" cobre as duas coisas, e quem usa a palavra "codeframe" (cada vez mais comum pela influência de softwares em inglês) geralmente está falando da mesma coisa.

É a mesma coisa que um "codeframe"?

Em sentido estrito, o codeframe é a lista de categorias — os nomes e a hierarquia. O livro de códigos (codebook) é essa lista mais tudo o que um codificador precisa para aplicá-la de forma consistente: uma definição por código, alguns exemplos reais, e as regras de caso-limite que foram decididas na segunda semana de codificação ("se mencionarem um funcionário pelo nome, vai em Atendimento, não num código próprio para essa pessoa"). No dia a dia quase ninguém distingue os dois termos, e não precisa: o que importa não é como você chama, e sim se o documento com o qual seus codificadores — humanos ou de IA — trabalham tem essa segunda parte, definições e exemplos, e não só uma lista de nomes. Uma lista de nomes é uma aposta na consistência. Uma definição com dois ou três exemplos reais é o que faz dois codificadores diferentes, ou o mesmo codificador em dois dias diferentes, chegarem ao mesmo código para a mesma resposta.

A anatomia de um livro de códigos

Um livro de códigos para "O que poderíamos melhorar?" numa pesquisa de satisfação de varejo poderia ser assim:

Código                  Definição
Preço                   Menções a custo, custo-benefício ou pedidos de desconto
Qualidade do produto    Reclamações ou elogios sobre durabilidade ou desempenho
Entrega                 Velocidade, custo, avarias ou rastreamento da entrega
Atendimento             Interações com equipe, suporte ou processo de troca
Site / app              Facilidade de uso da loja online ou do aplicativo
Outros                  Não se encaixa em nenhuma das anteriores; vago demais para codificar

Duas coisas nessa lista fazem mais trabalho do que parece. A linha Outros é um código como qualquer outro, e vale a pena acompanhar sua taxa: se 30% das respostas terminam ali, o livro de códigos está sem uma categoria real, não descrevendo uma amostra incomumente vaga. E as definições são curtas de propósito — uma definição que leva um parágrafo para ler é uma definição que ninguém aplica do mesmo jeito sob pressão de prazo.

Livros de códigos reais raramente são tão curtos assim. Uma pergunta aberta bem trabalhada num estudo de tracking grande pode ter entre vinte e sessenta códigos, e nesse tamanho uma lista plana deixa de ser utilizável — por isso a maioria das plataformas de codificação, a nossa inclusive, permite agrupar códigos sob uma categoria e uma subcategoria (Qualidade do produto › Durabilidade, Qualidade do produto › Desempenho) em vez de forçar sessenta itens numa lista só, sem diferenciação. A hierarquia não muda o que é contado; muda se uma pessoa consegue escanear o livro de códigos e achar o que precisa em dez segundos em vez de dois minutos.

O que torna um livro de códigos bom

Quatro propriedades, na ordem em que costumam ser descobertas como erros, e não planejadas como metas:

  • As categorias não se sobrepõem. Se uma resposta sobre "o app travou no checkout" pode ir tanto em Site/App quanto em Atendimento, um codificador vai escolher uma e outro vai escolher a outra, e a divisão entre esses dois códigos vai estar medindo o comportamento do codificador, não o do respondente.
  • Juntas cobrem o que as pessoas de fato disseram — não o que você esperava que dissessem. Um livro de códigos montado a partir da intuição de quem desenhou o questionário, antes de ler uma única resposta, quase sempre perde os dois ou três temas que acabam sendo os mais importantes. A correção é mecânica: ler entre cinquenta e cem respostas reais antes de fechar a lista.
  • Cada código tem uma taxa de uso real. Um código que pega duas respostas em duas mil não é uma categoria, é uma anotação — vale mais fundi-lo a um código mais amplo ou deixá-lo em "Outros" do que dar a ele uma linha em cada tabulação cruzada futura.
  • Existem definições e há exemplos que as sustentam. Não por zelo documental — pelo momento, oito semanas depois, em que alguém pergunta por que uma resposta específica está codificada daquele jeito, e a resposta precisa ser uma regra, não um "achei que sim".

Como se constrói um

Três pontos de partida, e num projeto real eles não são excludentes:

Na mão, a partir de uma amostra. Um pesquisador lê um lote de respostas — normalmente entre cem e algumas centenas — e monta as categorias de forma indutiva, do jeito que a codificação qualitativa sempre funcionou. Cuidadoso, lento, e continua sendo a decisão certa para um estudo sem precedente para se apoiar.

Gerado a partir dos dados reais. Em vez de partir de um modelo genérico, um modelo de IA lê uma amostra das respostas abertas reais daquela pergunta específica e propõe um livro de códigos a partir do que as pessoas efetivamente escreveram — categorias, definições e exemplos iniciais incluídos, pronto para um pesquisador editar antes de começar a codificar. É mais rápido que a versão manual e, como lê suas respostas e não um modelo genérico, costuma capturar algum tema específico do estudo que uma lista genérica deixaria passar. Também não substitui alguém revisando o resultado: um livro de códigos proposto por IA é um bom primeiro rascunho, não um produto terminado.

Importado de um documento existente. Agências e equipes internas costumam já ter um livro de códigos — um arquivo de uma onda anterior, ou um que o cliente entrega como parte do briefing. Importar significa que cada código e definição já existe; o trabalho é mapear colunas (Categoria, Código, Definição, Exemplos) em vez de escrevê-las do zero, e num estudo de tracking o mesmo arquivo é reaproveitado onda após onda para que o livro de códigos não se desvie em silêncio.

O que acontece quando uma resposta não se encaixa

Nenhum livro de códigos sobrevive intacto ao contato com a base completa. Em algum ponto depois da resposta duzentos, aparece algo que não se encaixa em nenhuma categoria da lista. Três coisas podem acontecer, e qual é a certa depende do projeto:

  • Vai para "Outros". Certo quando é realmente um caso isolado — vago, fora do tema, ou raro demais para justificar uma categoria nova.
  • O livro de códigos ganha um código novo. Certo quando o mesmo tema aparece mais que um punhado de vezes — o que estava incompleto era o livro de códigos, não estranha a resposta. Esse é o caso que vale a pena capturar, porque é fácil perder de vista: ninguém percebe que um tema está sub-coberto lendo uma única resposta, só percebendo que "Outros" está incomumente grande ou que uma revisão continua marcando o mesmo tipo de comentário.
  • Nada muda, de propósito. Num livro de códigos de tracking travado — o que cada onda precisa compartilhar para que as linhas de tendência signifiquem alguma coisa — adicionar um código no meio do estudo às vezes é a decisão errada mesmo quando o tema é real, porque quebra a comparabilidade com todas as ondas anteriores. O certo ali é anotar para o próximo redesenho, não para a onda atual.

O trabalho de uma plataforma de codificação nesse ponto é tornar as duas primeiras opções visíveis em vez de deixá-las passar em silêncio: marcar o que não se encaixa em nenhum código existente, deixar que um pesquisador decida caso a caso se é ruído ou uma lacuna real, e — essa é a parte fácil de fazer errado — aplicar essa decisão retroativamente a cada resposta anterior com o mesmo tema, não só à que disparou a revisão. E num estudo onde o livro de códigos realmente não pode se mover, um modo travado que bloqueia diretamente a criação de códigos novos, para que ninguém sob pressão de prazo amplie em silêncio as categorias de um tracking sem que ninguém tenha decidido isso.

Perguntas frequentes

Existe diferença real entre codeframe e livro de códigos?

Em sentido estrito, o codeframe é a lista de categorias; o livro de códigos (codebook) é essa lista mais as definições, exemplos e regras de caso-limite que a tornam aplicável por mais de uma pessoa. No uso do dia a dia entre pesquisadores, os dois termos são usados como sinônimos — ambos significam "o que eu uso para codificar as respostas".

Quantos códigos um livro de códigos deveria ter?

Não há um número fixo — depende de quão variadas as respostas realmente são, não de uma meta a cumprir. O que vale observar é o formato: um punhado de códigos cobrindo cada um 15%+ das respostas, uma cauda mais longa de códigos menores, e um balde "Outros" de um dígito. Se "Outros" passa de 15-20%, falta algo real ao livro de códigos.

Dá para reaproveitar o mesmo livro de códigos entre ondas?

Sim, e num estudo de tracking deveria — é isso que faz a comparação onda a onda significar alguma coisa. Na prática é manter um único arquivo compartilhado e reaproveitá-lo em cada onda em vez de reconstruí-lo, para que um código não seja renomeado ou dividido em silêncio entre a onda 1 e a onda 2.

O que acontece com uma resposta que não se encaixa em nenhum código existente?

Ela é marcada em vez de forçada na categoria mais parecida. A partir daí, ou é um caso isolado real (vai para "Outros"), ou é evidência de que falta uma categoria ao livro de códigos (um código novo é adicionado e a decisão aplicada retroativamente), ou — num livro de códigos de tracking travado — fica anotada para o próximo redesenho em vez de ser aplicada imediatamente.

Onde isso se encaixa

O livro de códigos é o insumo; codificar é o processo de aplicá-lo a cada resposta, e esse processo de ponta a ponta está coberto no nosso guia 4 agentes de IA + revisão especializada. E depois que as respostas estão codificadas, o que fica difícil de responder sem um bom livro de códigos por baixo é justamente o "porquê" atrás do score — como mostra o nosso guia por que sua análise de NPS não se converte em ação.

Se você quer ver um livro de códigos sendo gerado em vez de ler sobre um, nossa ferramenta gratuita de codificação recebe até 100 respostas, propõe um livro de códigos a partir do texto real, e devolve tudo em um Excel — sem precisar criar conta.