{"id":21016693,"url":"https://github.com/gsa/recruiter","last_synced_at":"2025-08-03T03:34:38.654Z","repository":{"id":137795247,"uuid":"88900395","full_name":"GSA/recruiter","owner":"GSA","description":"Embeddable forms to recruit research participants. Sends results to a Google Sheet, deployed via Google Tag Manager.","archived":false,"fork":false,"pushed_at":"2018-06-25T15:37:20.000Z","size":4620,"stargazers_count":12,"open_issues_count":17,"forks_count":8,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-06-15T08:07:19.666Z","etag":null,"topics":["embeddable-forms","feedback-systems","google-sheets","google-tag-manager","recruiters","usability","user-feedback"],"latest_commit_sha":null,"homepage":"https://gsa.github.io/recruiter/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GSA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-04-20T18:56:37.000Z","updated_at":"2022-08-09T03:18:23.000Z","dependencies_parsed_at":"2023-05-22T14:15:09.800Z","dependency_job_id":null,"html_url":"https://github.com/GSA/recruiter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GSA/recruiter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSA%2Frecruiter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSA%2Frecruiter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSA%2Frecruiter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSA%2Frecruiter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GSA","download_url":"https://codeload.github.com/GSA/recruiter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GSA%2Frecruiter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264396624,"owners_count":23601541,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["embeddable-forms","feedback-systems","google-sheets","google-tag-manager","recruiters","usability","user-feedback"],"created_at":"2024-11-19T10:15:32.759Z","updated_at":"2025-07-09T05:05:15.273Z","avatar_url":"https://github.com/GSA.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# recruiter [WIP]\nEmbeddable 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.\n\n## Components\n\n![feedback platform components](/docs/img/Feedback_Platform_Components-v2.svg)\n\n\n - [Google Sheets Template](https://docs.google.com/a/gsa.gov/spreadsheets/d/1_de-8lkbxPAy0ovb_WH22EI03vX8ZnuZhhiXnXWvxpQ/copy)\n - [Google Tag Manager](https://tagmanager.google.com) - account required\n - [U.S. Web Design System](https://standards.usa.gov/) styles and [form patterns guidance](https://standards.usa.gov/components/form-templates/) for accessibility.\n\n **Optional**\n - Integration with Google Analytics to send custom events when a user opens, closes, and submits the Recruiter form dialog.\n\n\n## Deploying\nSee [Wiki](https://github.com/GSA/recruiter/wiki/Deploying)\n\n## Default fields provided in this configuration:\n\n | Field name | Type | Description |\n | ---------- | ---- | ----------- |\n | Date | Timestamp | submission time and date |\n | Name | String | First name |\n | Email | String | Email address |\n | UserAgent | String | OS + Version, Browser + version |\n | URL* | String | URI of page where form was submitted |\n | Referrer* | String | Referring page (how user arrived at PageURL |\n\n**\\*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 (`\u0026Referrer={{Referrer}}\u0026URL={{Page URL}}`) from the URL in the `Recruiter to Google Sheet` Custom Image Tag in GTM.\n\n **Warning: PIA, [PRA](https://www.usability.gov/how-to-and-tools/guidance/pra-overview.html) 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.**\n \n ## Compliance\n \n **Paperwork Reduction Act of 1995 (PRA)** \n - See [exemption conditions](https://obamawhitehouse.archives.gov/sites/default/files/omb/inforeg/pra_flexibilities_memo_7_22_16_finalI.pdf).\n \n **Privacy**\n\n- GSA's **[Privacy Act Statement on Design Research](https://www.gsa.gov/reference/gsa-privacy-program/privacy-act-statement-for-design-research)**\n\n- 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)**.\n\n- See GSA's **[Design Research Privacy Impact Assessment (PIA)](https://www.gsa.gov/cdnstatic/design_research_pia_%28signed%29.pdf)** for additional details about the way Recruiter collects and stores administrative data.\n\n - **Google Sheets** are an approved System of Record for storing personally-identifiable information ([PII](https://www.gsa.gov/portal/content/104256)) under [GSA/CIO-3](https://www.federalregister.gov/documents/2014/08/12/2014-19071/privacy-act-of-1974-notice-of-an-updated-system-of-records).\n\n## Roadmap\nRecruiter is the first part of a larger WIP feedback platform implemented via Google Tag Manager.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsa%2Frecruiter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgsa%2Frecruiter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsa%2Frecruiter/lists"}