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.6l-224 96c-14 6-21.8 21-18.7 35.8S16.8 160 32 160v8c0 13.3 10.7 24 24 24H456c13.3 0 24-10.7 24-24v-8c15.2 0 28.3-10.7 31.3-25.6s-4.8-29.9-18.7-35.8l-224-96c-8-3.4-17.2-3.4-25.2 0zM128 224H64V420.3c-.6 .3-1.2 .7-1.8 1.1l-48 32c-11.7 7.8-17 22.4-12.9 35.9S17.9 512 32 512H480c14.1 0 26.5-9.2 30.6-22.7s-1.1-28.1-12.9-35.9l-48-32c-.6-.4-1.2-.7-1.8-1.1V224H384V416H344V224H280V416H232V224H168V416H128V224zM256 64a32 32 0 1 1 0 64 32 32 0 1 1 0-64z"/></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="M304 128a80 80 0 1 0 -160 0 80 80 0 1 0 160 0zM96 128a128 128 0 1 1 256 0A128 128 0 1 1 96 128zM49.3 464H398.7c-8.9-63.3-63.3-112-129-112H178.3c-65.7 0-120.1 48.7-129 112zM0 482.3C0 383.8 79.8 304 178.3 304h91.4C368.2 304 448 383.8 448 482.3c0 16.4-13.3 29.7-29.7 29.7H29.7C13.3 512 0 498.7 0 482.3z"/></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="M152 24c0-13.3-10.7-24-24-24s-24 10.7-24 24V64H64C28.7 64 0 92.7 0 128v16 48V448c0 35.3 28.7 64 64 64H384c35.3 0 64-28.7 64-64V192 144 128c0-35.3-28.7-64-64-64H344V24c0-13.3-10.7-24-24-24s-24 10.7-24 24V64H152V24zM48 192H400V448c0 8.8-7.2 16-16 16H64c-8.8 0-16-7.2-16-16V192z"/></svg> September 20, 2023

]

---

# .center[**Reminders**]

# Proposals due Sunday, 9/24 by midnight

<br>

# Next week project workshop:<br>team meetings & proposal feedback

---

# 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.qmd`

---

# 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.qmd` 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

Add "choice" columns

]

Use `choices` tab<br>(when you have a lot of choices)

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="M64 32C28.7 32 0 60.7 0 96V416c0 35.3 28.7 64 64 64H384c35.3 0 64-28.7 64-64V96c0-35.3-28.7-64-64-64H64zM325.8 139.7l14.4 14.4c15.6 15.6 15.6 40.9 0 56.6l-21.4 21.4-71-71 21.4-21.4c15.6-15.6 40.9-15.6 56.6 0zM119.9 289L225.1 183.8l71 71L190.9 359.9c-4.1 4.1-9.2 7-14.9 8.4l-60.1 15c-5.5 1.4-11.2-.2-15.2-4.2s-5.6-9.7-4.2-15.2l15-60.1c1.4-5.6 4.3-10.8 8.4-14.9z"/></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="M0 128C0 92.7 28.7 64 64 64H320c35.3 0 64 28.7 64 64V384c0 35.3-28.7 64-64 64H64c-35.3 0-64-28.7-64-64V128z"/></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.qmd` 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/2023-Fall/project/2-survey-plan.html)

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