Intro to formr

]

# Week 4: .fancy[Intro to formr]

### <svg aria-hidden="true" role="img" viewBox="0 0 512 512" style="height:1em;width:1em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:white;overflow:visible;position:relative;"><path d="M243.4 2.587C251.4-.8625 260.6-.8625 268.6 2.587L492.6 98.59C506.6 104.6 514.4 119.6 511.3 134.4C508.3 149.3 495.2 159.1 479.1 160V168C479.1 181.3 469.3 192 455.1 192H55.1C42.74 192 31.1 181.3 31.1 168V160C16.81 159.1 3.708 149.3 .6528 134.4C-2.402 119.6 5.429 104.6 19.39 98.59L243.4 2.587zM256 128C273.7 128 288 113.7 288 96C288 78.33 273.7 64 256 64C238.3 64 224 78.33 224 96C224 113.7 238.3 128 256 128zM127.1 416H167.1V224H231.1V416H280V224H344V416H384V224H448V420.3C448.6 420.6 449.2 420.1 449.8 421.4L497.8 453.4C509.5 461.2 514.7 475.8 510.6 489.3C506.5 502.8 494.1 512 480 512H31.1C17.9 512 5.458 502.8 1.372 489.3C-2.715 475.8 2.515 461.2 14.25 453.4L62.25 421.4C62.82 420.1 63.41 420.6 63.1 420.3V224H127.1V416z"/></svg> EMSE 6035: Marketing Analytics for Design Decisions
### <svg aria-hidden="true" role="img" viewBox="0 0 448 512" style="height:1em;width:0.88em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:white;overflow:visible;position:relative;"><path d="M224 256c70.7 0 128-57.31 128-128s-57.3-128-128-128C153.3 0 96 57.31 96 128S153.3 256 224 256zM274.7 304H173.3C77.61 304 0 381.6 0 477.3c0 19.14 15.52 34.67 34.66 34.67h378.7C432.5 512 448 496.5 448 477.3C448 381.6 370.4 304 274.7 304z"/></svg> John Paul Helveston
### <svg aria-hidden="true" role="img" viewBox="0 0 448 512" style="height:1em;width:0.88em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:white;overflow:visible;position:relative;"><path d="M96 32C96 14.33 110.3 0 128 0C145.7 0 160 14.33 160 32V64H288V32C288 14.33 302.3 0 320 0C337.7 0 352 14.33 352 32V64H400C426.5 64 448 85.49 448 112V160H0V112C0 85.49 21.49 64 48 64H96V32zM448 464C448 490.5 426.5 512 400 512H48C21.49 512 0 490.5 0 464V192H448V464z"/></svg> September 21, 2022

]

---

# .center[**Reminders**]

# Proposals due Sunday, 9/25 by midnight

# No class next week - team meetings instead

---

# Week 4: .fancy[Intro to formr]

### 1. Surveys in R
### 2. Surveys in formr

### BREAK

### 3. Conjoint survey components

---

# Week 4: .fancy[Intro to formr]

### 1. .orange[Surveys in R]
### 2. Surveys in formr

### BREAK

### 3. Conjoint survey components

---

# Start in RMarkdown

## See `demoSurvey.Rmd`

---

# Some Guidelines

- Use `---` to indicate new pages (this inserts a horizontal line)

- Be sure that any data / images are hosted somewhere on the web

- Consider each new page a **New R Session** (reload libraries, etc.)

---

# Embedding images

I recommend just writing html code, like this

```html
<img src="https://raw.githubusercontent.com/emse-madd-gwu/2022-Fall/main/images/logo.png" width=250>
```

---

# Centered image

I recommend just writing html code, like this

```html
<center>
<img src="https://raw.githubusercontent.com/emse-madd-gwu/2022-Fall/main/images/logo.png" width=250>
</center>
```

---

# Check your urls carefully!

<br>

This is the link to the Github page with the class logo image:

https://github.com/emse-madd-gwu/2022-Fall/blob/main/images/logo.png

This is the link to the actual image:

https://raw.githubusercontent.com/emse-madd-gwu/2022-Fall/main/images/logo.png

---

## Your turn

- Open and edit the `practiceSurvey.Rmd` file.
- Pick a topic for your survey (a food, an animal, a sports team...whatever).
- Draft a survey about that topic. Include the following:
    - Page 1: A welcome message in large font ("Welcome to a survey about [topic]") and an image about the topic (find an image somewhere).
    - Page 2: Once simple multiple choice question about the topic (state the question and write the choice responses as bullets).
    - Page 3: Choose a data set from [this page](https://github.com/emse-eda-gwu/2022-Fall/tree/master/data) (pick a .csv file). Get the url to the .csv file you chose, read it in, and display only the first 6 rows of the data file (do not show any code - only the output of your code).
    - Page 4: Show the last 6 rows of the same data file (again, only the output - hide all code).
    
---

# Week 4: .fancy[Intro to formr]

### 1. Surveys in R
### 2. .orange[Surveys in formr]

### BREAK

### 3. Conjoint survey components

---

# formr principles

<br>

## - Use _RMarkdown / html_ to create survey elements

## - Define surveys in _Google Sheets_

## - Import Google Sheets into formr _surveys_

## - Link surveys together in formr _runs_

---

# [Demo survey](https://docs.google.com/spreadsheets/d/13jSdlIDFRVsIHbiObgyZlPTGovIcB-xDQ0dkhL75fZQ/edit?usp=sharing)

---

# .center[formr row types [(more here)](https://formr.org/documentation#available_items)]

Type | Description
-----|---------------------
`note` | Display content in `label` column 
`submit` | Next page button
`mc` | Multiple choice question (single choice) 
`mc_multiple` | Multiple choice question (multiple choices) 
`mc_button` | Multiple choice question (large buttons)
`select_one` | Drop down menu (choose one)
`text` | Open text, single row
`textarea` | Open text, block

---

# Two ways to define choice options

<center>
<img src="images/choices.png" width=100%>
</center>
]

Example: "Year of birth" in [randomImagesDemo](https://docs.google.com/spreadsheets/d/1hs551J6PYJNxc4sftmJyUqj6XYGYFVnN_5faQBWY7cs/edit?usp=sharing)
]

---

# Control the way things look in `class` column

# ([options here](https://formr.org/documentation#sample_survey_sheet))

---

# Importing survey into formr

### formr.org --> Admin --> Surveys --> Create new survey

### (Make sure your Google Sheet is visible!)

---

# Make a run

## formr.org --> Admin --> Runs --> Create new run

<br>

# Insert survey with <svg aria-hidden="true" role="img" viewBox="0 0 448 512" style="height:1em;width:0.88em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:currentColor;overflow:visible;position:relative;"><path d="M384 32C419.3 32 448 60.65 448 96V416C448 451.3 419.3 480 384 480H64C28.65 480 0 451.3 0 416V96C0 60.65 28.65 32 64 32H384zM325.8 139.7C310.1 124.1 284.8 124.1 269.2 139.7L247.8 161.1L318.7 232.1L340.1 210.7C355.8 195 355.8 169.7 340.1 154.1L325.8 139.7zM111.5 303.8L96.48 363.1C95.11 369.4 96.71 375.2 100.7 379.2C104.7 383.1 110.4 384.7 115.9 383.4L176 368.3C181.6 366.9 186.8 364 190.9 359.9L296.1 254.7L225.1 183.8L119.9 288.1C115.8 293.1 112.9 298.2 111.5 303.8z"/></svg>

<br>

# Insert stop with <svg aria-hidden="true" role="img" viewBox="0 0 384 512" style="height:1em;width:0.75em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:currentColor;overflow:visible;position:relative;"><path d="M384 128v255.1c0 35.35-28.65 64-64 64H64c-35.35 0-64-28.65-64-64V128c0-35.35 28.65-64 64-64H320C355.3 64 384 92.65 384 128z"/></svg>

---

## Change order by adjusting numbers & clicking "Reorder"

---

# Make it "live" with the volume buttons

---

# Fine tune look & feel in "Settings"

---

## Your turn

- Using your GW Google drive, create a new survey spreadsheet<br>(you may wish to copy-paste from [this one](https://docs.google.com/spreadsheets/d/13jSdlIDFRVsIHbiObgyZlPTGovIcB-xDQ0dkhL75fZQ/edit?usp=sharing))
- Name your sheet "`[netID]_practice`", replacing "`[netID]`" with your GW Net ID<br>(e.g. "`jph_practice`")
- Insert the content in your `practiceSurvey.Rmd` file into your Google Sheet. 
- Using the class formr account, import your Google Sheet as a survey in formr (use the same "`[netID]_practice`" name for your survey). 
- Create a run that includes your survey and a stop.
- Test it!

---

# .fancy[Break]

---

# Week 4: .fancy[Intro to formr]

### 1. Surveys in R
### 2. Surveys in formr

### BREAK

### 3. .orange[Conjoint survey components]

---

# 3 Parts

<br>

- ### **Part 1**: Intro
- ### **Part 2**: Conjoint questions
- ### **Part 3**: Other / demographic questions

---

# 3 Parts

<br>

- ### **Part 1**: Intro --> .red[screen for target population]
- ### **Part 2**: Conjoint questions --> .red[screen for random answers]
- ### **Part 3**: Other / demographic questions

---

# .center[Think of your survey as a _conversation_]

<br>

- Include "transition" pages (e.g. Great job! Now we'll ask you about...)

---

# **Part 1**: Intro

---

# Start with a welcome page

---

# Consent form

]

]

---

## **Eligibility questions**: who is your target population?

### .red[_Filter out respondents here_]

---

# **Part 2**: Conjoint questions

---

# Education information

---

# Education information

]

]

---

## .center[Can be helpful to provide relative comparisons]

Weight:

- 1/2 lbs (similar to 1 cup water)
- 8 lbs (similar to 1 gallon of milk)

---

# Conjoint intro

---

## Practice conjoint (also attention check)

### .red[_May also filter out respondents here_]

---

# Transition to actual conjoint questions

---

# Conjoint questions

### .red[_May also filter out respondents at the end_]

(e.g. chose all same answers)

]

]

---

# **Part 3**: Other / demographic questions

---

# Transition

---

# Critical respondent information

---

class: center
 
# Demographic / other questions
 
<center>
<img src="images/11demo.png" width=500>
</center>

---

# Finale

---

# [Blog post on conjoint in formr](https://www.jhelvy.com/posts/2021-09-18-choice-based-conjoint-surveys-in-r-with-formr/)

# [Project survey plan](https://madd.seas.gwu.edu/2022-Fall/project/2-survey-plan.html)

# Sign up for meeting slot next week<br>(link in #project channel)