Lógica

Variáveis

Uma variável é um valor que o questionário guarda. Quem responde não vê esse valor.

Atualizado em 14 de agosto de 2026

Para que serve

1. Reaproveitar uma resposta já dada, sem repetir a pergunta.
2. Decidir o caminho do questionário.
3. Aparecer no texto de uma pergunta, com {{var.nome}}.
4. Virar uma coluna nos resultados.

Existem três tipos.

O sorteio tem artigo próprio: Sorteio de item. Use-o quando cada pessoa avalia uma marca sorteada entre as que ela marcou.

O caminho curto

1. Crie a variável no painel Variáveis, na barra de ferramentas do alto.
2. Preencha a variável no menu Lógica de página, com Guardar resposta numa variável.
3. Use a variável no texto, com {{var.nome}}.
4. Use a variável na condição, no campo Mostrar só se.
5. Confira no botão Validar, e depois em Prévia.

Passo a passo: um estudo de marcas

O exemplo é um estudo de café. A pessoa escolhe a marca preferida na primeira página. As páginas seguintes falam da marca que ela escolheu.

1. Monte as perguntas

1. Abra o construtor e escreva o nome do questionário no campo do topo.
2. Abra Adicionar pergunta, no alto, e clique em Escolha única.
3. Escreva o enunciado: "Qual marca de café você mais consome?".
4. Escreva as alternativas: Melitta, Pilão, 3 Corações, Nescafé, Outra.
5. Em Adicionar pergunta, clique em Número.
6. Escreva o enunciado: "Qual a sua idade?".
7. Clique em + Nova página, na seção Estrutura.
8. Adicione uma pergunta de Escolha única nesta página nova, e deixe o enunciado em branco por enquanto.

As duas primeiras perguntas ficam na mesma página, e a pessoa envia as duas de uma vez.

2. Crie as variáveis

1. Clique em Variáveis, na barra de ferramentas do alto.
2. Deixe o campo Criar em variável.
3. Escreva marca_pref no campo Nome.
4. Deixe o campo Tipo em texto.
5. Deixe o campo Valor padrão (opcional) em branco.
6. Marque Exportar nos resultados.
7. Clique em Adicionar.

A variável aparece na lista, acima do formulário. Crie agora a segunda, que guarda a idade e por isso é numérica: escreva idade_resp no Nome, escolha número no Tipo e clique em Adicionar.

Se o nome não servir

O painel mostra o erro embaixo da variável, com o motivo. Ele confere quatro coisas.

A conferência acontece no servidor. É o mesmo gate que barra a publicação: o que passa aqui passa lá.

3. Guarde a resposta na variável

Este é o passo que preenche a variável. Sem ele, a variável fica vazia.

1. Vá até a primeira página, na área central.
2. Clique em Lógica de página, no topo da página.
3. Clique em Guardar resposta numa variável.
4. Escolha "Qual marca de café você mais consome?" no campo Guardar a resposta de:.
5. Escolha marca_pref no campo Na variável:.
6. Clique em Guardar.
7. Repita para a idade, com a variável idade_resp.
8. Clique em Fechar.

O menu passa a mostrar a contagem: Guardar resposta numa variável (2).

O menu Lógica, na barra de ferramentas, também mostra o que cada página guarda. Clique na linha para ir até a página. Leia Pulos e condições.

4. Use a variável no texto

1. Volte à segunda página.
2. Clique no enunciado da pergunta que você deixou em branco.
3. Escreva: "De 0 a 10, que nota você dá para ".
4. Escreva {{. A lista de marcadores abre.
5. Escreva parte do nome para filtrar.
6. Escolha o marcador com as setas e aperte Enter.
7. Escreva ? no fim da frase e adicione as alternativas de 0 a 10.

A plataforma troca o marcador pelo valor guardado. Um marcador sem valor vira texto vazio.

A lista de marcadores

A lista abre com {{ em três campos: o enunciado, o bloco de texto e a legenda de uma imagem. São os campos que a plataforma resolve.

Cada linha mostra o marcador, o nome da pergunta ou da variável, e o resultado que ele rende. O resultado é o que separa um marcador do outro sem consultar documentação.

A lista mostra só as perguntas anteriores: um marcador mostra uma resposta já dada, e a pergunta da própria página ainda não foi enviada.

Uma variável sem valor aparece como "vazia — nada a preenche ainda". Isso quer dizer que falta o passo 3.

Escolha o marcador certo: rótulo ou código

Numa pergunta de escolha, cada alternativa tem duas partes. O código é o que a lógica compara e o que vai para a planilha. O rótulo é o texto que a pessoa lê.

A variável guarda o código, e isso é proposital: é o mesmo valor que a condição compara. Traduzir o valor quebraria a ramificação, e o rótulo muda de idioma.

5. Use a variável para decidir o caminho

1. Continue na segunda página.
2. Abra Lógica, no cartão da pergunta. O campo Mostrar só se fica ali.
3. Abra a lista de fontes. Ela tem três grupos: Pergunta, Variável e Calculada.
4. Escolha marca_pref, no grupo Variável.
5. Escolha tem resposta na lista de comparações.

A pergunta passa a aparecer só para quem escolheu uma marca.

O campo Mostrar só se aparece a partir da segunda pergunta do questionário: a condição só olha para trás. As variáveis e as calculadas fogem dessa regra, porque o valor pode vir da URL ou de um valor padrão.

Uma condição por número

1. Crie uma terceira página e adicione uma pergunta.
2. Abra a lista de fontes, no campo Mostrar só se.
3. Escolha idade_resp, no grupo Variável.
4. Escolha está entre.
5. Escreva 30 no primeiro campo, e 99 no segundo.

As comparações mudam conforme o tipo da fonte.

Toda fonte também aceita tem resposta e não tem resposta.

Clique em + Condição para somar outra regra. Escolha E para exigir todas, ou OU para bastar uma. O conector vale para a regra inteira.

6. Crie uma variável calculada

A calculada guarda o resultado de uma fórmula, e roda a cada página enviada.

1. Abra o painel Variáveis.
2. Escolha variável calculada no campo Criar.
3. Escreva faixa no campo Nome.
4. Escreva a fórmula no campo Fórmula.
5. Marque Exportar nos resultados e clique em Adicionar.

iif({var.idade_resp} >= 45, 'madura', iif({var.idade_resp} >= 30, 'media', 'jovem'))

Use {Q1} para a resposta de uma pergunta. Use {var.nome} para uma variável.

As funções disponíveis

Se a fórmula estiver errada

O painel mostra uma mensagem vermelha embaixo da calculada, e a mensagem diz o que consertar.

A mesma mensagem aparece em três lugares: no painel, no relatório do botão Validar, e quando você publica. Uma fórmula errada impede a publicação.

A conferência é de sintaxe. Ela não diz se a pergunta citada existe: uma referência a uma pergunta que não existe devolve vazio na coleta, sem erro.

7. Confira o resultado

1. Clique em Validar, no topo da tela, e corrija o que aparecer.
2. Clique em Prévia e responda como um respondente.
3. Confira que o texto mostra o valor no lugar do marcador.
4. Confira que a pergunta condicionada aparece para quem devia ver.
5. Confira que ela não aparece para quem não devia.

Responda a prévia mais de uma vez, com respostas diferentes. Uma condição só se prova quando você vê os dois lados dela.

8. Publique e colete

O link aceita parâmetros. Um parâmetro com o nome de uma variável declarada preenche essa variável:

https://.../r/SEU_TOKEN?canal=email

Neste exemplo, uma variável chamada canal nasce com o valor email.

9. Veja as variáveis nos resultados

Toda variável marcada com Exportar nos resultados vira coluna. A variável marca_pref sai como var_marca_pref, e a calculada faixa sai como calc_faixa. As colunas saem nas exportações.

Referência

Nomes que você não pode usar

Estes nomes bloqueiam:

O link de entrada também não escreve nos nomes que começam com _. A plataforma descarta esse parâmetro na entrada. O valor não chega na entrevista e não sai no arquivo de dados.

Estes nomes avisam, e você pode usá-los: rid, pid, gid, psid e os apelidos deles; utm_source, src, source, ref e os outros parâmetros de origem; status, response_id, duration_s, collector, survey_id; locale, lang, weight, pretest, preview.

Esses nomes chegam pela URL do convite. Declarar um deles é correto quando você quer exportá-lo, ou quando você quer ramificar por ele — o caminho inteiro está em Amostra de painel.

De onde vem o valor de uma variável

A URL vence o valor padrão. Um parâmetro na URL sobrescreve o que você declarou.

Quando remover uma variável

O painel remove a variável e limpa quem a usava: as condições que apontavam para ela somem, e as atribuições também.

Isso é proposital. Uma condição apontando para uma variável que não existe é sempre falsa, e não avisa ninguém.

O que este recurso ainda não faz

Perguntas frequentes

O marcador aparece vazio na prévia.
A variável não tem valor. Confira o passo 3: a página precisa guardar a resposta na variável.

Eu quero mostrar o nome da marca, e aparece um código.
Você usou {{var.nome}}. Troque pelo marcador da pergunta, {{Q3}}.

A condição por variável não funciona.
Confira se a variável está declarada no painel, e se ela recebe valor em algum lugar: uma página, um valor padrão ou o link.

Dá para usar variável na primeira pergunta?
Sim. Variável e calculada valem em qualquer ponto, porque o valor pode vir da URL ou de um valor padrão.