gsa / recruiter Goto Github PK

View Code? Open in Web Editor NEW

12.0 7.0 11.0 4.51 MB

Embeddable forms to recruit research participants. Sends results to a Google Sheet, deployed via Google Tag Manager.

Home Page: https://gsa.github.io/recruiter/

License: Other

JavaScript 100.00%

recruiters usability feedback-systems google-sheets google-tag-manager embeddable-forms user-feedback

recruiter's Introduction

recruiter [WIP]

Embeddable forms for recruiting usability research participants. Uses Google Tag Manager to load form UI and targeting, and a custom Google Apps Script to send submissions to a Google Sheet.

Components

Google Sheets Template
Google Tag Manager - account required
U.S. Web Design System styles and form patterns guidance for accessibility.

Optional

Integration with Google Analytics to send custom events when a user opens, closes, and submits the Recruiter form dialog.

Deploying

See Wiki

Default fields provided in this configuration:

Field name	Type	Description
Date	Timestamp	submission time and date
Name	String	First name
Email	String	Email address
UserAgent	String	OS + Version, Browser + version
URL*	String	URI of page where form was submitted
Referrer*	String	Referring page (how user arrived at PageURL

*Note: When deploying to sites where URLs contain references to content that may infer information of a personal or sensitive nature (e.g. visiting content related to medical conditions on NIH.gov), you may wish to omit passing the last two fields (URL and Referrer) to the Sheet. This can be done simply by removing the last two query parameters (&Referrer={{Referrer}}&URL={{Page URL}}) from the URL in the Recruiter to Google Sheet Custom Image Tag in GTM.

Warning: PIA, PRA or other privacy or security compliance issues may be triggered for any customized capture fields. Consult your agency's Chief Privacy Officer and/or PRA Desk Officer before deploying any customized form versions.

Compliance

Paperwork Reduction Act of 1995 (PRA)

See exemption conditions.

Privacy

GSA's Privacy Act Statement on Design Research
Collection of data from users such as that requested by tools like Recruiter is authorized by the E-Government Act of 2002 (P.L. 107-347, 44 USC § 3501).
See GSA's Design Research Privacy Impact Assessment (PIA) for additional details about the way Recruiter collects and stores administrative data.
Google Sheets are an approved System of Record for storing personally-identifiable information (PII) under GSA/CIO-3.

Roadmap

Recruiter is the first part of a larger WIP feedback platform implemented via Google Tag Manager.

recruiter's People

Contributors

Stargazers

Watchers

Forkers

esgoodman patphongs thomhalla jackdragonslayer chaithanyaharidas

recruiter's Issues

Add recruiter to methods.18f.gov

Help improve this website!

Thanks for your interest in helping us improve the 18F Method Cards. Please share your contact information below. If you're selected, a member of our team will contact you to set up a 30-45 minute conversation.

[Name]
[Email]```

Escape should close the recruiter modal

Escape and/or clicking anywhere else but the modal window should close the modal.

Add example on gh-pages branch/dir

Fix learn more link on science 360 recruiter - it's currently 404ing

The URL for the Learn more link in the recruiter popup should go to https://www.nsf.gov/web-design-labs/. Currently it is going to https://science360.gov/web-design-labs/ which is a 404

Styles loaded from stylesheet instead of inline

Move out of recruiter.js into .css file
Call styles from recruiter tag:
<link rel='stylesheet' href='link'/>

Can the website recruiter tool run on multiple domains?

Tab nav and cmd+enter should work

Show confirmation dialogue in the existing modal

I got a JavaScript alert when I submitted the form, which was jarring compared to how smooth the rest of the experience was. And as a user I generally expect that submitting a form will show me the feedback to that submission in the same visual space and context as the form.

I think it would be better, for UX and aesthetics, if the form caused the HTML modal to get updated with the confirmation rather than a JS alert.

Add Help Wanted to Code.gov

It looks like you have quite a few Help Wanted issues in your repo. You can feature these on Code.gov and reach a larger audience by adding specific tags to your Help Wanted issues.

Here are the specifics - https://github.com/GSA/code-gov/blob/master/HelpWanted.md
And, an example - https://github.com/GSA/code-gov-web/issues/417

Let me know if you have questions,
Cheers!
Joe