Skip to content

yhoriuchi/projoint

Repository files navigation

R-CMD-check CRAN Status Downloads

🛠️ The One-Stop Conjoint Shop: projoint


Conjoint survey designs are spreading across the social sciences due to their unusual capacity to estimate many causal effects from a single randomized experiment. Unfortunately, by their ability to mirror complicated real-world choices, these designs often generate substantial measurement error and thus bias.

projoint is a general-purpose R package for conjoint analysis. It produces more reliable estimates of the quantities of interest based on questions explicitly about survey respondents’ choices between two options.

This method can be used not only by researchers at the design stage but also by those already analyzing the data. As we explain, everything necessary to correct the bias in an application can be estimated via a slight modification of the standard conjoint design, a separate survey run afterward, or sometimes without new data collection at all.

Read our accompanying paper to learn more about our method - **Clayton, Horiuchi, Kaufman, King, Komisarchik (Forthcoming).** “Correcting Measurement Error Bias in Conjoint Survey Experiments.”
Forthcoming, American Journal of Political Science.
Pre-Print Available - 👉 Download BibTeX Reference

🚀 Tutorials

**1. Install** the development version from GitHub Open R (or install R if you do not have it), and run the following command in your coding environment. ```r devtools::install_github("yhoriuchi/projoint") ```
**2. Design** your survey Online surveys are frequently written with an online software called Qualtrics. Using our web tool, called the Projoint Survey Designer, you don't need to learn how to write a survey in Qualtrics.
3. Field your survey
  • Using the .QSF file export from the Projoint Survey Designer, load your survey into Qualtrics.
    • Log into your Qualtrics account.
    • Click "Create a new project"
    • Under "From scratch" select "Survey" and then "Get started"
    • Enter a name and under "How do you want to start your survey" select "Import a QSF file"
    • Click "Choose file" and select your .QSF file.
    • Click "Create project"
  • You are free to field your Qualtrics survey through online vendors.
  • When you are done fielding your survey, you will now need to export your data from Qualtrics to R.
    • Click “Download Data”.
    • Choose CSV format.
    • Critically, select “Use choice text” rather than coded values.
4. Read the results into R and wrangle your data into structured form
  • Load your survey responses into R:
library(projoint)
dat <- read_Qualtrics("your_file.csv")
  • Prepare the data for analysis:
dat <- reshape_projoint(
  .dataframe = dat,
  .outcomes = c(paste0("choice", 1:8), "choice1_repeated_flipped")
)
  • Follow the step-by-step guide to learn how to read and reshape data for conjoint analysis.
5. Analyze and visualize important Quantities of Interest
  • Estimate Marginal Means (MMs) or Average Marginal Component Effects (AMCEs) with correction for measurement error:
output <- projoint(dat)
print(output)
summary(output)
  • Visualize your results easily:
plot(output)
  • Estimate additional quantities of interest and explore subgroup comparisons using choice-level analysis.
  • Follow the step-by-step guide to learn how to:
    • Estimate and correct marginal means (MMs) or average marginal component effects (AMCEs), including predicting IRR if necessary.
    • Visualize the marginal means (MMs) or average marginal component effects (AMCEs).
    • Estimate under-investigated quantities of interest and compare subgroups using choice-level analysis.

📦 Upcoming Features

- Weighted estimation for features and respondents - Support for non-binary outcomes (ratings, rankings)
Contact For comments and suggestions, please open an issue on the Github repository.

✨ Thank you for using projoint! ✨

About

A package for a more general, more straightforward, and more creative conjoint analysis

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5