October 13, 2015

Create Survey

How to add a custom survey to BadgerScan


Any web-based survey may be launched from the Contact Detail page of any BadgerScan contact, as shown below.


Benefits of launching a survey from BadgerScan:

  • Automatically pre-populate fields in your survey such as First Name, Last Name and Email with contact data collected on BadgerScan.
  • Consolidate contact data collected by multiple team members.
  • Provides an immediate backup of contact data collected by BadgerScan.


You have the option to launch a survey that is either:

  1. Hosted by a third party, such as  Google Forms or Survey Monkey, or
  2. Custom built and hosted on your own web server (In other words, your company has it’s own survey written by a web developer.)

Instructions for implementing these options are detailed below.


Option 1:  Create a Google Form survey

    • From a computer (mobile devices may not have required options), create or log into your account at drive.google.com.
    • Select New then  Google Forms.

Screen Shot 2015-10-13 at 12.16.20 PM

    • In the Form Settings box, un-check  Require xxxx login to view this form, if this option exists.

   Screen Shot 2015-10-13 at 11.58.49 AM          Screen Shot 2015-10-13 at 11.59.48 AM

    • Create a Title and select the default theme.
    • Create questions to ask new contacts.
    • First name, last name and/or email address, or any of the Contact Data Keys, listed below, collected with BadgerScan can be used to pre-populate select fields in the survey form. See the instructions below the Contact Data Keys list to implement this pre-population.

Contact Data Keys

  1. id : unique numeric ID for each contact
  2. firstName
  3. lastName
  4. title
  5. favorite : favorite level from 0 to 3 (yellow = 1, red = 3)
  6. email
  7. officePhone
  8. cellPhone
  9. fax
  10. org : organization affiliation
  11. displayAddress: formatted address
  12. street
  13. city
  14. region
  15. zip
  16. country
  17. event : name of the event where Badge scanned
  18. lat : GPS latitude at scan time
  19. long : GPS longitude at scan time
  20. scanPlace : location at Badge scan time
  21. scanTime : date and time Badge scanned
  22. notes : notes saved with contact (launch survey after collecting notes)
  23. summary : a summary statement of interests provided by the contact
  24. twitter : twitter screen name
  25. linkedin : LinkedIn public profile URL
  26. url : website provided by contact
    • To pre-populate survey fields, you must add a form question for each Contact Data Key you wish to store with survey submissions. For example, to add the email address of each person you survey to their response form: (1) create a new question, (2) set the question title to Email, for example, (3) verify that the Question Type is set to Text, (4) press the Done button. Repeat these steps for each type of data you are interested in pre-populating.

Screen Shot 2015-10-13 at 1.09.53 PM

    • When you have added a question for each of the data types you intend to pre-populate, return to the top of the page and select the Responses (0) menu item.

Screen Shot 2015-10-13 at 12.06.35 PM

    • From the Responses menu, select Get pre-filled URL.

Screen Shot 2015-10-13 at 12.07.03 PM

    • In the form that appears, you will see the questions that you have created. Any answers that you provide here will be automatically filled in when you launch the form in the future. Any answers that you provide in this form that exactly match a key from the Contact Data Key table above act as variable placeholders and will be replaced with the information collected from the new contact that you are surveying.
    • Continuing with the email example above, for the question titled Email, fill in the answer with the Data Key email.

Complete the form using Data Keys entered exactly as they appear in the Data Key table above.

Screen Shot 2015-10-13 at 12.08.10 PM

      • Press the Submit button.


    • A URL will appear in the box titled Share the link to this form with your pre-filled responses. Copy the link and send it to an email account available on your mobile device.
        • A sample survey URL may look like this:
        • https://docs.google.com/forms/d/1f55PwkMaqCYrMQtTQpRZd_wRCrvqNLL5hWwLC6OUhnY/viewform?entry.2077779490=firstName&entry.1310589987=lastName&entry.1936262050=email


      • DO NOT shorten the URL with bitly, goo.gl, tinyurl, ow.ly or any other tool. This URL must be entered into BadgerScan exactly as it is provided.

Screen Shot 2015-10-13 at 12.08.45 PM

  • Open the email on your device and copy the URL to the form in BadgerScan found under Settings -> Survey as shown here.


    • Press the Add survey button.
    • An option to Launch Survey will now appear on your Contact Details page for each contact you collect using BadgerScan.


Option 2: Create a Survey Monkey survey

    • Create or log into your account at surveymonkey.com.
    • Select Create Survey.
    • Design your survey. On the Collect Responses tab, choose a Web Link Collector.
    • When the web link is displayed, change the Responses Per Computer option to Allow multiple responses per computer.
    • Enter the Web Link URL into BadgerScan. From the BadgerScan menu, select Settings then Survey.  Enter the URL and press Submit. (Tip: If you create the Form on a computer, you can email the URL to yourself and use the copy and paste feature on your mobile device to avoid typing errors.)
    • BadgerScan can automatically submit a custom variable with each survey response.  It would be a good idea to use a unique identifier, such as an email address as the custom variable. Then the data from Survey Monkey and the data from BadgerScan can be merged later in Excel or by using a database. To allow BadgerScan to automatically attach the email address of the contact that you are surveying to the survey submission, add the following text to the end of the Survey Monkey URL:


    • What comes after the “=” should match the BadgerScan data key that you would like to have added to the survey automatically. In this example, we use the “email” data key.
    • An example of the full URL that you would enter into BadgerScan is: https://www.surveymonkey.com/s/HSYWN2M?c=email

Option 3:  Link to a custom survey on your own web server

If you create your own survey on your own website, the survey can be launched from BadgerScan by entering the survey URL into the app.

Additionally, contact information collected by BadgerScan can be sent to your survey via the URL.  The list of Contact Data Keys above shows all the data that can be collected. If you provide a URL to enter into BadgerScan that contains a Contact Data Key, the key will be replaced with the actual contact data when it is launched from BadgerScan.  So a URL that is entered into BadgerScan like this:


will be launched from BadgerScan like this:


From there you can collect the information in your webpage and store it into your own database.