Planilha
.xlsx, .xlsm ou .csv. Uma linha por unidade de análise. As colunas de resposta ficam depois da coluna do material.
Antes de distribuir a rodada
Como preparar os arquivos, e como codificar.
O CodLAB lê dois arquivos. A planilha diz quais unidades existem e quais variáveis serão preenchidas. O livro de códigos diz por que cada variável se marca. Esta página mostra como montar os dois para a plataforma aproveitar tudo que eles têm.
- 1
Junte dois arquivos
A planilha com as unidades e o livro de códigos que você já distribui.
- 2
Solte os dois em Codificar
A extensão separa um do outro. Se houver mais de uma aba, você escolhe qual abrir.
- 3
Confira o que casou
A tela diz quantas variáveis ganharam critério. O que não bateu, você liga na mão.
01
Os dois arquivos
Você solta os dois juntos no mesmo campo. A extensão separa um do outro, então a ordem não importa.
Livro de códigos
.pdf, .docx, .md ou .txt. O documento que você já distribui. Cada seção que começa pelo nome de uma coluna vira o critério daquela variável.
Só a planilha é obrigatória. Sem o livro de códigos, a ficha mostra o nome da coluna no lugar da pergunta, e o codificador decide sem o critério na tela. É o que você quer evitar.
02
A planilha
A coluna do material parte a aba em duas. O que vem antes dela é metadado de leitura: ID, data, canal, link. O que vem depois é variável a preencher.
Como nomear a coluna do material
Chame de texto, text, mensagem, conteudo, prompt, transcricao, corpo, post ou legenda. Sem um desses nomes, o CodLAB escolhe a coluna com o texto mais longo, o que costuma acertar mas não é garantia.
De onde sai o tipo de cada variável
Se a planilha já tem respostas, o tipo vem delas. Se está em branco, vira booleana, porque variável de livro de códigos existe para ser marcada.
| só TRUE/FALSE, 0/1, sim/não | botão Não · Sim |
| até 20 respostas curtas e repetidas | lista com essas opções |
| só números | campo numérico |
| coluna em branco | botão Não · Sim |
| nome tipo OBS, nota ou comentário | campo de texto livre |
Grupos na ficha
Prefixo repetido em duas ou mais colunas vira um bloco. Desinfo_Emocional e Desinfo_Urgencia aparecem juntas sob Desinfo. Coluna com prefixo único fica em Outras variáveis.
Data e hora
O Excel guarda data como 46110 e hora como 0,9631. Colunas chamadas dia, data, date ou timestamp viram 2026-03-29; hora, horario ou time viram 23:07.
Uma aba por codificador
Duplique a aba com o mesmo conteúdo, uma por pessoa: Sample_Ana, Sample_Bruno. As mesmas unidades, na mesma ordem, com as mesmas colunas. O CodLAB lista as abas e cada um abre a sua. Essa é a organização que torna o teste de confiabilidade possível.
03
O livro de códigos
Não precisa mudar de formato nem seguir modelo. O que a plataforma procura é uma coisa só: cada seção começando pelo nome exato da coluna.
As quatro regras
- 1
Comece a seção pelo nome da coluna
Desinfo_Emocional numa linha só. Acento e underline não atrapalham: Desinfo Emocional também casa.
- 2
Termine a próxima linha com ?
Ela vira a pergunta que o codificador lê. Sem ela, a pergunta é o nome da coluna.
- 3
Escreva o critério nas linhas seguintes
Aparece logo abaixo da pergunta, na ficha, enquanto a pessoa decide.
- 4
Declare as opções
Uma linha começando com "Opções:" e alternativas separadas por barra, ou uma lista de marcadores. Escreva "variável binária" no critério para forçar Não · Sim.
Como fica na prática
2. Tipo_URL Que tipo de fonte a URL aponta? Classifique pelo domínio, não pelo conteúdo. Encurtador vale como a plataforma de destino quando ela for evidente. Opções: Mídias Sociais | Veículo Jornalístico | Outros 3. Desinfo_Emocional Recorre a apelo emocional? Variável binária. Mobiliza medo, indignação ou comoção como via principal de persuasão, acima do argumento.
O que a plataforma faz com isso
Tipo_URL vira uma lista com as três alternativas do documento, mesmo que a planilha estivesse em branco. Desinfo_Emocional vira botão Não · Sim. As duas ganham a pergunta e o critério na tela. O documento manda: se ele declara opções, elas vencem o que foi deduzido da planilha.
O documento inteiro fica disponível
Um botão Livro de códigos abre o texto completo por cima da ficha, incluindo o que não casou com coluna nenhuma. É onde ficam a instrução geral da rodada, os exemplos-limite e o contato da coordenação.
Quando os nomes não batem
É o caso mais comum em pesquisa que já rodou algumas vezes: o livro de códigos diz Funcao_Panico e a planilha, depois de uma revisão, passou a dizer Efeito_Panico. São a mesma variável com dois nomes.
Quando só o prefixo muda e o resto do nome é igual, o CodLAB liga sozinho: Funcao_Panico encontra Efeito_Panico sem você fazer nada. Só liga quando há uma candidata única, para não trocar duas colunas parecidas uma pela outra.
Quando a mudança é maior que o prefixo, como Tema_1 virando Tema Principal, ele não adivinha. Mostra as colunas sem seção de um lado, as seções sem coluna do outro, e você liga as duas num menu.
Se uma coluna realmente não existe no livro de códigos, deixe em branco. A variável continua na ficha, só sem critério, e a tela registra isso no relatório.
04
Como codificar
A ferramenta mostra uma unidade por vez porque a comparação entre codificadores só vale se as duas pessoas passaram pelo mesmo material na mesma sequência.
- 1
Não pule unidade
Use Anterior e Próxima ou as setas do teclado. Enter marca revisado e avança. A ordem é a mesma para todo mundo.
- 2
Decida pelo critério da tela
Ele está ali para não depender de memória. Se o critério não resolve, o problema é do livro de códigos, não seu.
- 3
Na dúvida, escreva na OBS
Anotar a dúvida vale mais que chutar. A coordenação lê depois e ajusta o livro de códigos para a próxima rodada.
- 4
Não combine com o outro codificador
Concordância combinada durante a rodada não mede nada. A conversa vem depois do cálculo, sobre as divergências.
- 5
Devolva o bloco de colunas
Copiar valores gera exatamente as colunas de onde os dados saíram. Cole numa célula só, na sua aba. Ou baixe o backup .json e mande para quem coordena.
O rascunho é do navegador. Cada resposta salva sozinha, na máquina de quem codifica. Fechar a aba não perde nada, mas trocar de computador perde. Baixe o backup ao terminar.
05
Teste de confiabilidade
Duas ou mais pessoas codificam a mesma amostra e você mede o quanto elas concordam. O número só significa alguma coisa se todas viram as mesmas unidades, na mesma ordem, com as mesmas variáveis. É por isso que a planilha tem uma aba por codificador.
Alpha de Krippendorff
α = 1 − Do/De, a discordância observada dividida pela que apareceria por acaso. Estima o acaso a partir da distribuição das respostas. Aceita qualquer número de codificadores, célula vazia, e variável nominal, ordinal ou de intervalo. Krippendorff sugere α ≥ 0,800 para concluir e 0,667 como piso para conclusão provisória.
Coeficiente de Brennan-Prediger
κ = (po − 1/q) / (1 − 1/q), onde po é a concordância observada e q o número de categorias. Corrige o acaso assumindo que ele se reparte igualmente entre as categorias, em vez de estimá-lo pelas marginais. Em variável binária, q = 2 e a conta vira κ = 2·po − 1.
Por que reportar os dois
Numa variável em que quase toda resposta é não, o acaso estimado pelas marginais fica altíssimo e o alpha despenca mesmo com os codificadores concordando em quase tudo. É o paradoxo do kappa. O Brennan-Prediger não sofre disso, porque o acaso dele não depende de quão desbalanceada a variável é. Livro de códigos de desinformação tem exatamente esse perfil: quase tudo FALSE e um punhado de TRUE. Reporte os dois e explique a diferença quando ela aparecer.
Do CodLAB para o cálculo
Cada codificador abre a própria aba, preenche e usa Copiar valores. O bloco cola na mesma coluna de onde saiu. Com as abas preenchidas, o cálculo é uma coluna contra a outra, variável por variável.
# R, uma variável por vez
irr::kripp.alpha(rbind(ana$Desinfo_Emocional,
bruno$Desinfo_Emocional), method = "nominal")
irrCAC::bp.coeff.raw(cbind(ana$Desinfo_Emocional,
bruno$Desinfo_Emocional))Um aviso sobre as faixas. 0,800 e 0,667 são convenções de Krippendorff, não leis. O Brennan-Prediger não tem faixa canônica; costuma-se ler pelas mesmas bandas do kappa. Diga no relatório qual convenção você adotou.
06
Exemplos para baixar
Os quatro arquivos abaixo funcionam juntos. Baixe a planilha e um dos livros de códigos e solte os dois em Codificar para ver o resultado.
Planilha, uma aba por codificador
4 abas, 10 unidades cada, 8 variáveis depois da coluna texto. É o formato deduzido, sem aba de variáveis.
Livro de códigos de exemplo
As oito variáveis da planilha acima, uma por uma, com pergunta, critério e opções. Casa cem por cento com ela.
Modelo declarado
Abas items e variables. É o único formato que carrega obrigatoriedade e variável descontinuada.