See how it works: Connect external recruitment

Recruit with an external panel

Token in the URL and redirects at the end.

2 minutes read

On this page

Identify each arrival and return its outcome to the panel.

Purpose

Preserve the panel identifier throughout collection.

When to use it

When participants come from OpinaTAP or another panel.

Before you start

  • Return URLs supplied by the panel
  • A published study

Example

Receive a test token and return it in the completion URL.

Step by step

  1. Enable the panel. In the study, open Share and expand Recruitment panel. Enable it and check the token parameter name: use token, uid or the name required by the provider. If purchased recruitment protects the fields, keep the integration configuration. Token identification.
  1. Fill in returns. Under Panel return links, paste the supplied completion, disqualification and quota-full URLs. Use {{token}} for the identifier and check the preview with EXEMPLO123. Click Save panel and wait for confirmation. Completed · Disqualified · Quota full.
  1. Prepare variables. Under Variables sent by the panel, enter an agreed key such as idade, click Add variable and save. Copy the public link from Share and agree a test URL with the provider, for example appending ?token=TESTE001&idade=30 if those are the configured parameters. Unique token · Necessary variables.
  1. Validate outcomes. Use distinct test identifiers and validate a completion, a disqualification and a quota-full case with the provider. Check the identifier in each return URL. In Results, open More filters to check the received variable; the published link creates real participations. Return with the correct identifier.

How to read the result

  • Identifier and variables attached to the session
  • Correct return route for each outcome

Cautions and limitations

  • A link without a token cannot identify the panel reward.
  • Configuring a return URL neither purchases participants nor proves incentive payment.

Continue with the interactive guide

Connect external recruitment

Was this helpful?

Is something missing? Write to contato@paineltap.com.br.