Campo e amostra

Amostra de painel

Você compra amostra de um fornecedor de painel, como Cint, Lucid, Dynata ou Notch. Este artigo leva você do primeiro clique à URL de volta, com um exemplo inventado, e depois mostra como provar que o ID de cada pessoa chega e como ramificar o questionário pela fonte da amostra.

Atualizado em 4 de novembro de 2026

Para que serve o ID

O fornecedor manda pessoas para o seu questionário. Cada pessoa chega por um link, e esse link traz o ID dela na base do fornecedor.

Uso	Exemplo
Devolver a pessoa ao fornecedor no fim	O fornecedor paga o incentivo a quem completou
Ramificar o questionário pela fonte	Duas fontes alimentam o mesmo estudo, e uma delas já respondeu a triagem
Sair como coluna nos resultados	Você compara a qualidade de cada fonte

O exemplo que vamos seguir

Este exemplo é inventado. Os nomes e os endereços não existem.

Você fez o questionário Hábitos de café. Você comprou 400 respostas do Painel Aurora. A Aurora entrega estas informações:

O que a Aurora entregou	Valor
Nome do parâmetro com o ID da pessoa, na entrada	`idpessoa`
URL para quem completou	`https://aurora.example.com/retorno/ok?estudo=cafe21`
URL para quem foi filtrado	`https://aurora.example.com/retorno/filtrado?estudo=cafe21`
URL para quem chegou com a cota cheia	`https://aurora.example.com/retorno/cota?estudo=cafe21`
Nome do parâmetro com o ID, na volta	`pid`

O nome de entrada (idpessoa) e o nome de volta (pid) são diferentes. Isso é comum. O campo Volta como existe para esse caso.

Passo a passo

O questionário precisa estar publicado.

No construtor, abra o menu Mais → Coletores, link e QR. A tela de Publicação abre.
Clique em Novo coletor. Em Nome, escreva Painel Aurora, escolha Painel externo e clique em Criar coletor. O coletor novo abre na direita, já na aba Redirecionamentos de saída.
Para cada desfecho, escolha Endereço externo na lista e cole a URL da Aurora:
- Completou: https://aurora.example.com/retorno/ok?estudo=cafe21
- Filtrado na triagem: https://aurora.example.com/retorno/filtrado?estudo=cafe21
- Cota cheia: https://aurora.example.com/retorno/cota?estudo=cafe21
Você não escreve nenhum marcador nas URLs.
Mais abaixo, a seção Amostra de painel (Cint, Lucid, Dynata) abre sozinha. Em Variáveis do link, a lista vem com quatro linhas: rid, pid, gid e psid. A Aurora manda só um ID. Faça isto:
- Na primeira linha, em Nome no link, troque rid por idpessoa.
- Na mesma linha, em Volta como, escreva pid.
- Clique no X das outras três linhas.
Deixe marcada a opção Enviar as variáveis de volta ao fornecedor.
Em Link para o fornecedor, o campo mostra o link com o marcador da Aurora:
```
https://www.upinion.com.br/r/AbC123?idpessoa=[idpessoa_value]
```
Clique em Salvar. O Salvar grava tudo de uma vez: os destinos, a lista de variáveis e a opção de enviar de volta. Depois clique em Copiar e mande o link para a Aurora. Ela troca [idpessoa_value] pelo ID de cada pessoa. É o mesmo formato do SurveyMonkey.
Para ver como fica, clique em Ver prévia das URLs. A tela mostra a URL de cada desfecho, com valores de exemplo.
Teste antes de abrir o campo. Clique em Conferir a entrada e abra a aba Testar o link:
- Troque o valor do link de teste por um ID inventado, como ?idpessoa=TESTE-1.
- Clique em Conferir o que chega.
- A tela diz Nada a corrigir. Abra Ver o que o motor capturou. A URL de Completou deve ser https://aurora.example.com/retorno/ok?estudo=cafe21&pid=TESTE-1.
- Nenhuma resposta é criada. O teste não entra na contagem do estudo.
Abra o campo. Volte a Conferir a entrada, na aba Recebidas, para ver o que chegou de verdade.

O que acontece com cada pessoa

A Aurora manda a pessoa AUR-48213 para:

https://www.upinion.com.br/r/AbC123?idpessoa=AUR-48213

A pessoa responde. Ao terminar, ela vai para um destes endereços:

Desfecho	Para onde a pessoa vai
Completou	`https://aurora.example.com/retorno/ok?estudo=cafe21&pid=AUR-48213`
Foi filtrada na triagem	`https://aurora.example.com/retorno/filtrado?estudo=cafe21&pid=AUR-48213`
A cota do perfil dela estava cheia	`https://aurora.example.com/retorno/cota?estudo=cafe21&pid=AUR-48213`

Na base de resultados, a coluna var_idpessoa traz AUR-48213 na linha dessa pessoa.

Como cada parte funciona

Variáveis do link

A seção Variáveis do link é uma lista de nomes. Cada nome é um parâmetro que o fornecedor manda no link. É o mesmo desenho das variáveis personalizadas do SurveyMonkey.

A lista faz três coisas:

O que a lista faz	Como
Monta o link de entrada	Um parâmetro por nome, na ordem da lista
Cria uma coluna nos resultados	Uma coluna `var_NOME` por nome, a partir da próxima publicação
Deixa o valor disponível em Mostrar só se	O nome vira uma variável do questionário

Cada nome tem um segundo campo, Volta como. É o nome do parâmetro na URL de retorno. Em branco, a variável volta com o mesmo nome. Preencha quando o fornecedor espera outro nome na volta, como no exemplo: entra como idpessoa e volta como pid. É a Legenda das variáveis personalizadas do SurveyMonkey. A caixa conta na volta: se o fornecedor exige RID em maiúsculas, escreva RID em Volta como, mesmo que o nome no link seja rid.

Regras para o nome (vale também para Volta como): letras sem acento, números e _, começando por letra. O limite é 50 caracteres por nome e 100 nomes por link. Os nomes c e score, e os que começam com _, são da plataforma. A plataforma recusa esses nomes. Duas variáveis não podem voltar com o mesmo nome.

Tirar um nome da lista tira também a variável do questionário, e a coluna dela some da base. Isso só acontece se nenhuma condição, fórmula ou texto usa a variável. Se algo a usa, ela fica. Uma variável que você declarou com valor padrão também fica.

Os quatro nomes de painel

A lista de um coletor de painel começa com quatro nomes. Se o seu fornecedor manda só um, tire os outros, como no passo 4 do exemplo.

Nome	O que é
`rid`	O ID da visita, ou da transação
`pid`	O ID da pessoa no painel
`gid`	O ID do grupo, ou do estudo, no fornecedor
`psid`	O ID do fornecedor de origem

Cada fornecedor usa um nome próprio para o mesmo dado. A plataforma reconhece os apelidos mais comuns, e os transforma nos quatro nomes acima.

Nome que chega	Vira
`transaction_id`, `tx`, `txid`, `cint_rid`, `session_id_panel`	`rid`
`panelist_id`, `panelistid`, `uid`	`pid`
`group_id`, `groupid`	`gid`
`supplier_id`, `sid`	`psid`

Um parâmetro com outro nome também chega. Ele fica guardado com o nome que veio. Ele só vira coluna nos resultados se o nome estiver na lista.

O nome não diferencia maiúsculas de minúsculas. ?RID= e ?rid= são o mesmo parâmetro.

A volta ao fornecedor

Na URL de saída, a plataforma anexa as variáveis da lista. Ela faz isso sozinha, no fim da URL, e usa o nome de Volta como.

As regras:

Só volta o que a pessoa trouxe no link. A plataforma não manda parâmetro vazio.
Só volta o que está na lista. Um parâmetro fora da lista fica de fora.
O valor é o que veio no nome da entrada, e sai com o nome de Volta como.
A URL que já tem o nome vale mais. A plataforma não repete pid se a URL traz pid=[PID]. Uma exceção: o parâmetro em branco recebe o valor. Se a Aurora entregasse https://aurora.example.com/retorno/cota?estudo=cafe21&pid=, a URL sairia com pid= preenchido.
A assinatura HMAC cobre a URL final, já com as variáveis anexadas.
Reprovado por qualidade sem destino próprio usa o destino de Filtrado na triagem. O fornecedor quase nunca dá uma URL para esse desfecho. Sem essa regra, ele não ficaria sabendo da pessoa.

O marcador [fedResponseID] é o ID da resposta no Upinion. Se o link trouxe um parâmetro fedResponseID, o marcador é o valor desse parâmetro. O mesmo vale para [responseid]. Assim ...&RID=[fedResponseID] devolve o ID do fornecedor, como no SurveyMonkey.

Quem abre o link de novo

A pessoa que já terminou não responde de novo. A pessoa volta ao fornecedor pela mesma URL do desfecho dela. A plataforma reconhece a pessoa de duas formas:

Pelo rid, ou pela variável que volta como RID. Exemplo: fedResponseID com Volta como RID.
Num coletor de painel, pelo conjunto das variáveis da lista: quem chega com todos os valores iguais aos de uma resposta terminada é a mesma pessoa. Isso vale para o fornecedor que não usa o nome RID. Exemplo: ele manda respid e espera respondent_id de volta.

gid e psid não reconhecem a pessoa e não entram no conjunto. Eles são do grupo e do fornecedor, e muitas pessoas chegam com o mesmo valor.

Quando o link traz o ID, a plataforma não olha a conexão. Muitas pessoas na mesma rede, como uma operadora de celular ou uma empresa, chegam com a mesma conexão, e cada uma responde a sua. Quando o link chega sem ID, a plataforma barra quem chega da conexão de alguém que já terminou. Essa pessoa vê a mensagem de pesquisa já respondida e não volta ao fornecedor, porque a plataforma não sabe quem ela é.

A pessoa que recarrega a página no meio continua na mesma página. As respostas que ela já enviou ficam guardadas. Uma aba nova, aberta pelo link, começa uma resposta nova. Uma aba duplicada (o comando "Duplicar" do navegador) continua a mesma resposta.

Na prévia, recarregar recomeça do início. A prévia muda a cada edição do rascunho.

A opção Enviar as variáveis de volta ao fornecedor liga e desliga o recurso. Ela nasce ligada num coletor de painel novo. Num coletor que já existia, ela nasce desligada: a URL de saída continua como estava.

Use os marcadores só para pôr um valor numa posição certa, ou sob outro nome. Exemplo: ...&codigo=[IDPESSOA].

Vários fornecedores no mesmo estudo

Crie um coletor para cada fornecedor, no mesmo questionário. Cada coletor tem as suas URLs de retorno e a sua lista de variáveis. Você não precisa duplicar o questionário.

Na base de resultados, a coluna collector diz por qual coletor cada pessoa entrou. Use essa coluna para conferir os completes com cada fornecedor no fim do campo.

Se você duplicar o questionário, a cópia leva os coletores com a configuração de cada um: URLs de retorno, variáveis do link, Volta como e regras de entrada. Os links da cópia são novos. O link do original continua levando ao original, e nenhuma resposta é copiada.

Conferir o link antes do campo

Abra o coletor e clique em Conferir a entrada.

O campo já vem com o link deste coletor.
Troque os marcadores por valores de teste.
Clique em Conferir o que chega.

A tela responde três coisas:

O que a plataforma capturou. Uma linha por parâmetro do link.
A URL de saída de cada desfecho, com os valores que você acabou de colar.
Os avisos. O que vai dar errado no campo.

Nenhuma resposta é criada. O teste não entra na contagem do estudo.

A coluna "o que a plataforma faz"

O que a tela diz	O que significa
ID de painel: a plataforma conhece este nome	O parâmetro é um dos quatro nomes
apelido: virou `rid`	O parâmetro alimentou um dos quatro nomes
apelido de `rid`, mas o `rid` já veio direto	O link trouxe os dois. Vale o nome direto
marcação de origem	O parâmetro alimenta o relatório de origem
guardado como veio	O parâmetro fica com o nome que chegou
nome interno	O nome começa com `_`. Ele é da plataforma, e não do link. O motor descarta este parâmetro na entrada

Os avisos, e o que fazer com cada um

Aviso	O que fazer
Nenhum ID de painel chegou neste link	Peça ao fornecedor o parâmetro `rid`. Ou use na URL de saída o marcador do nome que ele manda
Este coletor exige um código no link	Cole o link com o código. Sem o código, a plataforma não cria resposta
Este coletor está pausado	Ative o coletor. Um coletor pausado recusa toda entrada
O link colado é de prévia ou de pré-teste	Use o link de entrada deste coletor. A sessão de prévia fica fora dos relatórios, e não sincroniza com o painel
O link colado não é o deste coletor	Confira qual coletor você entregou ao fornecedor
Nenhuma URL de saída configurada	Cole as URLs de retorno do fornecedor. Sem elas, a pessoa fica na tela de agradecimento
A URL de saída não usa nenhum marcador	Ligue Enviar as variáveis de volta ao fornecedor. Ou ponha `[RID]` na URL. Sem o ID, o fornecedor não sabe de quem é a volta
A plataforma descarta um parâmetro na entrada	Tire do link o parâmetro que começa com `_`. Esse nome é da plataforma. Se o dado é seu, dê a ele outro nome, sem o `_` no começo

Ver o que chegou de verdade

Com o campo no ar, a mesma aba mostra as respostas reais deste coletor, em três recortes.

Por parâmetro

Em quantas respostas cada parâmetro chegou, com um exemplo do valor. Um parâmetro que aparece em 3 de 40 respostas é um parâmetro que o fornecedor manda às vezes.

Por fonte da amostra

O agrupamento usa o psid. Sem psid, ele usa o gid. Cada linha traz os desfechos e a taxa de conclusão. É aqui que você compara duas fontes.

Últimas respostas

Uma linha por resposta, com o que veio no link e a URL que o fornecedor recebeu de volta.

A resposta em andamento não tem URL de saída: a URL nasce no desfecho.

A URL de saída fica gravada na resposta no momento em que a pessoa volta ao fornecedor. Se você muda o coletor depois, a coluna continua mostrando a URL que foi enviada. Uma resposta de antes de 21/10/2026 não tem a URL gravada: a coluna a refaz com a configuração de agora e avisa isso embaixo da URL.

Ramificar pela fonte da amostra

A plataforma lê o ID do link como uma variável, e você a usa em Mostrar só se. Os nomes da lista Variáveis do link já são variáveis do questionário: vá direto ao passo 4. Para outro nome, declare a variável primeiro.

Abra Variáveis, na barra de ferramentas do construtor.
Em Vem no link do fornecedor de amostra, clique no nome que você quer, como + psid.
Feche o painel.
Abra a pergunta e a área Lógica. Em Mostrar só se, escolha a variável no grupo Variável.

A declaração é obrigatória. Sem ela, a publicação recusa a condição: uma condição para uma variável que não existe é sempre falsa, e não avisa ninguém.

Não dê valor padrão a esses nomes. O parâmetro da URL vence o valor padrão sempre, e o servidor recusa a combinação.

O painel de variáveis tem artigo próprio: Variáveis.

A armadilhaO valor vem de fora. Quem monta o link manda no valor, e a pessoa que responde pode editá-lo na barra de endereço. Use o ID do fornecedor para triagem e para relatório. Não use o ID do fornecedor para cota nem para incentivo.

O que este recurso ainda não faz

Falta	Situação
Ver as variáveis de entrada de todos os coletores juntos	A aba mostra um coletor por vez
Um rótulo para cada variável	A lista leva só o nome
Aviso do desfecho de servidor para servidor (S2S)	Não existe. A volta é pelo navegador, com assinatura HMAC se o fornecedor exigir
Proteger a variável contra a URL	Um parâmetro de URL sobrescreve a variável declarada
Exportar a lista de entradas	A tela mostra as últimas 20 respostas

Perguntas frequentes

O fornecedor diz que não recebeu a volta de ninguém.
Confira duas coisas em Conferir a entrada: se há URL de saída configurada, e se a devolução das variáveis está ligada ou a URL usa um marcador como [RID].

O ID chega em algumas respostas e falta em outras.
Olhe o recorte por parâmetro. Ele mostra em quantas respostas cada parâmetro veio. Leve esse número ao fornecedor.

Dá para usar o filtro de perfil com amostra de painel?
Sim, e escolha só descobre no fim. O motivo está em Filtro de perfil.

O teste da aba criou respostas no meu estudo?
Não. A conferência não cria resposta, e não conta na amostra.