Campo e amostra
Amostra de painel
Você compra amostra de um fornecedor de painel, como Cint, Lucid, Dynata ou Notch. Este artigo mostra como provar que o ID de cada pessoa chega, como devolvê-lo no fim, e como ramificar o questionário pela fonte da amostra.
Atualizado em 14 de agosto 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 caminho curto
- Abra a tela de Publicação: no construtor, menu Mais → Coletores, link e QR.
- Crie um coletor do tipo Painel externo, ou use o que já existe.
- Em Redirecionamentos de saída, copie o link de entrada e entregue-o ao fornecedor. Cole as URLs de retorno dele.
- Em Conferir a entrada, teste o link.
- Abra o campo. Volte a Conferir a entrada para ver o que chegou de verdade.
O link de entrada
O link de entrada tem esta forma:
https://www.upinion.com.br/r/TOKEN?rid=[RID]&gid=[GID]&psid=[PSID]
O fornecedor troca os marcadores pelos IDs dele, antes de mandar a pessoa para cá.
Os quatro nomes que a plataforma conhece:
| 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: quem entra com
?upid=medico-7 volta na URL de saída pelo marcador [UPID].
O nome não diferencia maiúsculas de minúsculas. ?RID= e ?rid= são o
mesmo parâmetro.
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 | 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.
Ramificar pela fonte da amostra
A plataforma lê o ID do link como uma variável, e você a usa em Mostrar só se. Para isso, 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 |
| Ramificar por um parâmetro de nome livre pela tela | O atalho declara os quatro nomes de painel. Para outro nome, crie a variável com o mesmo nome do parâmetro |
| 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
ela 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.