1: Logic Syntax
To include reCaptcha verification in a survey, you will need to add a
<logic> tag to your survey, specifying both a
<logic uses="recaptcha.1" label="recaptcha"/>
Additionally, you will need to include the following HTML code from reCaptcha:
<html cond="recaptcha.human" label="h1"> You are human </html> <html cond="not recaptcha.human" label="h2" final="1"> You are not human! </html>
As soon as the survey encounters the
recaptcha.1 logic node, it will stop executing and present the respondent with a Google reCaptcha test:
The text "I'm not a robot" displays in the respondent's browser-selected language, along with the reCaptcha logo. After clicking the check-box, the respondent may be presented with a number of images, where certain selection responses are required - in the example below, the user is asked to select images featuring fish:
This check is not always performed; Google attaches persistent data to each browser that tracks whether the respondent has seen a reCaptcha test on any other page.
2: How it Works
After the user submits the page, FocusVision servers contact Google to independently verify the user's claim. You can call
recaptcha.human in your survey to check whether the user was confirmed.
Note: If you are running SST, there is a 90% chance that
recaptcha.human is True. Google's servers are not contacted when running SST.
reCaptcha is only usable on
focusvision.com domains. If you would like to add reCaptcha to a survey on another domain, please contact your Account Manager or support team for assistance.
Alternatively, you can sign up for your own reCaptcha account to use on any domain. Once you sign up for reCaptcha, Google will issue you both a "site key" and a "secret" code. To start using your reCaptcha tests, simpl add the following logic tag to your survey, specifying these two values as provided within your Google site:
<logic uses="recaptcha.1" recaptcha:sitekey="12342" recaptcha:secret='12341234' label="recaptcha"/>